Open Binary
open_binaryValidates and opens local binaries, executables, archives, or analysis databases for reverse engineering; supports explicit DOS COM and raw-binary interpretation when headers are absent.
Instructions
Open a local executable, application bundle, archive, JavaScript, source map, plist, or analysis database after validation. format=dos-com explicitly interprets 1..65280 headerless bytes as a DOS COM analysis image. format=raw-binary interprets headerless bytes with a required architecture and entry_point; file offset 0 maps at that address. Omission preserves header-based detection. provider_id selects one deep provider or deterministic auto selection; the binding remains stable until close or an explicit switch, with no failure fallback. Reopening the same target and profile retains its active database and metadata edits. An optional analysis snapshot is imported atomically and must match the binary identity, concrete provider, and canonical analysis profile exactly; importing into a session with metadata mutations requires closing and reopening it first.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "/tmp/fixture"
},
"name": "open_binary"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Absolute local filesystem path for the analysis target; relative paths are rejected. | |
| format | No | Explicit headerless interpretation: dos-com or raw-binary. Omission preserves header-based detection. | |
| provider | No | Alias for provider_id: selects one deep provider ('ghidra', 'hopper', 'ida-mcp', 'zero-install') or 'auto'. | |
| entry_point | No | Caller-supplied load and entry address (0xhex). File offset 0 is mapped here. Required with format=raw-binary; rejected otherwise. | |
| provider_id | No | Exact deep-analysis provider ID, or automatic selection when omitted. | |
| architecture | No | Caller-supplied CPU family. Required with format=raw-binary; rejected otherwise. | |
| snapshot_path | No | Absolute local filesystem path for the analysis snapshot; relative paths are rejected. |