AtariHackerMCP MCP Server

Tools one might need to hack 8-bit Atari code (.atr files), including hex dump, disassembler, symbol tables, etc.

Local serverstdio

What is the AtariHackerMCP MCP Server?

Tools one might need to hack 8-bit Atari code (.atr files), including hex dump, disassembler, symbol tables, etc.

What you get

A local MCP server for reverse-engineering Atari 8-bit binaries and ATR disk images. Supports multi-pass disassembly analysis, code/data separation, segment-aware output, ATR file injection, batch scripting, and a comprehensive Atari hardware symbol table.

Configuration and credentials

  • .NET SDK 10.0+ - Linux, macOS, or Windows

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
load_romLoad a ROM/XEX binary into the current session
rom_infoDisplay structural info about the loaded binary
atr_infoDisplay structural info about an ATR disk image
atr_headerDisplay the ATR header fields for a disk image
load_atr_fileExtract a file from an ATR and load it into the session
load_atr_bootExtract boot sectors from an ATR and load them at $0700
list_atr_directoryList the DOS directory of an ATR disk image
analyze_boot_sectorDecode the boot sector header from an ATR
sector_dumpHex dump sectors from an ATR by logical sector number
search_boot_sectorScan boot sectors across multiple ATRs for patterns/differences
extract_atr_fileExtract a file from an ATR and save it to disk
inject_atr_fileInject a file into an ATR (copy-on-write)
create_atrCreate a new ATR disk image from scratch
write_atr_sectorWrite raw data to a specific sector of an ATR
write_atr_fileWrite a file to an ATR with directory entry creation
define_filesystemDefine a custom filesystem layout for non-DOS ATRs
hex_dumpProduce a hex dump with file offsets, memory addresses, and ASCII
disassembleDisassemble 6502 code with optional multi-pass analysis (analyze=true)
analyze_disassemblyMulti-pass analysis building a reference graph and identifying code/data regions
Formatssummary, graph, labels, full
define_segmentDefine a memory segment by type (code, data, graphics, text, zero_page)
remove_segmentRemove a defined segment by name
list_segmentsList all defined memory segments (shows gaps)
clear_segmentsClear all defined segments
generate_linker_configGenerate a cc65 linker configuration from current segments
x_refFind cross-references to an address in the ROM
find_patternSearch for a byte pattern with wildcards
find_stringsSearch for runs of printable ASCII or ATASCII characters
trace_control_flowStatically trace execution from a starting address
probe_dataAnalyze a memory range to identify data type (text, graphics, table, charset, display list, sprite data, map data) with confidence scoring
generate_callgraphGenerate a call graph showing subroutine relationships (Mermaid or text format)
analyze_coverageAnalyze code coverage: which bytes are executed vs. data
diff_romsCompare two ROM or ATR files (summary, verbose, or hex diff format)
define_symbolAdd or update a named label for a memory address
remove_symbolRemove a user-defined symbol
lookup_symbolLook up the symbol entry for an address
list_symbolsList symbols in the symbol table
set_symbolsEnable/disable symbol groups (hardware, OS variables, OS ROM, user labels) to control which names appear in disassembly
load_labelsLoad labels and segments from a sidecar file
save_labelsSave current labels and segments to a sidecar file
annotate_zero_pageAdd or update a zero-page annotation
show_zero_page_mapDisplay current zero-page annotations
run_scriptExecute a sequence of commands from a script file (supports 33 commands)
calculateEvaluate mathematical expressions with hex literals ($ prefix)
hex_to_decimalConvert hex to decimal
decimal_to_hexConvert decimal to hex

How to install the AtariHackerMCP MCP Server

{
  "mcpServers": {
    "atari-hacker": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "/absolute/path/to/AtariHackerMCP/AtariHackerMCP.csproj",
        "--no-build"
      ]
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • .NET SDK 10.0+ - Linux, macOS, or Windows

Example prompts to try

  • “Use AtariHackerMCP to load rom.”
  • “Use AtariHackerMCP to rom info.”
  • “Use AtariHackerMCP to atr info.”

Frequently asked questions

Tools one might need to hack 8-bit Atari code (.atr files), including hex dump, disassembler, symbol tables, etc. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.