arcgis-mcp-bridge

Exposes 100 ArcPy geoprocessing tools to MCP clients through a sandboxed two-process server.

16|1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/muend/arcgis-mcp-bridge --skill arcgis-mcp-bridge-muend
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: arcgis-mcp-bridge
Source: https://github.com/muend/arcgis-mcp-bridge
Command: npx skills add https://github.com/muend/arcgis-mcp-bridge --skill arcgis-mcp-bridge-muend

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires fastmcp, mcp, pydantic.

What problem does it solve? Running ArcPy geoprocessing from an AI assistant normally means giving the agent unrestricted access to a licensed ArcGIS Pro runtime and the local filesystem. This Skill bridges MCP clients like Claude Desktop to ArcGIS Pro through a controlled local server that validates every input, sandboxes all filesystem paths, and isolates ArcPy in a separate worker process so native crashes never take down the MCP host. ## Core Features & Use Cases - 100-tool ArcPy catalog: Covers 10 GIS verticals including data management, geometry analysis (buffer, clip, intersect, dissolve), raster operations (slope, zonal statistics, hydrology), network analysis, spatial statistics, and layout export to PDF/PNG. - PathGuard sandbox: Every filesystem argument is resolved and containment-checked against configured allowed roots in both the server and worker processes, rejecting traversal, UNC, and out-of-root paths. - Destructive operation gates: Ten state-mutating tools (delete, append, repair geometry, calculate field, and others) require an explicit confirm=true token before execution. - Use Case: Ask Claude to buffer all parcels in a geodatabase by 50 meters, project the result to a target EPSG code, add it to an .aprx map, and export the layout as a PDF, all within a confined workspace directory. ## Quick Start Install the package with pip, run arcgis-mcp-setup to clone the ArcGIS Pro Python environment, point ARCPY_PYTHON_PATH at the reported interpreter, and ask your MCP client to run health_check before any geoprocessing.

Frequently Asked Questions about arcgis-mcp-bridge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run ArcPy geoprocessing tools from Claude Desktop?▼

Install arcgis-mcp-bridge from PyPI, run arcgis-mcp-setup to clone the ArcGIS Pro Python environment, then configure Claude Desktop with the arcgis-mcp-server command and set ARCPY_PYTHON_PATH to the reported interpreter. Call health_check first to verify the server-to-worker pipeline before running any of the 100 geoprocessing tools.

What GIS operations can an MCP client perform on ArcGIS Pro data?▼

The catalog covers 100 tools across 10 verticals: geometry analysis like buffer, clip, intersect, and dissolve; data management for geodatabases and feature classes; raster operations including slope and zonal statistics; network analysis; spatial statistics like kernel density and hot spots; plus map, layer, and layout export automation.

Does arcgis-mcp-bridge work on Linux or macOS?▼

No, real geoprocessing requires Windows with a licensed ArcGIS Pro installation because ArcPy is Windows-bound. The Layer A server can run on other platforms for development and mocked testing, but the ArcPy worker process only runs on Windows.

How does the server prevent an AI agent from deleting my GIS data?▼

PathGuard resolves and containment-checks every filesystem path against configured allowed roots, rejecting traversal and out-of-root targets. Ten destructive tools like delete_dataset and repair_geometry additionally require an explicit confirm=true parameter before execution.

Why does the worker fail with ModuleNotFoundError for arcgis_mcp or pydantic_core?▼

This means the worker interpreter differs from where the bridge was installed. Install arcgis-mcp-bridge into the exact python.exe reported by arcgis-mcp-setup and use that same interpreter for both the MCP server command and ARCPY_PYTHON_PATH.

Can this control an already-open ArcGIS Pro desktop session?▼

No, it operates on saved .aprx project files through headless ArcPy execution, not a live GUI session. Use a live ArcGIS Pro add-in bridge when you need to watch changes happen in the open desktop application.