Get started
Follow these steps to make your organization's GIS capabilities available to AI applications through MCP. Each step links to detailed instructions.
If you are new to MCP, first see Introduction to MCP for ArcGIS Enterprise.
Step 1: Plan your workflows
Identify the users, GIS content, and operations you want to support. Review your ArcGIS Enterprise version, access requirements, and preferred MCP clients.
For details, see Evaluate your organization's needs.
Step 2: Install MCP Services for ArcGIS Enterprise
Install MCP Services for ArcGIS Enterprise on your ArcGIS Enterprise hosting server. If the site contains multiple machines, install the software on each machine.
For details, see Install MCP Services for ArcGIS Enterprise.
Step 3: Enable access
For ArcGIS Enterprise 12.2 and later, an administrator must turn on External AI client access. For earlier supported versions, the default catalog is available after installation.
For details, see Enable MCP for ArcGIS Enterprise.
Step 4: Select an authentication technique
Choose an API key, a portal token, or manually configured OAuth 2.0, based on your ArcGIS Enterprise version and your client's capabilities.
For details, see Select an authentication technique.
Step 5: Connect an MCP client
Configure your client with the default catalog endpoint and the authentication technique you selected in Step 4:
https://<domain>/<server-context>/mcp/default
Replace <domain> and <server-context> with the values configured for your deployment.
For details, see Connect from MCP clients.
Step 6: Prepare your content
Add the mcp tag to items you want to make discoverable through Search Portal Content. Review their descriptions and sharing settings so that the intended users can find, understand, and access them.
For details, see Prepare your content for use with MCP.
Step 7: Verify a workflow
In your AI application or agent, submit a request that requires GIS content you have permission to access—for example, Find maps of Redlands in my organization. Review which tools the application calls and the results it returns to confirm that it uses the intended GIS resources.
For the list of tools and their usage guidance, see Default MCP catalog overview. If you have problems, see Troubleshoot MCP for ArcGIS Enterprise and the FAQ.
Extend your workflows
As your needs grow, you can expose web tools as custom MCP tools, develop Java-based custom MCP tools, or organize tools into custom catalogs. For details, see the following: