Secure local REST, CLI, MCP, and agent bridge for IDA Pro 9.x
Autonomous AI & MCP Control Layer for IDA Pro 9.x
Turn IDA Pro into an agentic reverse-engineering powerhouse. Connect Claude Desktop, Cursor, Antigravity, or custom LLM agents via Model Context Protocol (MCP) or high-performance REST API.
MMAT_0)

40ms WFNE_USEC), Multi-Instance CLI & Security Guardrails
βββββββββββββββββββββββββββββββββββββββββββββββββββββββββββ
β IDA Pro 9.0β9.5 β
β ph4ntom_ida_bridge.py (143 REST Endpoints) β
β 127.0.0.1:13370..13389 (Bearer Token Protected) β
ββββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββββββ
β REST / JSON / SSE
ββββββββββββββββββββββββββββββββββΌββββββββββββββββββββββββββββββββ
βΌ βΌ βΌ
βββββββββββββββββ βββββββββββββββββ βββββββββββββββββ
β MCP Server β β CLI / SDK β β AI Agents β
β 131 Tools β β `ph4ntom-ida`β β Multi-LLM β
β Claude β β Automation β β Gemini β
β Cursor β β Headless β β Ollama β
β Antigravity β β Testing β β Claude / GPT β
βββββββββββββββββ βββββββββββββββββ βββββββββββββββββ
ph4ntom IDA Bridge is a localhost-only control layer for IDA Pro 9.x (including 9.5). It combines a self-contained IDA plugin, a JSON REST API, a Python client, a CLI (ph4ntom-ida), 131 native MCP tools (ph4ntom-mcp), and optional standalone AI backends.
Version 6.4.0 expands MCP tool coverage to 131 annotated tools across the entire 139-endpoint REST surface, hardens security boundaries (blocking conditional-breakpoint script bypasses, gating POST /api/dbg/start behind IDA_BRIDGE_ALLOW_DBG_START=1, moving file exports/imports client-side, and protecting ~/.ph4ntom_ida_instances.json), replaces blocking execute_sync debugger waits with non-blocking sliced WFNE_SILENT polling (preventing UI freezes and dbg_pause deadlocks), fixes embedded/raw-firmware (0x0 imagebase) addressing and ARM Thumb vtables, and supports full IDA Professional 9.5 APIs (DBG_Hooks, inf_is_32bit_exactly, Hex-Rays Class Model API, decompiler timeouts, and XREF_EXACT).
Connect Claude Desktop, Cursor, or any MCP client to your running IDA Pro instance in 60 seconds:
git clone https://github.com/ph4ntom-rev/ph4ntom-ida-bridge.git
cd ph4ntom-ida-bridge
python -m pip install -e ".[mcp]"
python cli.py install-plugin --ida-dir "C:\Program Files\IDA Professional 9.0"
(Or copy ida_plugin/ph4ntom_ida_bridge.py and api_schema.json directly into your IDA plugins/ directory).
Edit %APPDATA%\Claude\claude_desktop_config.json (Windows) or ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
{
"mcpServers": {
"ida-bridge": {
"command": "python",
"args": [
"C:/path/to/ph4ntom-ida-bridge/mcp_server.py"
]
}
}
}
Add to .cursor/mcp.json or Cursor Settings β MCP:
{
"mcpServers": {
"ida-bridge": {
"command": "python",
"args": ["-m", "mcp_server"],
"cwd": "C:/path/to/ph4ntom-ida-bridge"
}
}
}
Start IDA Pro, press Ctrl+Shift+A to toggle the server, and prompt your AI assistant:
"Inspect the function at 0x140001000. Trace cross-references, analyze microcode, decompile to C pseudocode, and rename obfuscated variables to meaningful names."
| Feature | ph4ntom IDA Bridge | Gepetto / IDAGPT | Hex-Rays Copilot |
|---|---|---|---|
| Architecture | Bi-directional MCP + REST + CLI | Single prompt-wrapper | Proprietary UI plugin |
| Tool Count | 131 Granular MCP Tools | 1 (Decompile prompt) | Fixed prompt actions |
| AST & Control Flow | Full ctree AST + Microcode IR (0-7) | Pseudocode text only | Pseudocode text only |
| Safe Mutations | Atomic batch mutations with rollback | Comment insertion only | Suggestions in UI |
| Live Debugger | 40 Tools: Watchpoints, Conditional BPs, Trace, Appcall, Evidence | No | No |
| Dynamic Execution | On-the-fly IDAPython execution engine | No | No |
| Supported LLMs | Any MCP Client / Claude / GPT / Gemini / Ollama | OpenAI API only | Proprietary cloud |
| Security & Auth | Localhost-only, 256-bit token, Owner DACL | Exposed plain API key | Proprietary |
| IDA Pro 9.5 Support | Verified & fully tested (9.0β9.5) | Broken on IDA 9+ | Official |
The MCP server exposes 131 purpose-built tools across 8 reverse-engineering domains: