Skip to main content

FAQ

Frequently asked questions about MCP Services for ArcGIS Enterprise are listed below. For diagnostic procedures, see Troubleshoot MCP for ArcGIS Enterprise.

General

Installation and upgrades

Clients and connectivity

Enablement and authentication

Catalogs and access

Content and discovery

Custom tools

Troubleshooting

What is MCP

Model Context Protocol (MCP) is an open standard for connecting AI applications to external tools and data sources. MCP Services for ArcGIS Enterprise expose GIS capabilities through this protocol. For details, see About MCP.

Do MCP Services for ArcGIS Enterprise include an AI application or language model

No. You choose and configure an MCP client separately. MCP Services for ArcGIS Enterprise provide the tools that the client can discover and use.

Which ArcGIS Enterprise versions are supported

ArcGIS Enterprise 11.1, 11.3, 11.5, 12.1, and 12.2. Review the compatibility requirements for the release of MCP Services for ArcGIS Enterprise that you install. For details, see How MCP Services for ArcGIS Enterprise are delivered.

Do I need to upgrade ArcGIS Enterprise to get new MCP features

Not necessarily. MCP Services for ArcGIS Enterprise have an independent release cycle, but your deployment must meet the requirements of the new release. Some capabilities require a newer ArcGIS Enterprise version.

Do MCP Services for ArcGIS Enterprise guarantee accurate AI responses

No. GIS tools return results, but the AI application may interpret them or draw conclusions from them. Review outputs as appropriate for your workflow.

Is there a separate license for MCP for ArcGIS Enterprise

No. MCP for ArcGIS Enterprise does not require a separate license. You configure it on top of your ArcGIS Enterprise hosting server by installing the MCP Services for ArcGIS Enterprise component. For details, see Install MCP Services for ArcGIS Enterprise.

Where do I install MCP Services for ArcGIS Enterprise

Install them on your ArcGIS Enterprise hosting server. For a site with multiple machines, install them on every machine in the site. For details, see Install MCP Services for ArcGIS Enterprise.

Does installation or uninstallation restart ArcGIS Server

Yes. ArcGIS Server restarts during installation and uninstallation. Schedule these operations during a maintenance window. For details, see Run the setup.

Can I install a new version over an existing installation

No. Uninstall the existing version, and then install the latest supported version. Only the latest version of MCP Services for ArcGIS Enterprise is supported. For details, see Upgrade MCP Services for ArcGIS Enterprise.

What do I need to do when I upgrade ArcGIS Enterprise

Uninstall MCP Services for ArcGIS Enterprise before you upgrade ArcGIS Enterprise. After the upgrade succeeds, install the latest supported version that is compatible with your deployment. Complete these steps on every hosting server machine. For details, see Upgrade your ArcGIS Enterprise deployment.

What is the current version of MCP Services for ArcGIS Enterprise

The current version is 2026.0. For upgrade steps, see Upgrade MCP Services for ArcGIS Enterprise.

Which MCP clients can I use

Examples of supported clients include Microsoft Copilot Studio, Claude Desktop, Kiro, Gemini CLI, ChatGPT, GitHub Copilot, and Goose. Verify that your client supports remote MCP connections and your selected authentication technique. For details, see Choose an MCP client.

Are the connection steps the same for every client

No. Configuration interfaces, authentication options, and tool controls vary. Follow the client provider's instructions and the guidance in Connect from MCP clients.

Can a client connect to an internal deployment

Only if the environment making the connection can reach the catalog endpoint. Being able to reach the endpoint from your browser does not mean that a cloud-hosted client has the same network access. For details, see Understand where the connection runs.

Can I connect several clients to the same catalog at once

Yes. Multiple MCP clients can connect to the same catalog endpoint at the same time. Each connection is authenticated separately, and access is determined by the permissions of the user or credential used for that connection. For details, see Connect from MCP clients.

Do I need to enable MCP after installation

For ArcGIS Enterprise 12.2 and later, an administrator must turn on External AI client access. In earlier supported versions, the default catalog is available after installation without this step. For details, see Enable MCP for ArcGIS Enterprise.

What does an error stating that MCP is not enabled mean

The organization's External AI client access setting is turned off. An administrator must turn it on before clients can access the default catalog or custom catalogs. For details, see MCP is not enabled for this organization.

What does Requirements missing mean next to the External AI client access setting

MCP Services for ArcGIS Enterprise must be installed on the hosting server before the setting can be turned on. Verify the installation on every machine in the hosting server site. For details, see Requirements missing in AI settings.

Which authentication techniques are supported

API keys, portal tokens, and manually configured OAuth 2.0. The options available depend on your ArcGIS Enterprise version and client. For details, see Select an authentication technique.

Can I use an ArcGIS Server administration token

No. Use a portal token generated through the portal's sharing/rest/generateToken endpoint. For details, see Generate a portal token.

Can a client that requires Dynamic Client Registration use OAuth 2.0

No. MCP for ArcGIS Enterprise supports OAuth 2.0 when you configure the client manually with the client ID and redirect URI of an OAuth application registered in your portal. It does not support Dynamic Client Registration (RFC 7591), in which a client registers itself automatically. If the client cannot be configured manually, use an API key or portal token, or choose a client that accepts manual OAuth configuration. For details, see Check client compatibility.

Does an MCP connection grant additional permissions

No. Access follows the permissions of the user or credential used for the connection. If the client is configured with a different identity or credential, access may not match the permissions of the person using the client.

What does the default catalog contain

Built-in tools, one MCP tool for each web tool item in your portal that is tagged for MCP, and custom MCP tools registered with ArcGIS Enterprise. The default catalog can include up to 20 web tools and up to 50 Java-based custom MCP tools. For details, see Default MCP catalog overview.

What is the default catalog endpoint

Use the domain and MCP context configured for your deployment:

https://<domain>/<server-context>/mcp/default

For details, see Default catalog endpoint.

Can I create a catalog for a specific workflow

Yes. Starting with ArcGIS Enterprise 12.2, administrators can create custom catalogs that contain selected tools. Each catalog is a portal item that you can share with its intended audience. For details, see Manage MCP catalogs.

Which tools are included automatically in custom catalogs

Describe Item, Describe Layer, and Search Portal Content.

Where do I find a custom catalog's endpoint

Copy the URL property from the catalog's item page. The endpoint uses the following format:

https://<domain>/<server-context>/mcp/<item-id>

For details, see Connect to a custom catalog.

Does sharing a catalog grant access to its underlying data

No. Sharing controls access to the catalog item only. Users or credentials still need permission to access the tools themselves, such as custom MCP tools and the web tool items they are based on, as well as the content and services that those tools use. For details, see Plan a custom catalog.

How do I make an item discoverable through MCP search

Add the mcp tag to its portal item. Provide clear titles, summaries, and descriptions to help applications find and interpret it. For details, see Prepare your content for use with MCP.

Is the mcp tag case-sensitive

No. For example, mcp and MCP are both accepted.

Why does an item not appear in search results

Verify that it has the mcp tag, that the connection's user or credential can access it, and that it matches the search criteria. Search Portal Content does not return ArcGIS Living Atlas of the World content.

Does removing the mcp tag revoke access

No. It removes the item from Search Portal Content results. Other tools can still access an untagged item by its item ID or layer URL, subject to permissions.

Can I add my own MCP tools

Yes. Expose a web tool as a custom MCP tool, or develop Java-based tools packaged as .mcp files. For details, see Extend MCP for ArcGIS Enterprise.

How does a geoprocessing service become an MCP tool

Share the geoprocessing service to your portal as a web tool, and add the mcp tag to the web tool item. It appears in the default catalog as one custom MCP tool named after the service. For details, see Expose a web tool as a custom MCP tool.

Does each geoprocessing task become a separate tool

No. Each tagged web tool becomes one tool, even when its geoprocessing service contains multiple tasks. For details, see Expose a web tool as a custom MCP tool.

Are synchronous and asynchronous geoprocessing supported

Yes. Synchronous execution returns results directly. Asynchronous execution returns a job ID. To check progress or get the results, prompt the application to check the job status. It then uses Get GP Task Job Status.

What happens if two tools have the same name

A Java-based tool with the same name as an existing Java-based tool is rejected when it is registered. Other duplicate names are not rejected, but only one of the conflicting tools appears in the catalog. In the default catalog, built-in tools take precedence, followed by Java-based tools, and then web tools. If two web tools have the same name, the most recently modified one is used. In a custom catalog, the tool listed first in the catalog item's data is used. Use a unique name for each tool. For details, see Tool name conflicts.

Where are MCP diagnostic messages recorded

In the ArcGIS Server logs on your hosting server site. Look for MCP_SERVER in the entry's source or target information. For details, see Identify MCP log messages.

How do I capture detailed diagnostics

Temporarily set the ArcGIS Server logging level to Debug, reproduce the issue, and review the messages. Restore the previous level afterward. For details, see Identify MCP log messages.

Why can I connect to a catalog but not run a tool

Check the tool inputs, the permissions for the requested resources, and the availability of the underlying service. A successful catalog connection does not verify every tool operation. For details, see Troubleshoot common symptoms.

Why does my client show an outdated tool list

The client may keep previously discovered tools. In addition, changes to a custom catalog may take a few minutes to be reflected, and changes to web tool items tagged for MCP may take up to one minute. Refresh the list or reconnect using the client's documented procedure. For details, see Recent changes do not appear yet.