iitc-mcp
Bridge between IITC and MCP, allowing AI agents to interact with the Ingress Intel map, portals, links, fields, COMM, player tracking, and more.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
IITC-MCP
Bridge between IITC (Ingress Intel Total Conversion) and MCP (Model Context Protocol) agents. Let your AI assistant see the map, count portals, track players, and talk to COMM — without touching a mouse.

Quick Start
1. Install Userscript
Install IITC first, then add the iitc-mcp userscript in Tampermonkey:
https://github.com/comicchang/iitc-mcp/releases/latest/download/iitc-mcp.user.js2. Configure MCP Server for Your Agent
CLI entry:
npx github:comicchang/iitc-mcp serveAdd --read-only for read-only mode (14 tools; omits iitc_send_comm and iitc_redeem_code):
npx github:comicchang/iitc-mcp serve --read-onlyCodex (~/.codex/config.toml or project-level .codex/config.toml):
[mcp_servers.iitc-mcp]
command = "npx"
args = ["github:comicchang/iitc-mcp", "serve"]OpenCode (~/.openCode/mcp.json or project-level .openCode/mcp.json):
{
"mcpServers": {
"iitc-mcp": {
"command": "npx",
"args": ["github:comicchang/iitc-mcp", "serve"]
}
}
}"iitc-mcp": {
"type": "stdio",
"command": "/path/to/node_modules/.bin/tsx",
"args": ["/path/to/packages/mcp-server/src/cli.ts", "serve"]
}Reload MCP config and you're set — 16 tools auto-register (14 if server started with --read-only).
Open https://intel.ingress.com. Once both the userscript and MCP server are ready, the MCP indicator in IITC Toolbox turns green.
Related MCP server: map-mcp
MCP Tools (16 total)
Tool | Description |
| Map center, zoom, bounds, selected portal |
| Set map center and zoom |
| Fit map to bounding box |
| Search named region via Nominatim → fit bounds → wait for data |
| List portals in viewport (paginated) |
| List links in viewport (paginated) |
| List control fields in viewport (paginated) |
| Portal detail: mods, resonators, link/field GUIDs |
| Select a portal on the map |
| Search portals by name |
| Read COMM messages |
| Send COMM message |
| Redeem a passcode |
| Your own faction, level, AP, XM |
| Tracked players with last position (Player Tracker) |
| Single player's trail with timestamps |
Usage Examples
Ask your AI assistant in natural language:
Search a region and count portals
搜索静安雕塑公园,统计 portal 状态
iitc_search_region("静安雕塑公园") → 围框 + 等数据加载
iitc_list_portals → 按阵营统绿/蓝/红/白数量Check a specific portal
青果巷赵宅现在什么颜色,连满 link 了吗
iitc_search("青果巷") → 找到候选 Portal
iitc_get_portal_details(guid) → 阵营/等级/血量/linkGuidsSee who's been active nearby
附近最近有谁在动
iitc_list_players → 玩家名/阵营/最近位置/动作
iitc_get_player_trail("playerName") → 完整轨迹Find high-value targets
区域内有哪些 L7+ Portal,哪些阵营占领的
iitc_search_region("目标区域") → 围框
iitc_list_portals → 按 level 筛选 L7+Monitor COMM
看看 COMM 最近在聊什么
iitc_list_comm(channel="all") → 最近消息Architecture
Default mode — embedded broker (one agent = one browser session):
graph LR
US[Userscript] -->|HTTP :27342| S[Server]
S -->|stdio| AGENT[AI Agent]Shared mode — standalone broker + multiple MCP servers:
graph LR
US[Userscript] -->|HTTP :27342| BR[Bridge Broker]
MCP_A[MCP Server A] -->|/mcp/*| BR
MCP_B[MCP Server B] -->|/mcp/*| BR
AGENT_A[AI Agent A] -->|stdio| MCP_A
AGENT_B[AI Agent B] -->|stdio| MCP_Biitc-mcp broker # start standalone broker
iitc-mcp serve --broker-url http://127.0.0.1:27342 # connect to shared brokerCommands are queued by ID — simultaneous operations may interfere. In practice, only one agent operates at a time.
Three packages:
packages/protocol— shared Zod schemaspackages/iitc-plugin— userscript (page adapter + transport)packages/mcp-server— Node.js MCP server (broker + HTTP + CLI)
Build & Development
git clone https://github.com/comicchang/iitc-mcp.git
cd iitc-mcp
npm ci --legacy-peer-deps
npm run build && npm test # 163 tests, typecheck, 3 build artifactsDaily dev commands:
npm run typecheck # strict TypeScript
npm run build # userscript + server
npm run lint # ESLint
npm test # unit tests (163)
npm run test:smoke # no-browser smoke tests
# Start MCP server locally
npx tsx packages/mcp-server/src/cli.ts serve
# Read-only mode
npx tsx packages/mcp-server/src/cli.ts serve --read-onlyLicense
See LICENSE. Fork must preserve the same license. Only Enlightened players may use this software. Resistance and Machina are not welcome. Attempting to bypass these restrictions is prohibited.
Enlightened 💚
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Human-input bridge for AI agents with voice-first answer links, MCP tools, and HTTP APIs.
Telegram bridge for your MCP-compatible agent. Bidirectional, no LLM in our stack.
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
Stop copy-pasting client context into your AI. 48 connectable providers via MCP.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceBridges MCP-compatible AI clients to over 100 Hermes Agent skills for web browsing, file management, code execution, GitHub operations, and more.1MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to perceive and control a live MapLibre GL map over MCP, allowing querying rendered features, reading popups, navigating, and toggling layers.17 PyPI1MIT
- AlicenseNot gradedqualityDmaintenanceBridges a browser extension with an AI agent via MCP, enabling the agent to capture and act on UI elements, styles, and accessibility data from web pages.25 npmISC
- AlicenseAqualityDmaintenanceTwo-way Burp Suite MCP bridge enabling AI agents to capture traffic, analyze endpoints, queue scans, and send findings back to Burp.11MIT