CLI-Anything · ArcGIS Pro
The closed-source counterpart to CLI-Anything's QGIS harness. ArcGIS Pro is Esri's commercial GIS desktop app, so it can't be auto-generated from source — this wraps its official ArcPy / ArcGIS Pro SDK instead, in two complementary modes:
✅ Listed in the official CLI-Anything registry (PR #318, merged) and on the Glama MCP registry.
Mode | What it drives | How |
Headless CLI |
|
|
Live bridge + MCP | the open ArcGIS Pro session (you watch it work) | in-process .NET add-in + MCP server |
✨ Features
🗺️ Professional cartography — export layouts and Map Series / map books (ArcGIS Pro's edge over QGIS).
🧰 The whole ArcToolbox — run any geoprocessing tool (buffer, clip, intersect, dissolve, …) via one command.
🔌 Drive the live session — an agent operates the open project over MCP; results appear in the map as you watch.
🤖 Agent-native I/O — every command speaks JSON:
{ "ok": …, "data" | "error": … }.🧠 Self-healing install — the CLI re-dispatches into ArcGIS Pro's Python automatically, so it works no matter where it's installed.
✅ Tested —
test_core(no backend) +test_full_e2e(needs ArcGIS Pro).
Related MCP server: arcpy-mcp-server
🎬 Demo
A complete workflow driven live by an agent — data → clip → analysis → finished map — inside ArcGIS Pro through the MCP bridge:
🚀 Quickstart
Install into ArcGIS Pro's bundled Python (arcgispro-py3), which provides ArcPy:
"C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3\python.exe" -m pip install ^
git+https://github.com/Jasper0122/CLI-Anything-Arcgis-Pro.gitcli-anything-arcgis-pro --json infoInstalled into a different Python? (e.g. via the CLI-Hub, which uses its own interpreter.) That's fine — the command self-dispatches into ArcGIS Pro's
arcgispro-py3interpreter when ArcPy isn't present. It locates Pro via common install paths, theSOFTWARE\ESRI\ArcGISProregistry key, or theCLI_ANYTHING_ARCGIS_PYTHONenvironment variable.
Requires a licensed ArcGIS Pro install (provides ArcPy). Verified on ArcGIS Pro 3.4 / ArcPy 3.4.3 / .NET 8.
For the live bridge, build & install the add-in and register the MCP server — see live-bridge/README.md.
🧰 Commands
Headless CLI (every command takes --json before the subcommand):
Command | What it does |
| ArcPy version, license level, extension availability. |
| Maps, layouts, layers, data sources of an |
| ★ Professional export: layouts + Map Series / map books. |
| Author the map: add layers, apply graduated-color / unique-value renderers. |
| Inspect & edit feature classes and tables. |
| Run any geoprocessing tool (the whole ArcToolbox). |
| Export every layout in a project. |
:: print-quality A0 map at 300 DPI
cli-anything-arcgis-pro --json layout export C:\proj\city.aprx --layout "Poster" --out C:\out\poster.pdf --dpi 300
:: buffer roads by 100 m
cli-anything-arcgis-pro --json gp analysis.Buffer -a C:\d.gdb\roads -a C:\d.gdb\roads_buf --kw buffer_distance_or_field="100 Meters"
:: close the loop: add the result to a map and symbolize it — no GUI clicks
cli-anything-arcgis-pro --json map add-data C:\proj\city.aprx C:\d.gdb\tracts
cli-anything-arcgis-pro --json map symbology graduated C:\proj\city.aprx tracts --field MEDINCOME --classes 5 --ramp ViridisSee SKILL.md for the full agent guide, and demos/ for runnable end-to-end demos.
🔌 MCP tools
With the live bridge registered, an agent can drive the open project:
MCP tool | Action on the live project |
| Read the open project: maps, layouts, active view. |
| Zoom the active map to a layer (optionally a selection). |
| Query a layer's attributes → structured rows. |
| Run any geoprocessing tool; outputs are added to the live map. |
| Export a layout to PDF. |
🧭 Architecture
Agent ──MCP──► mcp_server.py ──HTTP─► in-Pro add-in ──QueuedTask─► LIVE project
(you watch)ArcPy can't attach to a running ArcGIS Pro from an external process (Esri limitation). The live bridge sidesteps this by running an in-process add-in that exposes the open project over a local socket, wrapped as MCP tools — while the headless CLI stays perfect for batch/automation with no GUI.
Full code-implementation flow:

Source: docs/implementation-flow.canvas (JSON Canvas / Obsidian).
📁 Repository layout
cli_anything_arcgis_pro/ headless ArcPy CLI (pip package)
tests/ test_core.py (no backend) + test_full_e2e.py (needs Pro)
demos/ runnable demos (headless, live bridge, full region workflow)
live-bridge/
mcp_server.py stdlib-only MCP server → in-Pro bridge
ProSimpleMapExport/ ArcGIS Pro .NET add-in (bridge server + export button)
docs/ hero image, architecture diagram (.png + .canvas)
SKILL.md canonical agent skill definition🤝 Contributing
This is a standalone harness for CLI-Anything (listed in its registry, merged in #318). Issues and PRs welcome — run the tests with ArcGIS Pro's Python:
"C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3\python.exe" -m pytest tests/Where to help: see the Roadmap — it maps every planned command to its ArcPy / Pro SDK API and marks tasks that need no ArcGIS license (🐍, e.g. the MCP server, tests, docs) and good first issues (🟢). The biggest open frontier is cartographic authoring (symbology, layout, layer management) — the part that makes ArcGIS Pro beat QGIS.
📄 License
Source-available, not OSI open-source. Licensed under the PolyForm Noncommercial License 1.0.0:
🟢 Free for noncommercial use — personal projects, study, research, evaluation, and nonprofit / educational / government organizations.
💼 Commercial use requires a paid license — see
LICENSE-COMMERCIAL.md.
This is an independent downstream project; upstream CLI-Anything is separately licensed under Apache-2.0.
🙏 Acknowledgements
Built as a contribution to HKUDS/CLI-Anything — "Making ALL Software Agent-Native." ArcGIS, ArcGIS Pro and ArcPy are trademarks of Esri; this project is an independent integration and is not affiliated with Esri.
Available Tools
6 toolsarcgis_export_layoutA
把活着的 ArcGIS Pro 工程里的某个布局导出为 PDF。导出在用户正开着的 Pro 实例内执行(用户能看到),返回输出路径与文件大小。
Inputs: out (required), layout, dpi.
arcgis_pingA
读取当前打开的 ArcGIS Pro 工程状态:工程名、所有地图、所有布局、以及当前活动的地图/布局。发其它命令前先用它了解打开的是什么工程。
Inputs: no named parameters.
arcgis_queryA
查询活工程里某要素图层的属性,返回结构化的行(不含几何)。可按 where 过滤、限制行数。
Inputs: layer (required), where, map, limit.
arcgis_run_gpA
在活工程上运行任意 ArcGIS 地理处理工具(整个 ArcToolbox:分析/管理/转换/栅格…)。输出图层会自动加到当前地图(用户能看到)。tool 用点号写法如 'analysis.Buffer'、'management.Clip';params 是按工具签名顺序排列的位置参数字符串数组。例:tool='analysis.Buffer',params=['roads','roads_buf','100 Meters']。
Inputs: tool (required), params (required), allow_delete.
arcgis_symbologyA
给活工程里某要素图层套用渲染器,让地图会说话——用户能在 Pro 窗口里立刻看到变色。renderer='graduated' 用数值字段做分级配色(专题图主力);'unique' 用分类字段每个值一种颜色。例:layer='tracts', renderer='graduated', field='MEDINCOME', classes=5, ramp='Viridis'。
Inputs: layer (required), renderer (required), field (required), classes, +3 more.
arcgis_zoom_toA
把活动地图视图缩放到某个要素图层(用户能在窗口里看到地图动)。可选 where 条件:会先选中匹配要素再缩放到选集。需要 Pro 当前处于地图视图(非布局)。
Inputs: layer (required), where.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a distinct purpose: status checking, layout export, attribute query, geoprocessing, symbology application, and view zooming. No overlap in functionality.
All tools start with 'arcgis_' and follow a verb-noun pattern (e.g., arcgis_export_layout, arcgis_zoom_to). Minor abbreviation in 'run_gp' and phrasal verb 'zoom_to' are acceptable but not perfectly uniform.
Six tools is well-scoped for interacting with an active ArcGIS Pro session, covering essential operations without being overwhelming or too sparse.
Covers core workflows like export, query, symbology, and running any geoprocessing tool. Missing direct data editing (create/update/delete features) and layer management, but the GP tool can indirectly cover some gaps.
Maintenance
Related MCP Connectors
GitHub Copilot MCP: code, repo, PR, workflow tools for AI assistants.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
Unofficial Hyperbrowser MCP — wraps the Hyperbrowser AI-agent browsing API (hyperbrowser.ai).…
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Related MCP Servers
- AlicenseCqualityDmaintenanceA local MCP server that enables AI clients to read ArcGIS Pro project information and execute ArcPy geoprocessing in the native ArcGIS Pro Python environment.13106MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to perform spatial analysis in ArcGIS Pro using natural language by exposing all ArcGIS Pro toolboxes as MCP tools.11MIT
- AlicenseNot gradedqualityBmaintenanceEnables MCP-capable assistants to control an open ArcGIS Pro project locally over TCP 127.0.0.1, with 68 commands and 167 tools for layers, editing, symbology, layouts, geoprocessing, and arcpy execution.2MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI clients to inspect and modify maps and scenes open in a locally running desktop GIS session through natural language, exposing 38 fixed tools for session and layer queries, fields, selection, visibility and renaming, symbology, transparency, camera and elevation, map switching, raster, layout export, whitelisted geoprocessing, and attribute editing. It routes stdio MCP calls through a Windows named pipe to a C# add-in, with no network ports and no arbitrary code execution.MIT