IDA MCP

⚠️ Experimental prerelease ⚠️

This repository is actively WIP, do not use.

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-mcp

Note: Without the GUI plugin, IDA MCP will only work headlessly.

MCP Installation

Requirements

• Installed in your PATH
  • Git
  • uv
• IDA 9.4 or higher with idalib and Python 3.11+
• Other IDA MCP servers must be disabled to reduce agent confusion

Claude Code

claude plugin marketplace add HexRaysSA/claude-marketplace
claude plugin install ida-mcp@HexRaysSA

Codex CLI

codex plugin marketplace add HexRaysSA/codex-marketplace
codex plugin add ida-mcp@HexRaysSA

Pi

pi install git:github.com/HexRaysSA/ida-mcp@latest

oh-my-pi

omp plugin install github:HexRaysSA/ida-mcp#latest

Other 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. Pre-release dependency resolution is currently required because ida-domain is published as a development 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:

• Antigravity
• LM Studio

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?

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.