ph4ntom-ida-bridge
Supported LLM backend for the interactive terminal agent, allowing Gemini models to drive IDA Pro analysis through the bridge's tools.
Supported local LLM backend for the terminal agent, enabling offline models served by Ollama to control and query the IDA Pro session.
Supported LLM backend (GPT models) for the terminal agent, letting OpenAI models autonomously drive reverse-engineering operations in IDA Pro.
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.
ph4ntom IDA Bridge π
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.
1. Live IDA Pro 9.5 Analysis β Disassembly, Hex-Rays C & Microcode IR (MMAT_0)

2. Struct Reconstruction, ARM32 Thumb Vtables & Compensated Batch Curation

3. Sliced Non-Blocking Live Debugger (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).
β‘ Quickstart: Claude Desktop & Cursor (1-Click MCP Setup)
Connect Claude Desktop, Cursor, or any MCP client to your running IDA Pro instance in 60 seconds:
1. Clone & Install
git clone https://github.com/ph4ntom-rev/ph4ntom-ida-bridge.git
cd ph4ntom-ida-bridge
python -m pip install -e ".[mcp]"2. Install Plugin into IDA Pro
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).
3. Add to your MCP Config
π£ Claude Desktop
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"
]
}
}
}π» Cursor / Windsurf
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."
Related MCP server: ida-pro-mcp-dsh
βοΈ Comparison with Alternatives
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 |
π οΈ MCP Tools Reference (131 Tools & 2 Resources)
The MCP server exposes 131 purpose-built tools across 8 reverse-engineering domains:
Category | Tools | Description |
π Binary, Segments, Vtables & Multi-Instance |
| Binary metadata, hashes, |
π§© Decompilation, AST & IDA 9.5 Classes |
| Hex-Rays C pseudocode, one-shot combined context, batch decompile, arbitrary range disasm, jump tables, AST ctree JSON, Microcode IR (0β7), IDA 9.5 Class Model |
πΈοΈ Callgraphs & Xrefs |
| Filtered & paginated cross-references ( |
π Search, Globals, Bookmarks & Exploration |
| Full pagination ( |
π·οΈ Types, Structs & Enums |
| Full struct/enum/type CRUD and TIL type library management |
βοΈ Database Mutation & Code/Data |
| Verified renaming, lvar typing, code/data conversion, binary patching, compensating batch rollback |
π Live Debugger & Evidence |
| Non-blocking sliced debugger waits, hardware watchpoints, conditional |
β‘ Dynamic IDAPython |
| Real-time IDAPython execution with structured |
π¦ MCP Resources |
| Real-time binary metadata and complete OpenAPI schema |
π Security Model
The bridge runs inside IDA Pro, granting powerful capabilities. Version 6 implements defense-in-depth defaults:
Loopback binding only: binds strictly to
127.0.0.1:13370.Cryptographic session token: 256-bit token stored in
~/.ph4ntom_ida_bridge_token.Owner-only DACL: on Windows, token files are secured with protected owner-only access before writing.
Constant-time authorization: prevents timing side-channels during token validation.
POST body limit: capped at 5 MiB with strict UTF-8 JSON object validation.
CORS restriction: browser CORS is permitted only from localhost origins.
Dynamic IDAPython & breakpoint conditions disabled by default:
/api/exec,/api/dbg/cmd,/api/dbg/appcall, and conditional breakpoint scripts require explicitIDA_BRIDGE_ALLOW_EXEC=1.Process spawning gated:
POST /api/dbg/startrequiresIDA_BRIDGE_ALLOW_DBG_START=1(orIDA_BRIDGE_ALLOW_EXEC=1).Server-side file I/O restricted:
HTTP GETnever writes files; server-sidePOSTimports/exports requireIDA_BRIDGE_ALLOWED_IMPORT_ROOTS/IDA_BRIDGE_ALLOWED_EXPORT_ROOTS(MCP and CLI handle files client-side).
Never expose port 13370 through a public interface, tunnel, or reverse proxy. SeeSECURITY.md for full hardening guidance.
π¦ Components
Path | Purpose |
| Canonical IDA plugin and REST server (139 endpoints) |
| Machine-readable REST reference & OpenAPI schema |
| Shared authenticated HTTP client with token refresh & multi-instance discovery |
| CLI, plugin installer, doctor, evidence dumper, and IDA launcher |
| FastMCP server ( |
| Interactive terminal agent with 5 interchangeable LLM backends |
| Structured batch-analysis worker |
| Machine-readable integration specification for IDE agents |
| Portable IDA Pro 9.5 Agent Skill ( |
| Legacy single-file CLI guide for IDE agents |
π» CLI Quick Start
The included CLI provides instant control over your IDA session from any terminal:
# Health & info
ph4ntom-ida ping
ph4ntom-ida info
# Functions & strings
python cli.py functions --limit 50
python cli.py strings --filter "socket|http|connect"
# Decompilation & Cross-references
python cli.py decompile 0x140001000
python cli.py xrefs 0x140001000
python cli.py callers 0x140001000
# Direct API queries
python cli.py api GET /api/function/0x140001000/ctree
python cli.py api POST /api/function/0x140001000/rename --body '{"name":"decrypt_payload"}'
# Launch IDA with bridge autostart
python cli.py launch malware_sample.bin --waitβ‘ Optional Dynamic IDAPython Execution
Dynamic execution is intentionally off by default. Enable it only on trusted environments:
PowerShell:
$env:IDA_BRIDGE_ALLOW_EXEC = "1"Bash:
export IDA_BRIDGE_ALLOW_EXEC=1Execute scripts inline, from file, or piped via stdin:
python cli.py exec "result['ea'] = hex(idc.here())"
python cli.py exec --file custom_scan.py
cat analyze.py | python cli.py exec -Scripts receive full IDAPython SDK access (idc, idaapi, idautils, ida_hexrays, etc.) and a global result dictionary returned as JSON.
π€ Standalone Multi-Backend AI Agent
No IDE? Run the built-in terminal agent with any major LLM provider:
python -m pip install -e ".[agents]"
python agent.py --backend ollama # π Local (Ollama, private & offline)
python agent.py --backend gemini # βοΈ Google Gemini
python agent.py --backend anthropic # βοΈ Anthropic Claude 3.5 Sonnet
python agent.py --backend openai # βοΈ OpenAI GPT-4o
python agent.py --backend deepseek # βοΈ DeepSeek V3API keys are read from standard environment variables (GEMINI_API_KEY, ANTHROPIC_API_KEY, OPENAI_API_KEY, DEEPSEEK_API_KEY).
π§ͺ Testing & Verification
The test suite covers client authentication, routing contracts, MCP registration, CORS boundaries, and IDA 9.3 SDK quirks:
python -m pip install -e ".[dev,mcp]"
python -m compileall -q agent.py cli.py core ida_plugin integrations mcp_server.py server.py swarm_worker.py tests
python -m flake8 . --select=F --exclude=.venv
python -m pytest -q
python verify_mcp.pyAll 131 MCP tools and 139 REST endpoints are verified against IDA Professional 9.3β9.5. See TESTING.md for reproducibility details and regression checklists.
π License
Distributed under the MIT License. See LICENSE for more information.
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
GitHub Copilot MCP: code, repo, PR, workflow tools for AI assistants.
Multiple MCP tools, persistent graph memory, token-saving data pointers, and more.
Atomadic MCP: 68 deterministic tools for agent identity, escrow, SLA, EU AI Act compliance.
Hyperion β MCP tool marketplace for AI agents: web, OSINT, security, research via one key.
Related MCP Servers
- AlicenseNot gradedqualityFmaintenanceEnables LLM clients like Claude to interact with IDA Pro for binary analysis, decompilation, cross-references, patching, and more via 41 MCP tools, 8 resources, and 7 guided prompts.50MIT
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to perform binary analysis and reverse engineering via IDA Pro's headless idalib, providing 66 MCP tools like decompile, disasm, and xrefs without requiring the IDA GUI.5MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI-powered reverse engineering in IDA Pro by letting MCP clients inspect decompilation and disassembly, rename symbols, convert integers, and otherwise interact with the database through natural language.1MIT
- AlicenseNot gradedqualityBmaintenanceDeterministic, local-first MCP server for IDA Pro and IDA Home, exposing 109 strict-schema operations for reverse engineering with policy-gated mutations, evidence tracking, and broad AI-client support.15GPL 3.0