ida-mcp
Headless IDA Pro MCP server for AI-powered reverse engineering.
Prerequisites
- IDA Pro 9.2+ with valid license
Getting Started
Install
Via Homebrew
brew install blacktop/tap/ida-mcp
Download binary
Grab the latest release from GitHub Releases.
Build from source
See docs/BUILDING.md.
Configure your AI agent
Claude Code
claude mcp add ida -- ida-mcp
Codex CLI
cursor mcp add ida -- ida-mcp
Gemini CLI
gemini mcp add ida ida-mcp
Usage
Once configured, you can analyze binaries through your AI agent:
# Open a binary (IDA analyzes raw binaries automatically)
open_idb(path: "~/samples/malware")
# Discover available tools
tool_catalog(query: "find callers")
# List functions
list_functions(limit: 20)
# Disassemble by name
disasm_by_name(name: "main", count: 20)
# Decompile (requires Hex-Rays)
decompile(address: "0x100000f00")
The default tool list includes all tools. Use tool_catalog/tool_help to discover capabilities and avoid dumping the full list into context.
Docs
- docs/TOOLS.md - Tool catalog and discovery workflow
- docs/TRANSPORTS.md - Stdio vs Streamable HTTP
- docs/BUILDING.md - Build from source
- docs/TESTING.md - Running tests
License
MIT Copyright (c) 2026 blacktop