Skip to main content
Glama
IDA Pro MCP Server

IDA Pro MCP Server

by 31Benzi

IDA Pro MCP Server for Claude Code

Bridge Claude Code (CLI and Editor Extensions like VS Code, Cursor, Windsurf) with IDA Pro 9.0+ for AI-assisted reverse engineering. 87 tools covering virtually everything IDA Pro can do.


Architecture

Claude Code / Cursor / VS Code (MCP Client)
               │ (stdio)
               ▼
        ida-mcp Server
               │ (JSON-RPC over localhost:13337)
               ▼
   IDA Pro Plugin (ida_mcp_plugin.py)
               │ (IDAPython API on main thread)
               ▼
         IDA Pro 9.0+

Related MCP server: IDA Pro MCP Multi

Installation & Setup

1. Install the IDA Plugin

Copy ida_plugin/ida_mcp_plugin.py into your IDA Pro plugins directory:

  • macOS: ~/idapro-9.0/plugins/ or /Applications/IDA Professional 9.0.app/Contents/MacOS/plugins/

  • Windows: %APPDATA%\Hex-Rays\IDA Pro\plugins\ or C:\Program Files\IDA Professional 9.0\plugins\

  • Linux: ~/.idapro/plugins/ or /opt/idapro-9.0/plugins/

When you open any binary in IDA Pro, the plugin starts a JSON-RPC server on 127.0.0.1:13337.

2. Configure Claude Code CLI

claude mcp add ida-pro -- uv run --directory "/Users/benzi/Documents/IDA MCP" ida-mcp

3. Configure VS Code / Cursor / Windsurf

Add to .mcp.json or your editor's MCP configuration:

{
  "mcpServers": {
    "ida-pro": {
      "command": "uv",
      "args": ["run", "--directory", "/Users/benzi/Documents/IDA MCP", "ida-mcp"]
    }
  }
}

Environment Variables

  • IDA_MCP_HOST — Override host (default: 127.0.0.1)

  • IDA_MCP_PORT — Override port (default: 13337)


Available Tools (87 Total)

Analysis (4)

Tool

Description

decompile_function

Hex-Rays C pseudocode decompilation

disassemble_function

Full assembly listing for a function

disassemble_range

Assembly between two addresses

get_bytes

Read raw hex bytes from an address

Navigation & Discovery (14)

Tool

Description

list_functions

List all functions with optional filter

get_function_info

Detailed function metadata

list_segments

Memory segments with permissions

get_xrefs_to

Cross-references TO an address

get_xrefs_from

Cross-references FROM an address

list_strings

Defined strings with optional filter

get_imports

Imported functions by module

get_exports

Exported functions and entry points

list_structs

Structures, unions, member layouts

list_enums

Enumerations and values

create_struct

Create a new struct type

get_function_callers

Functions calling a target (with call sites)

get_function_callees

Functions called by a target

make_string

Define a C-style string at address

Introspection (14)

Tool

Description

get_flowchart

Control flow graph — basic blocks with predecessors/successors

get_comment

Read comment at an address

get_all_comments

Read all comments within a function

get_function_comment

Read function-level comment

set_function_comment

Set function-level comment

get_stack_frame

Full stack frame layout (locals, args, saved regs)

set_operand_type

Change operand display (hex/decimal/binary/char)

set_local_variable_type

Retype a local variable in decompilation

get_color

Get instruction/function/segment color

set_color

Set instruction/function/segment color (RGB)

get_function_hash

Hash function bytes (MD5/SHA1/SHA256)

get_exception_info

Detect try/catch/throw in a function

get_microcode

Hex-Rays intermediate representation at any maturity level

Modifications (7)

Tool

Description

rename_function

Rename a function

rename_address

Rename a label, variable, or address

set_comment

Set regular or repeatable comment

set_function_type

Set C function signature/prototype

set_type

Set type at address

rename_local_variable

Rename local variable (Hex-Rays)

apply_callee_type

Apply type at call site

Search (2)

Tool

Description

search_text

Text search through disassembly

search_bytes

Byte pattern/signature search

Debugger (17)

Tool

Description

start_debugger

Start debugging the binary

get_debugger_status

Check debugger active/suspended state

set_breakpoint

Set software breakpoint

delete_breakpoint

Remove a breakpoint

list_breakpoints

List all breakpoints

enable_breakpoint

Enable/disable breakpoint

step_into

Step into next instruction

step_over

Step over next instruction

continue_execution

Continue until next breakpoint

suspend_debugger

Pause execution

exit_debugger

Terminate process

get_registers

Read CPU registers

read_debug_memory

Read memory from debugged process (hex dump with ASCII)

get_stack_trace

Call stack trace

list_debugger_threads

List all process threads

switch_thread

Switch active debugger thread

add_watchpoint

Set hardware watchpoint (read/write/execute)

Advanced (14)

Tool

Description

patch_bytes

Patch bytes in the IDA database

execute_idapython

Run arbitrary IDAPython code

load_type_library

Load .til type information library

list_type_libraries

List loaded TILs

make_code

Convert bytes to code (instruction)

make_data

Convert bytes to typed data

undefine

Revert to raw undefined bytes

define_function

Create function at address range

undefine_function

Delete function definition

add_bookmark

Add persistent bookmark

list_bookmarks

List all bookmarks

delete_bookmark

Remove bookmark

get_local_variables

List local variables and arguments

get_global_variables

List named global data variables

Database & Export (12)

Tool

Description

save_database

Save the IDA database

apply_flirt_signature

Apply FLIRT .sig for library identification

list_flirt_signatures

List applied FLIRT signatures

create_segment

Create new memory segment

delete_segment

Delete segment definition

set_segment_permissions

Change segment rwx permissions

create_array

Define typed arrays

navigate_to

Jump IDA cursor to address

produce_asm

Export clean assembly listing

produce_c

Export clean C pseudocode

run_idc_script

Execute IDC script code

run_ida_action

Trigger registered IDA UI action

list_ida_actions

List all available IDA actions

Meta (3)

Tool

Description

get_binary_info

File path, arch, bitness, entry point

get_analysis_status

Check auto-analysis completion

ping

Check IDA connectivity

Available Tools

87 tools
add_bookmarkA

Add a bookmark at an address with optional description. Bookmarks persist in the IDA database.

Inputs: address (required), description. Returns: result

add_watchpointC

Set a hardware watchpoint (data breakpoint). Triggers when memory at address is accessed. watch_type: write, read, execute.

Inputs: address (required), size, watch_type. Returns: result

apply_callee_typeB

Apply a type signature to a call site (callee). Useful when the function pointer type is unknown at a call instruction.

Inputs: address (required), prototype (required). Returns: result

apply_flirt_signatureB

Apply a FLIRT signature file (.sig) to identify library functions in stripped binaries. Pass the signature name (e.g. 'vc64rtf' for MSVC runtime).

Inputs: sig_name (required). Returns: result

continue_executionB

Continue process execution until the next breakpoint or event.

Inputs: no named parameters. Returns: result

create_arrayA

Create an array at an address. element_type: byte, word, dword, qword. count: number of elements.

Inputs: count (required), address (required), element_type. Returns: result

create_segmentB

Create a new memory segment. permissions: bitmask (4=read, 2=write, 1=execute, 7=rwx). seg_class: CODE, DATA, BSS, STACK, etc.

Inputs: name (required), end_address (required), start_address (required), seg_class, +1 more. Returns: result

create_structA

Create a new structure type. Pass a name and list of fields, each with 'name' and 'type' keys. Example fields: [{"name": "size", "type": "int"}, {"name": "data", "type": "char *"}]

Inputs: name (required), fields (required). Returns: result

decompile_functionA

Decompile a function using the Hex-Rays decompiler. Pass a function name or hex address (e.g. '0x401000' or 'main'). Returns C-like pseudocode.

Inputs: identifier (required). Returns: result

define_functionB

Create a new function at a given address range. If end_address is empty, IDA will auto-detect the function boundary.

Inputs: start_address (required), end_address. Returns: result

delete_bookmarkA

Delete a bookmark by slot number (get slot numbers from list_bookmarks).

Inputs: slot (required). Returns: result

delete_breakpointC

Delete a breakpoint at an address.

Inputs: address (required). Returns: result

delete_segmentB

Delete the segment containing the given address. The data is kept but the segment definition is removed.

Inputs: address (required). Returns: result

disassemble_functionB

Get the assembly listing of a function. Pass a function name or hex address (e.g. '0x401000' or 'main').

Inputs: identifier (required). Returns: result

disassemble_rangeA

Disassemble an arbitrary address range. Pass hex addresses (e.g. '0x401000', '0x401100').

Inputs: end_address (required), start_address (required). Returns: result

enable_breakpointC

Enable or disable a breakpoint without removing it.

Inputs: address (required), enable. Returns: result

execute_idapythonB

Execute arbitrary IDAPython code inside the IDA session. Set 'result' or 'output' variable in your script to return data. Example: 'import idc; result = idc.get_screen_ea()'

Inputs: code (required). Returns: result

exit_debuggerB

Terminate the debugged process and stop the debugger.

Inputs: no named parameters. Returns: result

get_all_commentsA

Get all comments within a function (both regular and repeatable). Pass function name or address.

Inputs: identifier (required). Returns: result

get_analysis_statusA

Check if IDA's auto-analysis has completed. Some tools may return incomplete results if analysis is still running.

Inputs: no named parameters. Returns: result

get_binary_infoA

Get metadata about the currently loaded binary (filename, architecture, bitness, entry point).

Inputs: no named parameters. Returns: result

get_bytesB

Read raw bytes from an address. Returns hex dump. Default reads 16 bytes.

Inputs: address (required), size. Returns: result

get_colorB

Get the color of an instruction, function, or segment. Returns hex RGB value.

Inputs: address (required), item_type. Returns: result

get_commentB

Read the comment at an address. Set is_repeatable=True for repeatable comments.

Inputs: address (required), is_repeatable. Returns: result

get_debugger_statusA

Check if the debugger is currently active and whether execution is suspended.

Inputs: no named parameters. Returns: result

get_exception_infoA

Check if a function contains exception handling (try/catch/throw). Returns the decompiled code if exception handling is found.

Inputs: identifier (required). Returns: result

get_exportsB

List all exported functions/symbols.

Inputs: no named parameters. Returns: result

get_flowchartB

Get the control flow graph (basic blocks and edges) of a function. Shows predecessors and successors for each block. Essential for understanding branch logic.

Inputs: identifier (required). Returns: result

get_function_calleesA

Get all functions called by a given function. Shows what a function depends on.

Inputs: identifier (required). Returns: result

get_function_callersA

Get all functions that call a given function. Higher-level than xrefs — groups by calling function and shows call sites.

Inputs: identifier (required). Returns: result

get_function_commentB

Read the function-level comment (appears above/below the function header in disassembly).

Inputs: identifier (required), is_repeatable. Returns: result

get_function_hashA

Calculate a hash of a function's raw bytes. Useful for identifying identical/similar functions across binaries. Algorithms: md5, sha1, sha256.

Inputs: identifier (required), algorithm. Returns: result

get_function_infoA

Get detailed information about a function. Pass a function name or hex address.

Inputs: identifier (required). Returns: result

get_global_variablesA

List named global data variables in the binary. Optionally filter by substring.

Inputs: filter. Returns: result

get_importsB

List all imported functions grouped by module.

Inputs: no named parameters. Returns: result

get_local_variablesA

Get all local variables and arguments of a decompiled function. Requires Hex-Rays. Pass function name or address.

Inputs: identifier (required). Returns: result

get_microcodeB

Get the Hex-Rays intermediate representation (microcode) for a function. Maturity levels: generated, preoptimized, locopt, calls, glbopt1, glbopt2, glbopt3, lvars.

Inputs: identifier (required), maturity. Returns: result

get_registersA

Read all CPU register values. Requires the debugger to be active and suspended.

Inputs: no named parameters. Returns: result

get_stack_frameA

Get the complete stack frame layout of a function — all stack variables, their offsets, sizes, and the overall frame geometry.

Inputs: identifier (required). Returns: result

get_stack_traceA

Get the current call stack trace. Requires active debugger.

Inputs: no named parameters. Returns: result

get_xrefs_fromA

Get all cross-references FROM an address (what does this location call/reference). Pass hex address or name.

Inputs: address (required). Returns: result

get_xrefs_toA

Get all cross-references TO an address (who calls/references this location). Pass hex address or name.

Inputs: address (required). Returns: result

list_bookmarksA

List all bookmarks in the IDA database.

Inputs: no named parameters. Returns: result

list_breakpointsC

List all currently set breakpoints with their status.

Inputs: no named parameters. Returns: result

list_debugger_threadsA

List all threads in the debugged process. Requires active debugger.

Inputs: no named parameters. Returns: result

list_enumsB

List all defined enumerations in the IDA database.

Inputs: no named parameters. Returns: result

list_flirt_signaturesA

List all FLIRT signatures currently applied to the database.

Inputs: no named parameters. Returns: result

list_functionsA

List all functions in the binary. Optionally pass a filter string to match function names (case-insensitive).

Inputs: filter. Returns: result

list_ida_actionsA

List all registered IDA UI actions that can be triggered with run_ida_action.

Inputs: no named parameters. Returns: result

list_segmentsB

List all segments (sections) in the binary with their permissions and sizes.

Inputs: no named parameters. Returns: result

list_stringsA

List all defined strings in the binary. Optionally filter by substring (case-insensitive).

Inputs: filter. Returns: result

list_structsA

List all defined structures/unions in the IDA database with their members.

Inputs: no named parameters. Returns: result

list_type_librariesB

List all loaded type information libraries (TILs) in the current database.

Inputs: no named parameters. Returns: result

load_type_libraryC

Load a type information library (.til) file into the current database.

Inputs: path (required). Returns: result

make_codeB

Convert bytes at an address into code (disassembled instruction). Optionally undefine 'size' bytes first.

Inputs: address (required), size. Returns: result

make_dataB

Convert bytes at an address into data. Types: byte, word, dword, qword, float, double.

Inputs: address (required), size, data_type. Returns: result

make_stringA

Define a C-style string at an address. Pass length=0 to auto-detect (null-terminated).

Inputs: address (required), length. Returns: result

patch_bytesB

Patch bytes at an address in the IDA database. Pass hex bytes with optional spaces (e.g. '90 90 90' for NOP sled, 'EB 05' for short jump).

Inputs: address (required), hex_bytes (required). Returns: result

pingA

Check connectivity to IDA Pro. Returns 'Connected' if the IDA plugin is running and reachable.

Inputs: no named parameters. Returns: result

produce_asmC

Produce a clean assembly listing for a function, suitable for copy-paste or file export.

Inputs: identifier (required). Returns: result

produce_cB

Produce clean C pseudocode for a function, suitable for copy-paste or file export. Requires Hex-Rays.

Inputs: identifier (required). Returns: result

read_debug_memoryA

Read memory from the debugged process. Requires active debugger. Returns hex dump.

Inputs: address (required), size. Returns: result

rename_addressC

Rename any address (global variable, label, etc). Pass hex address and new name.

Inputs: address (required), new_name (required). Returns: result

rename_functionA

Rename a function. Pass the current name or hex address, and the new name.

Inputs: new_name (required), identifier (required). Returns: result

rename_local_variableC

Rename a local variable or argument in a decompiled function. Requires Hex-Rays.

Inputs: new_name (required), old_name (required), function_identifier (required). Returns: result

run_ida_actionA

Trigger a registered IDA UI action by name (e.g. 'ToggleBnds', 'MakeCode'). Use list_ida_actions to see available actions.

Inputs: action_name (required). Returns: result

run_idc_scriptC

Execute IDC script code (IDA's native scripting language). Returns the evaluation result.

Inputs: code (required). Returns: result

save_databaseB

Save the IDA database. Pass a path to save to a specific location, or leave empty to save in-place.

Inputs: path. Returns: result

search_bytesA

Search for a byte pattern in the binary. Pass hex bytes with optional spaces (e.g. '90 90 90' or 'CC CC' or '48 8B 05').

Inputs: pattern (required), max_results. Returns: result

search_textA

Search through disassembly text for a string. Matches against instruction mnemonics, operands, and comments.

Inputs: query (required), max_results. Returns: result

set_breakpointA

Set a breakpoint at an address. Pass hex address or function name.

Inputs: address (required). Returns: result

set_colorA

Set the color of an instruction, function, or segment. Color is RGB as integer (e.g. 0xFF0000 for red, 0x00FF00 for green). item_type: instruction, function, segment.

Inputs: color (required), address (required), item_type. Returns: result

set_commentA

Set a comment at an address. Use is_repeatable=True for repeatable comments that propagate to xrefs.

Inputs: address (required), comment (required), is_repeatable. Returns: result

set_function_commentB

Set a function-level comment. These appear above (anterior) or below (posterior) the function header.

Inputs: comment (required), identifier (required), is_repeatable. Returns: result

set_function_typeA

Set a function's type/prototype. Pass function name or address, and C-style prototype (e.g. 'int __cdecl func(int a, char *b)').

Inputs: prototype (required), identifier (required). Returns: result

set_local_variable_typeC

Change the type of a local variable in a decompiled function. Requires Hex-Rays. Pass C-style type (e.g. 'SOCKET', 'struct sockaddr_in *').

Inputs: type_string (required), variable_name (required), function_identifier (required). Returns: result

set_operand_typeA

Change how an operand is displayed. operand_num: 0 for first, 1 for second. display_type: hex, decimal, octal, binary, char, default.

Inputs: address (required), operand_num (required), display_type (required). Returns: result

set_segment_permissionsB

Change the read/write/execute permissions of the segment containing the given address.

Inputs: address (required), read, write, execute. Returns: result

set_typeA

Set the type at an address. Pass hex address and C-style type declaration.

Inputs: address (required), type_str (required). Returns: result

start_debuggerB

Start the debugger for the currently loaded binary. Optionally pass command-line arguments and binary path.

Inputs: args, path. Returns: result

step_intoA

Step into the next instruction (follows calls into functions).

Inputs: no named parameters. Returns: result

step_overA

Step over the next instruction (executes calls without entering them).

Inputs: no named parameters. Returns: result

suspend_debuggerA

Suspend (pause) the running process.

Inputs: no named parameters. Returns: result

switch_threadA

Switch the debugger's active thread. Pass the thread ID from list_debugger_threads.

Inputs: tid (required). Returns: result

undefineC

Undefine (delete) items at an address, reverting them to raw bytes.

Inputs: address (required), size. Returns: result

undefine_functionC

Delete/undefine a function at an address. The code remains but is no longer treated as a function.

Inputs: address (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 87 tools

    Disambiguation2/5

    Multiple tool pairs overlap heavily: decompile_function vs produce_c, disassemble_function vs produce_asm, get_xrefs_to vs get_function_callers, and get_xrefs_from vs get_function_callees. Descriptions add nuance, but an agent could easily misselect without deep context, and type-setting/breakpoint tools further blur boundaries.

    Naming Consistency4/5

    Tool names overwhelmingly follow a consistent verb_noun snake_case pattern (get_*, list_*, set_*, create_*, delete_*), which is excellent across 87 tools. Minor deviations like ping, undefine, step_into, step_over, and navigate_to keep it from being a perfect 5.

    Tool Count1/5

    87 tools is far beyond the typical agent-facing MCP surface and includes redundant affordances such as decompile_function/produce_c and disassemble_function/produce_asm. Even for a comprehensive tool like IDA Pro, this should be consolidated or grouped into a smaller, more navigable set.

    Completeness4/5

    The server covers an impressively broad range of reverse-engineering workflows: static analysis, decompilation, debugging, patching, types, segments, bookmarks, scripting, and signatures. Minor gaps exist, such as no struct/enum deletion and no explicit comment deletion, but these are not critical given the overall depth.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      D
      maintenance
      Enables 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.
      56
      4
      MIT
    • A
      license
      Not graded
      quality
      F
      maintenance
      Enables 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.
      50
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI clients such as Claude, Cursor, Cline, and Codex to remotely drive IDA Pro over HTTP through 88 tools, covering Hex-Rays decompilation, disassembly, cross-reference tracing, type and struct reconstruction, C header import, memory reading and patching, and full dynamic debugging with breakpoints, registers, and stepping.
      MIT