Create an API key credential with the following configurations:

• Set the type of application to:
  Private application with selected privileges.

• Select the privileges for the capabilities you want to enable via MCP:

  • Portal service > General privileges > Apps and capabilities > Allow beta access
  • Location services > Geocoding > Geocode (stored)
  • Location services > Routing > Simple routing
  • Location services > Elevation > Elevation service
  • Location services > Static maps > Static maps service
  • Location services > Data Enrichment > GeoEnrichment service

For MCP clients that support OAuth 2.0, create an OAuth 2.0 credential for user authentication. Your account must have all of the privileges required for the tools (and services) you want to use.

Set the Redirect URL to your client’s specific redirect URL, such as:

• Postman: https://oauth.pstmn.io/v1/browser-callback
• Visual Studio Code: http://127.0.0.1:33418 and https://vscode.dev/redirect
• Claude Code: https://claude.ai/api/mcp

To connect to the MCP server from Microsoft Copilot Studio, follow these steps:

1. Sign in to Microsoft Copilot Studio.
2. Click Agent Create an agent to take actions and answer questions.
3. Name the agent MCP ArcGIS Location Services.
4. Add custom instructions, such as: “You help answer GIS related questions. You will be provided tools via an MCP server, which are related to ArcGIS.”
5. Select the model for your agent.
6. Click the Tools to add the new tool and configure the following:
   • Click + Add.
   • Select Model Context Protocol (MCP).
   • Name: MCP for ArcGIS Location Services.
   • Server Description: An MCP server that provides access to ArcGIS Location Services capabilities such as geocoding, routing, elevation, and map generation.
   • Server URL: https://location-services-mcp.arcgis.com/beta/mcp.
   • Authentication: API key.
   • Parameter type: Header.
   • Header name: Authorization.
   • Key value: Bearer followed by the API Key string.
   • Click Add.
7. Once the tool is added, click Create connection:
   • Optionally give a display name.
   • For the authentication, give Bearer followed by the API Key string.
   • Click Create.
   • Click Add.

To connect to the MCP server from Visual Studio Code with GitHub Copilot, follow these steps:

1. Install the github.copilot-chat extension in Visual Studio Code.
2. Sign in to Visual Studio Code with the GitHub account associated with your GitHub Copilot subscription.
   • Select the Accounts icon in Visual Studio Code (usually located in the lower left corner).
   • Select Sign in to GitHub.
   • Complete the authentication flow in your browser.
3. Create a file called mcp.json in the .vscode directory in your project workspace.
4. Add the following configuration to the file:

   • Using API key authentication:

     {
       "servers": {
         "mcpArcGISLocationServices": {
           "url": "https://location-services-mcp.arcgis.com/beta/mcp",
           "type": "http",
           "headers": {
             "Authorization": "Bearer ${input:esriApiKey}"
           }
         }
       },
       "inputs": [
         {
           "type": "promptString",
           "id": "esriApiKey",
           "description": "API key to authenticate with MCP for ArcGIS Location Services. Must have beta access and required privileges for geocoding, routing, elevation, and static maps services.",
           "password": true
         }
       ]
     }

   • Using user authentication:

     {
       "servers": {
         "mcpArcGISLocationServices": {
           "url": "https://location-services-mcp.arcgis.com/beta/mcp",
           "type": "http",
           "oauth": {
             "clientId": "YOUR_CLIENT_ID"
           }
         }
       }
     }
5. You should see a small status label above the server name in Visual Studio Code showing the number of available tools and prompts. Click Start.

In Goose, once you have connected to your LLM of choice, you can configure MCP for ArcGIS Location Services as a Custom Extension. Provide the following configuration settings:

• Extension Name = mcp-for-arcgis-location-services
• Type = HTTP
• Description = An MCP server that provides access to ArcGIS Location Services capabilities such as geocoding, routing, elevation, and map generation.
• Endpoint = MCP_URL
• Timeout = 300 (Default)
• ENV Vars = N/A
• Request headers:
  • Header Name = Authorization
  • Value = Bearer <YOUR_ACCESS_TOKEN>

To connect to the MCP server from Claude Code:

1. Using API key authentication:

   • Use the following command:

     claude mcp add --transport http secure-api https://location-services-mcp.arcgis.com/beta/mcp \
       --header "Authorization: Bearer YOUR_ACCESS_TOKEN"

2. Using user authentication:

   • In File > Settings > Connectors, click Add.
   • In the dropdown list, select Add custom connector.
   • Configure the following:
     • Name: MCP for ArcGIS Location Services
     • MCP Server URL: https://location-services-mcp.arcgis.com/beta/mcp
     • OAuth Client ID: YOUR_CLIENT_ID (in Advanced Settings)
   • Click Add.

To connect to the MCP server from Kiro, you need to add https://location-services-mcp.arcgis.com/beta/mcp as a remote HTTP server with a Bearer token.

See the following example to use AWS Kiro to connect to the MCP server.

Use Postman to connect to MCP for ArcGIS Location Services server, authenticate with your API key, and verify that the MCP tools and prompts are accessible.

1. Launch Postman and sign in or create an account if you don’t have one.
2. Choose an existing workspace or create a new one.
3. In the left sidebar, click + > MCP. Postman opens a new MCP request in a new tab.
4. Choose HTTP in the dropdown next to the URL field.
5. In Authorization tab, under Auth Type,
   • Using API key authentication:
     • Select Bearer token from the dropdown.
     • Paste the access token you obtained from your ArcGIS Location Platform account.
     • Click Connect.
     • In the Message tab, check the Tools and Prompts sections and verify that available tools and prompts are shown.
   • Using user authentication:
     • Select OAuth 2.0 from the dropdown.
     • Under the OAuth 2.0 Section:
       • Leave Token blank (this gets auto-populated later)
       • Header Prefix = Bearer
       • Token Name = “ANY_TOKEN_NAME”
       • Grant Type = Authorization Code (With PKCE)
       • Callback URL = https://oauth.pstmn.io/v1/callback
       • Auth URL = https://www.arcgis.com/sharing/rest/oauth2/authorize
       • Access Token URL = https://www.arcgis.com/sharing/rest/oauth2/token
       • ClientID = “YOUR_CLIENT_ID”
       • Code Challenge Method = SHA-256
       • Client Authentication = Send client credentials in body
       • Click Connect
       • Click Authorize
     • Click Run.
     • In the Message tab, check the Tools and Prompts sections and verify that available tools and prompts are shown.

To create a fork of the collection in Postman with the configuration already set up for you, click the button below.