Documentation Index
Fetch the complete documentation index at: https://mintlify.com/mrexodia/ida-pro-mcp/llms.txt
Use this file to discover all available pages before exploring further.
IDA Pro MCP can be installed in three ways depending on how you work. The GUI plugin runs alongside an open IDA Pro window and is the easiest starting point. The headless idalib mode lets you analyze files programmatically without the GUI. Claude Code users can install through the plugin marketplace with a single command.
Prerequisites: IDA Pro 8.3 or higher (IDA Pro 9 recommended), Python 3.11 or higher, and a licensed copy of IDA Pro. IDA Free does not support plugins and cannot be used.
Installation methods
Claude Code
IDA GUI plugin
Headless (idalib)
The Claude Code plugin marketplace provides a one-command install that handles idalib configuration automatically.Step 1 — Add the marketplace and install the plugin:claude plugin marketplace add mrexodia/claude-marketplace
claude plugin install ida-pro-mcp@mrexodia
uv run "C:\Program Files\IDA Professional 9.3\idalib\python\py-activate-idalib.py"
uv run "/Applications/IDA Professional 9.3.app/Contents/MacOS/idalib/python/py-activate-idalib.py"
claude plugin update ida-pro-mcp@mrexodia
The GUI plugin runs inside IDA Pro and starts an MCP server automatically when IDA loads. This is the recommended approach for interactive analysis sessions.Step 1 — Install the package:pip install https://github.com/mrexodia/ida-pro-mcp/archive/refs/heads/main.zip
ida-pro-mcp --install claude,cursor
The GUI plugin is no longer the primary recommendation for new setups. Use the headless idalib method if you do not need an open IDA window.
The headless mode uses idalib to analyze binaries without opening the IDA GUI. It supports multiple concurrent files, multi-agent workflows, and stdio or HTTP transports.Step 1 — Activate idalib globally:uv run "C:\Program Files\IDA Professional 9.3\idalib\python\py-activate-idalib.py"
uv run "/Applications/IDA Professional 9.3.app/Contents/MacOS/idalib/python/py-activate-idalib.py"
uv run idalib-mcp --host 127.0.0.1 --port 8745 path/to/executable
idalib_open(...):uv run idalib-mcp --host 127.0.0.1 --port 8745
uv run idalib-mcp --stdio
http://127.0.0.1:8745/mcp, or use the stdio command above as the MCP server command.Use --max-workers N to control how many concurrent idalib processes can run. The default is 4. Set --isolated-contexts when multiple agents connect to the same server to prevent one agent from changing another’s active database.
Configuring other MCP clients
For clients not covered by the interactive installer, run the following command to print the JSON configuration block:
This prints the stdio, streamable HTTP, and SSE configuration snippets. Paste the appropriate block into your client’s MCP configuration file.
Supported MCP clients
The --install command can configure these clients automatically:
| Client | Platform |
|---|
| Amazon Q Developer CLI | Windows, macOS, Linux |
| Augment Code | Windows, macOS, Linux |
| Claude (desktop) | Windows, macOS |
| Claude Code | Windows, macOS, Linux |
| Cline | Windows, macOS, Linux |
| Codex | Windows, macOS, Linux |
| Copilot CLI | Windows, macOS, Linux |
| Crush | Windows, macOS, Linux |
| Cursor | Windows, macOS, Linux |
| Gemini CLI | Windows, macOS, Linux |
| Kilo Code | Windows, macOS, Linux |
| Kiro | Windows, macOS, Linux |
| LM Studio | Windows, macOS, Linux |
| Opencode | Windows, macOS, Linux |
| Qodo Gen | Windows, macOS, Linux |
| Qwen Coder | Windows, macOS, Linux |
| Roo Code | Windows, macOS, Linux |
| Trae | Windows, macOS, Linux |
| VS Code / VS Code Insiders | Windows, macOS, Linux |
| Warp | Windows, macOS, Linux |
| Windsurf | Windows, macOS, Linux |
| Zed | Windows, macOS, Linux |
ida-pro-mcp --config to get the raw configuration JSON.