IDA Pro MCP Fusion

IDA Pro MCP fusion with cache queries and multi-binary headless analysis.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "ida-pro-mcp-fusion": {
      "command": "uvx",
      "args": [
        "--from"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

One MCP endpoint. Many binaries. Persistent analysis context.

Quick start · Why Fusion · Architecture · Tools · Configuration · Development

What is Fusion?

IDA Pro MCP Fusion connects MCP-compatible coding agents to IDA Pro and turns a single connection into a practical reverse-engineering workspace. It combines live IDA analysis with a persistent SQLite index and a supervisor that can keep several binaries open in isolated headless workers.

Use it to decompile and disassemble functions, trace cross-references, query types, rename symbols, patch data, create signatures, inspect multiple samples, and reuse cached analysis without repeatedly walking IDA's single-threaded APIs.

[!IMPORTANT] This project requires a local, licensed installation of IDA Pro. IDA Free is not supported. The server does not provide IDA, Hex-Rays, or a hosted analysis service.

Why Fusion

	Capability	What it changes
⚡	Persistent SQLite cache	Functions, strings, globals, imports, xrefs, and call-graph edges remain queryable across repeated investigations.
◈	Multi-binary supervisor	Open, address, and close several GUI or headless databases through one MCP endpoint.
⛓	Persistent workers	A later supervisor can discover and adopt an existing worker for the same database.
◎	Batch-first workflow	Warm analysis and build caches for a collection of samples with one `idb_batch_open` call.
⛨	Controlled surface	Read-only profiles, opt-in unsafe tools, worker limits, timeouts, and idle cleanup keep automation bounded.

The cache lives beside the IDB as <database>.mcp.sqlite. Freshness is checked against the IDB modification time and cache schema, so stale rows are not silently reused.

Quick start

1. Prerequisites

IDA Pro 8.3 or newer; IDA 9.x is recommended
Python 3.11 or newer
uv / uvx
Any MCP client that can launch a local stdio server

Install uv if it is not available:

bash

python -m pip install uv

Activate IDA's headless Python environment once:

powershell

# Windows — adjust the IDA version/path if needed
uv run "C:\Program Files\IDA Professional 9.3\idalib\python\py-activate-idalib.py"

bash

# macOS — adjust the IDA version/path if needed
uv run "/Applications/IDA Professional 9.3.app/Contents/MacOS/idalib/python/py-activate-idalib.py"

2. Add the MCP server

The recommended setup runs the latest code directly from this repository:

config.json

{
  "mcpServers": {
    "ida-pro-mcp-fusion": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/rison1337/ida-pro-mcp-fusion",
        "idalib-mcp",
        "--stdio"
      ]
    }
  }
}

Claude Code:

Terminal

claude mcp add ida-pro-mcp-fusion -- uvx --from git+https://github.com/rison1337/ida-pro-mcp-fusion idalib-mcp --stdio

Or download the packaged MCP bundle from the latest release.

3. Open a database

Ask the connected agent to start with:

python

idb_open(
    "C:/samples/target.exe",
    preferred_session_id="target",
    build_caches=True,
    init_hexrays=True,
)

Every analysis call then names its database explicitly:

python

survey_binary(database="target")
decompile("main", database="target")
xrefs_to("WinMain", database="target")
cache_callgraph_hotspots(limit=25, database="target")

Architecture

Your MCP client starts idalib-mcp over stdio or HTTP.
The supervisor creates or adopts one worker per binary and enforces the worker limit.
Tool calls include a database session ID, so requests are routed to the correct IDB.
IDA performs live decompilation and mutation work; cache tools serve indexed queries from the sidecar SQLite database.
Workers remain discoverable on the host and clean themselves up after their idle TTL.

GUI databases can participate too. idb_open supports four routing modes:

Mode	Behaviour
`prefer_headless`	Use or create an idalib worker. This is the default.
`force_headless`	Never adopt a running GUI instance.
`prefer_gui`	Adopt a matching GUI instance, otherwise create a worker.
`force_gui`	Adopt a matching GUI instance or launch IDA GUI.

Multi-binary workflow

Open a small collection and keep every session available:

python

idb_batch_open(
    [
        "C:/samples/loader.exe",
        "C:/samples/payload.dll",
        "C:/samples/helper.dll",
    ],
    session_prefix="case42",
    refresh_cache=True,
    cache_include_xrefs=True,
)

For a large corpus, build each cache and release its worker immediately:

python

idb_batch_open(
    ["C:/corpus/a.exe", "C:/corpus/b.exe", "C:/corpus/c.exe"],
    close_after_cache=True,
    retry_without_auto_analysis_on_timeout=True,
)

Useful session controls:

python

idb_list()
idb_close(database="case42_1_loader")

Tool surface

The codebase registers 75 IDA-facing analysis tools, plus the supervisor's multi-session controls. The exact number visible to a client intentionally varies: debugger tools are an extension, dangerous operations are disabled unless explicitly enabled, and a profile can expose a smaller allowlist.

Area	Representative tools
Sessions	`idb_open`, `idb_batch_open`, `idb_list`, `idb_close`, `idb_save`
Survey & decompilation	`survey_binary`, `decompile`, `disasm`, `analyze_function`, `analyze_component`
Search & relationships	`find`, `find_bytes`, `search_text`, `xrefs_to`, `callees`, `callgraph`, `trace_data_flow`
Persistent cache	`cache_status`, `refresh_cache`, `cache_entity_query`, `cache_xrefs`, `cache_callgraph_hotspots`, `cache_find_regex`
Types & stack	`declare_type`, `type_inspect`, `set_type`, `infer_types`, `stack_frame`, `declare_stack`
Database editing	`rename`, `set_comments`, `define_func`, `define_code`, `patch_asm`, `make_data`
Signatures	`make_signature`, `make_signature_for_function`, `make_signature_for_range`, `find_xref_signatures`
Debugger extension	`dbg_start`, `dbg_bps`, `dbg_regs`, `dbg_stacktrace`, `dbg_read`, `dbg_write`

The nine cache-specific tools are:

text

cache_status              refresh_cache
cache_refresh_if_stale    cache_list_funcs
cache_entity_query        cache_xrefs
cache_callgraph           cache_callgraph_hotspots
cache_find_regex

Configuration

Worker pool

bash

uvx --from git+https://github.com/rison1337/ida-pro-mcp-fusion \
  idalib-mcp --stdio --max-workers 4

Option / variable	Purpose
`--max-workers N`	Maximum simultaneous database workers; `0` means unlimited. Default: `4`.
`IDA_MCP_MAX_WORKERS`	Environment default for the worker limit.
`IDA_MCP_OPEN_TIMEOUT`	Maximum auto-analysis open time in seconds. Default: `1800`; `0` disables the limit.
`IDA_MCP_LOAD_TIMEOUT`	Maximum load-only open time in seconds. Default: `300`; `0` disables the limit.

Restricted profiles

Expose only a curated set of tools:

bash

idalib-mcp --stdio --profile profiles/readonly.txt

Two ready-to-use profiles are included:

profiles/readonly.txt — inspection without mutation tools
profiles/triage.txt — compact first-pass analysis surface

Management tools remain available so sessions can still be opened and inspected.

HTTP transport

bash

idalib-mcp --host 127.0.0.1 --port 8745

IDA GUI bridge:

bash

ida-pro-mcp --transport http://127.0.0.1:8744/sse

To install the GUI plugin and generate client configuration interactively:

bash

python -m pip install https://github.com/rison1337/ida-pro-mcp-fusion/archive/refs/heads/main.zip
ida-pro-mcp --install

Restart IDA and the MCP client after installation.

Safety notes

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

1mo ago

Most recent push to the default branch.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about IDA Pro MCP Fusion

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ida-pro-mcp-fusion": { "command": "uvx", "args": ["--from"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

IDA Pro MCP Fusion AllMCPs Directory Badge

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ida-pro-mcp-fusion?style=directory)](https://allmcps.com/mcp/ida-pro-mcp-fusion)

HTML Embed

<a href="https://allmcps.com/mcp/ida-pro-mcp-fusion"><img src="https://allmcps.com/api/badge/ida-pro-mcp-fusion?style=directory" alt="IDA Pro MCP Fusion on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

39Quality signal: Fair · 39/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity4/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to IDA Pro MCP Fusion →Install in Claude Desktop Install in Cursor Install in VS Code

IDA Pro MCP Fusion

IDA Pro MCP fusion with cache queries and multi-binary headless analysis.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Not yet automatically verified

We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "ida-pro-mcp-fusion": {
      "command": "uvx",
      "args": [
        "--from"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

One MCP endpoint. Many binaries. Persistent analysis context.

Quick start · Why Fusion · Architecture · Tools · Configuration · Development

What is Fusion?

[!IMPORTANT] This project requires a local, licensed installation of IDA Pro. IDA Free is not supported. The server does not provide IDA, Hex-Rays, or a hosted analysis service.

Why Fusion

	Capability	What it changes
⚡	Persistent SQLite cache	Functions, strings, globals, imports, xrefs, and call-graph edges remain queryable across repeated investigations.
◈	Multi-binary supervisor	Open, address, and close several GUI or headless databases through one MCP endpoint.
⛓	Persistent workers	A later supervisor can discover and adopt an existing worker for the same database.
◎	Batch-first workflow	Warm analysis and build caches for a collection of samples with one `idb_batch_open` call.
⛨	Controlled surface	Read-only profiles, opt-in unsafe tools, worker limits, timeouts, and idle cleanup keep automation bounded.

The cache lives beside the IDB as <database>.mcp.sqlite. Freshness is checked against the IDB modification time and cache schema, so stale rows are not silently reused.

Quick start

1. Prerequisites

IDA Pro 8.3 or newer; IDA 9.x is recommended
Python 3.11 or newer
uv / uvx
Any MCP client that can launch a local stdio server

Install uv if it is not available:

bash

python -m pip install uv

Activate IDA's headless Python environment once:

powershell

# Windows — adjust the IDA version/path if needed
uv run "C:\Program Files\IDA Professional 9.3\idalib\python\py-activate-idalib.py"

bash

# macOS — adjust the IDA version/path if needed
uv run "/Applications/IDA Professional 9.3.app/Contents/MacOS/idalib/python/py-activate-idalib.py"

2. Add the MCP server

The recommended setup runs the latest code directly from this repository:

config.json

{
  "mcpServers": {
    "ida-pro-mcp-fusion": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/rison1337/ida-pro-mcp-fusion",
        "idalib-mcp",
        "--stdio"
      ]
    }
  }
}

Claude Code:

Terminal

claude mcp add ida-pro-mcp-fusion -- uvx --from git+https://github.com/rison1337/ida-pro-mcp-fusion idalib-mcp --stdio

Or download the packaged MCP bundle from the latest release.

3. Open a database

Ask the connected agent to start with:

python

idb_open(
    "C:/samples/target.exe",
    preferred_session_id="target",
    build_caches=True,
    init_hexrays=True,
)

Every analysis call then names its database explicitly:

python

survey_binary(database="target")
decompile("main", database="target")
xrefs_to("WinMain", database="target")
cache_callgraph_hotspots(limit=25, database="target")

Architecture

Your MCP client starts idalib-mcp over stdio or HTTP.
The supervisor creates or adopts one worker per binary and enforces the worker limit.
Tool calls include a database session ID, so requests are routed to the correct IDB.
IDA performs live decompilation and mutation work; cache tools serve indexed queries from the sidecar SQLite database.
Workers remain discoverable on the host and clean themselves up after their idle TTL.

GUI databases can participate too. idb_open supports four routing modes:

Mode	Behaviour
`prefer_headless`	Use or create an idalib worker. This is the default.
`force_headless`	Never adopt a running GUI instance.
`prefer_gui`	Adopt a matching GUI instance, otherwise create a worker.
`force_gui`	Adopt a matching GUI instance or launch IDA GUI.

Multi-binary workflow

Open a small collection and keep every session available:

python

idb_batch_open(
    [
        "C:/samples/loader.exe",
        "C:/samples/payload.dll",
        "C:/samples/helper.dll",
    ],
    session_prefix="case42",
    refresh_cache=True,
    cache_include_xrefs=True,
)

For a large corpus, build each cache and release its worker immediately:

python

idb_batch_open(
    ["C:/corpus/a.exe", "C:/corpus/b.exe", "C:/corpus/c.exe"],
    close_after_cache=True,
    retry_without_auto_analysis_on_timeout=True,
)

Useful session controls:

python

idb_list()
idb_close(database="case42_1_loader")

Tool surface

Area	Representative tools
Sessions	`idb_open`, `idb_batch_open`, `idb_list`, `idb_close`, `idb_save`
Survey & decompilation	`survey_binary`, `decompile`, `disasm`, `analyze_function`, `analyze_component`
Search & relationships	`find`, `find_bytes`, `search_text`, `xrefs_to`, `callees`, `callgraph`, `trace_data_flow`
Persistent cache	`cache_status`, `refresh_cache`, `cache_entity_query`, `cache_xrefs`, `cache_callgraph_hotspots`, `cache_find_regex`
Types & stack	`declare_type`, `type_inspect`, `set_type`, `infer_types`, `stack_frame`, `declare_stack`
Database editing	`rename`, `set_comments`, `define_func`, `define_code`, `patch_asm`, `make_data`
Signatures	`make_signature`, `make_signature_for_function`, `make_signature_for_range`, `find_xref_signatures`
Debugger extension	`dbg_start`, `dbg_bps`, `dbg_regs`, `dbg_stacktrace`, `dbg_read`, `dbg_write`

The nine cache-specific tools are:

text

cache_status              refresh_cache
cache_refresh_if_stale    cache_list_funcs
cache_entity_query        cache_xrefs
cache_callgraph           cache_callgraph_hotspots
cache_find_regex

Configuration

Worker pool

bash

uvx --from git+https://github.com/rison1337/ida-pro-mcp-fusion \
  idalib-mcp --stdio --max-workers 4

Option / variable	Purpose
`--max-workers N`	Maximum simultaneous database workers; `0` means unlimited. Default: `4`.
`IDA_MCP_MAX_WORKERS`	Environment default for the worker limit.
`IDA_MCP_OPEN_TIMEOUT`	Maximum auto-analysis open time in seconds. Default: `1800`; `0` disables the limit.
`IDA_MCP_LOAD_TIMEOUT`	Maximum load-only open time in seconds. Default: `300`; `0` disables the limit.

Restricted profiles

Expose only a curated set of tools:

bash

idalib-mcp --stdio --profile profiles/readonly.txt

Two ready-to-use profiles are included:

profiles/readonly.txt — inspection without mutation tools
profiles/triage.txt — compact first-pass analysis surface

Management tools remain available so sessions can still be opened and inspected.

HTTP transport

bash

idalib-mcp --host 127.0.0.1 --port 8745

IDA GUI bridge:

bash

ida-pro-mcp --transport http://127.0.0.1:8744/sse

To install the GUI plugin and generate client configuration interactively:

bash

python -m pip install https://github.com/rison1337/ida-pro-mcp-fusion/archive/refs/heads/main.zip
ida-pro-mcp --install

Restart IDA and the MCP client after installation.

Safety notes

Read the full README →View source on GitHub →

Related MCP Servers

View all in Developer Tools View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

1mo ago

Most recent push to the default branch.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about IDA Pro MCP Fusion

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "ida-pro-mcp-fusion": { "command": "uvx", "args": ["--from"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/ida-pro-mcp-fusion?style=directory)](https://allmcps.com/mcp/ida-pro-mcp-fusion)

HTML Embed

<a href="https://allmcps.com/mcp/ida-pro-mcp-fusion"><img src="https://allmcps.com/api/badge/ida-pro-mcp-fusion?style=directory" alt="IDA Pro MCP Fusion on AllMCPs" /></a>

Technical Specs & Signals

CategoryDeveloper Tools

39Quality signal: Fair · 39/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools15/30

Adoption & activity4/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💻 Developer Tools →Best MCP servers for Developers →Alternatives to IDA Pro MCP Fusion →Install in Claude Desktop Install in Cursor Install in VS Code