IDA MCP
OfficialThis server lets AI agents drive IDA databases through a small MCP toolset: attach to GUI or headless IDA instances, execute Python inside them, inspect, save, and release them, with a built-in IDA API reference.
Look up IDA API/concepts via the
referencetool before writing code.Open/attach to databases (
open_database) targeting local executables or IDBs, using a GUI instance when available or a managed idalib worker, and optionally set it as the current default target.Run arbitrary Python against an open database (
execute_python) with persistent imports/variables, returning results plus captured stdout/stderr, with configurable timeout.List registered databases (
list_databases) to see available GUI and idalib instances and their state (available, attached, current, unavailable).Save databases explicitly (
save_database) for the current or specified instance.Close/release databases (
close_database) without disrupting other clients; GUI databases are never closed, and orphaned idalib execution is cancelled on final lease release.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@IDA MCPAnalyze the open binary and list its imports"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
IDA MCP
⚠️ Experimental prerelease ⚠️
This repository is actively WIP, do not use.
Installation
Requirements
Installed in your PATH
IDA 9.4 or higher with idalib and Python 3.11+
Other IDA MCP servers must be disabled to reduce agent confusion
IDA GUI Plugin
To support IDA GUI instances when using IDA MCP, install the plugin:
uvx ida-hcli plugin install https://github.com/HexRaysSA/ida-mcp
# or if you have hcli installed:
hcli plugin install https://github.com/HexRaysSA/ida-mcpNote: Without the GUI plugin, IDA MCP will only work headlessly.
Claude Code
# Add Hex-Rays marketplace
claude plugin marketplace add HexRaysSA/claude-marketplace
# Install plugin
claude plugin install ida-mcp@HexRaysSA
# Update to latest version
claude plugin update ida-mcp@HexRaysSACodex CLI
# Add Hex-Rays marketplace
codex plugin marketplace add HexRaysSA/codex-marketplace
# Install plugin
codex plugin add ida-mcp@HexRaysSAPi
# Install extension
pi install git:github.com/HexRaysSA/ida-mcp@latest
# Update to latest version
pi update --extensionsoh-my-pi
# Install extension
omp plugin install github:HexRaysSA/ida-mcp#latest
# Update to latest version
omp plugin upgradeOther agents
Configure a regular stdio MCP server in your MCP JSON configuration:
{
"mcpServers": {
"ida": {
"command": "uvx",
"args": [
"ida-nexus",
"mcp",
"--agent=my-agent"
]
}
}
}uvx resolves the latest stable ida-nexus release from PyPI, so this
configuration does not need to be updated for each release.
--agent=my-agent is a human-chosen label (like claude-code, cursor,
my-custom-agent, etc.) used to differentiate sessions in a metrics dashboard.
We tested the following clients, but any MCP client should work similarly:
Example Usage
Start your agent harness and ask it something like:
Reverse /path/to/sample.elf for me
To test the GUI integration, open something in IDA and ask your harness:
What do I have open in the IDA GUI?
Related MCP server: IDA Auto MCP
Developers: IDA Nexus
The IDA MCP project is built on IDA Nexus, which allows multiple clients to seamlessly share and operate on IDA databases.
You can build your own tools on top of the ida-nexus library, see
the documentation
for more information.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Code intelligence platform for AI agents. 20 tools for architecture, security & impact analysis.
Codebase intelligence for agents: 152 structured artifacts across 21 programs, one call.
Code intelligence for coding agents: semantic, AST, graph, and full-text search. 279+ languages.
Hunt zero-days by talking to binaries. 40+ tools. Hosted, OAuth + SSO, invite: hi@byteray.ai
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI-assisted reverse engineering in IDA Pro by providing tools to analyze binaries, decompile functions, manage comments, search patterns, and interact with the IDA database through natural language.562MIT
- FlicenseNot gradedqualityCmaintenanceA headless IDA Pro MCP server that enables AI agents to automatically open, analyze, and query multiple binary files simultaneously without manual GUI interaction. It provides 36 tools for tasks like decompilation, disassembly, and cross-reference analysis through IDA's idalib library.12
- AlicenseNot gradedqualityCmaintenanceExtends IDA Pro with multi-instance support and vulnerability scanning for AI-assisted reverse engineering.10MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/HexRaysSA/ida-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server