ida-code
MCP server that lets AI coding agents interact with IDA Pro. Open binaries, decompile, run IDAPython, search the API docs — all through tool calls.
Built on idalib for headless in-process operation and fastmcp for the MCP transport.
Requires a licensed IDA Pro 9.2+ with idalib support.
ida-codedoes not install or replace IDA Pro — it loadsidaprofrom your existing install at startup.
Install
uv tool install ida-code
This puts the ida-code CLI on your PATH (via uv's tool dir) so MCP clients can launch it directly. Don't have uv? pip install ida-code works too.
Then point IDA_INSTALL_DIR at your IDA Pro install (the directory that contains idalib/python/):
| OS | Typical path |
|---|---|
| Linux | /opt/ida-pro-9.3 |
| macOS | /Applications/IDA Professional 9.3.app/Contents/MacOS |
| Windows | C:\Program Files\IDA Professional 9.3 |
Use with Claude Code
Add ida-code to your project's .mcp.json:
{
"mcpServers": {
"ida-code": {
"command": "ida-code",
"env": {
"IDA_INSTALL_DIR": "/opt/ida-pro-9.3"
}
}
}
}
Restart Claude Code; the server is picked up automatically. You can confirm it's wired up by asking Claude to open a binary — it should call open_database and report architecture, entry point, and load address.
For other MCP clients, run the server directly:
IDA_INSTALL_DIR=/opt/ida-pro-9.3 ida-code # stdio transport
Tools (37)
Full parameter docs live in each tool's docstring — surfaced automatically to MCP clients via tools/list.
| Domain | Tools |
|---|---|
| Database | open_database, close_database, get_database_info, list_architectures |
| Code execution | execute, execute_file |
| Navigation | list_functions, decompile, get_disassembly, get_xrefs_to, get_xrefs_from |
| Annotation | rename_function, retype_function, get_comment, set_comment, delete_comment, get_variable, set_variable |
| Structures | list_structures, get_structure, create_structure, edit_structure, delete_structure |
| Snapshots | list_snapshots, create_snapshot, restore_snapshot, delete_snapshot |
| Undo/redo | get_undo_status, perform_undo, perform_redo |
| Inventory | get_strings, get_imports, get_exports |
| Search | search_docs, search_code, get_source, get_guideline |
Resources & prompts
| Type | URI / name | Purpose |
|---|---|---|
| Resource | guidelines://standalone_script |
Boilerplate for standalone idalib scripts |
| Resource | guidelines://plugin |
Boilerplate for IDA plugins (plugin_t) |
| Resource | guidelines://idapython_script |
Boilerplate for IDAPython scripts run inside IDA GUI |
| Prompt | reverse_engineer |
Five-phase RE workflow (recon, triage, analysis, annotation, iteration) |
| Prompt | create_script |
Coding guidelines for a chosen target script type |
Transport modes
ida-code # stdio (default)
ida-code --http # streamable-http on 127.0.0.1:8080
ida-code --http 0.0.0.0:9090 # custom host:port
ida-code --sse # SSE on 127.0.0.1:8080
ida-code --sse :9090 # SSE on 127.0.0.1:9090
HTTP/SSE require bearer token auth. Set MCP_AUTH_TOKEN or let the server generate one (printed to stderr on startup).
Environment variables
| Variable | Default | Description |
|---|---|---|
IDA_INSTALL_DIR |
/opt/ida-pro-9.3 |
IDA Pro installation directory (must contain idalib/python/) |
LOG_LEVEL |
WARNING |
Logging verbosity (DEBUG, INFO, WARNING, ERROR) |
MCP_AUTH_TOKEN |
(auto-generated) | Bearer token for HTTP/SSE transports |
Doc and example paths are derived from IDA_INSTALL_DIR (docs/, python/, python/examples/).
Install from source
git clone https://github.com/Dil4rd/ida-code
cd ida-code
uv sync
uv run ida-code
When wiring a source checkout into .mcp.json, use uv as the command:
{
"mcpServers": {
"ida-code": {
"command": "uv",
"args": ["run", "--directory", "/path/to/ida-code", "ida-code"],
"env": { "IDA_INSTALL_DIR": "/opt/ida-pro-9.3" }
}
}
}
Note: the
fastmcpdependency is the community fastmcp package, not the officialmcpSDK. Don't installmcpby mistake.
Development
uv sync --extra dev
uv run pytest
Known issues
See KNOWN_ISSUES.md for caveats and workarounds (e.g. why we pin fastmcp<3).
The test suite covers the executor, doc/example search, comments, snapshots, structures, undo, variables, and Mach-O parsing. Tests that need idalib are skipped if it's not available.
Credits
Thanks to @p41l for ideas and for testing the tool across different LLMs.
License
MIT — see LICENSE.
Metadata
Release files for ida-code 0.2.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| ida_code-0.2.4.tar.gz | 66.0 kB | With provenance | Details for ida_code-0.2.4.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| ida_code-0.2.4-py3-none-any.whl | Python 3 | none | any | Details for ida_code-0.2.4-py3-none-any.whl |
Total release size: 118.2 kB
Release files / ida_code-0.2.4.tar.gz
| Download URL | ida_code-0.2.4.tar.gz |
|---|---|
| Size | 66.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
f869eaf27487cb933e69aaed98a16bb77196004d7e410ab4f7e0f18e760cd5c4
|
|
BLAKE2b-256 checksum How to use checksums |
a1adadcdc20a73fe8a91ed5d830144eec0248526db40e8ab4214e8becc7d2688
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 20, 2026.
Transparency logRelease files / ida_code-0.2.4-py3-none-any.whl
| Download URL | ida_code-0.2.4-py3-none-any.whl |
|---|---|
| Size | 52.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f127ae3cd8b586288ff26b3b1d42d3b8d9bb70aa33b1e4799905be7ebb8ead96
|
|
BLAKE2b-256 checksum How to use checksums |
33449a38fa659d4980498fbdfdd41941d33e453ae439d538e0c51955c050764c
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.12
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 20, 2026.
Transparency logSecurity for ida-code 0.2.4
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for ida_code-0.2.4.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 20, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.