Create an API key credential with the following configurations:

• Set the type of application to:
  Private application with selected privileges.
• Select the following privileges:
  • 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

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. In Agents tab, click + Create blank agent.
3. Name the agent MCP for ArcGIS Location Services and click Next.
4. Scroll down to the Tools section and click + Add tool.
5. Select Add new MCP.
6. Configure the following:
   • Name: MCP for ArcGIS Location Services
   • 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
   • Authentication type: Header
   • Header name: Authorization
7. Click Create.
8. Click Not connected > Create new connection to test the connection.
9. In the empty field, enter Bearer followed by your access token, then click Create.
10. Once the connection is successful, the Not connected status will change to Connected. Click Add and connect.

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 your 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.