Rom Mcp

io.github.mrfentmenPublished by GitHub account mrfentmenv1.2.1Updated Oct 24, 2026

Search ROMs across Internet Archive, ROMsgames, CoolROM, and more. Verify checksums and parse saves.

VerifiedSTDIODesktop onlyWeb Search & ScrapingFiles & Storage

Overview

AI-generated overview

Local MCP server that lets an assistant search game ROM sites, verify ROM checksums, parse emulator saves, and download ROMs.

What you can do
  • Search ROMs by title across Internet Archive, ROMsgames, CoolROM, Arcade Punks, ROMsFun and Reddit r/Roms, or query one source at a time
  • Verify ROM integrity with MD5 and SHA1 checksums and identify an unknown game from its hash
  • Parse emulator save files to report playtime and progress
  • Scan a local directory to catalog ROM files and detect the console from filename or path
  • Get direct Internet Archive download links and download a ROM to a local folder
When to use it
Useful when you keep a retro game collection and want an assistant to find titles across several ROM sources, check whether files are intact or which game a hash belongs to, and summarize save-file progress.
Requirements
Runs as a local process via npx (Node.js required) over stdio; no accounts, API keys or environment variables are declared. Network access is needed for the ROM site searches and downloads, and local file access for verification, save parsing and collection scans.
Before you install
It scrapes third-party ROM sites and can download copyrighted game files to your machine, so legality depends on your jurisdiction and the titles involved. It reads local ROM and save files and writes downloaded files to a directory you choose; review what it fetches and where it saves before running it.

Installation

In SourceWeft

  1. Open Rom Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

ROM MCP

An MCP server for searching, verifying, and managing game ROM collections. Search Internet Archive, verify checksums against No-Intro and Redump databases, parse emulator save files, and download ROMs.

What it does

Search for ROMs across Internet Archive, ROMsgames.net, CoolROM, Arcade Punks, ROMsFun, and Reddit r/Roms. Verify ROM integrity using checksums. Identify unknown ROMs by hash. Parse save files to check playtime and progress. Scan entire collections and catalog everything.

Supported Sources

  • Internet Archive - Search via the IA API
  • ROMsgames.net - HTML scraping
  • CoolROM - HTML scraping
  • Arcade Punks - HTML scraping
  • ROMsFun - HTML scraping
  • Reddit r/Roms - Community discussions and recommendations

Tools

  • search_rom. Search Internet Archive for game ROMs by title or keyword.
  • search_all_sources. Search across all ROM sources (Internet Archive, ROMsgames, CoolROM, Arcade Punks, ROMsFun, Reddit r/Roms).
  • search_romsgames. Search ROMsgames.net for ROMs.
  • search_coolrom. Search CoolROM for ROMs.
  • search_arcadepunks. Search Arcade Punks for ROMs.
  • search_romsfun. Search ROMsFun for ROMs.
  • search_reddit_roms. Search Reddit r/Roms for community discussions and recommendations.
  • verify_rom. Compute MD5 and SHA1 checksums and verify against known databases.
  • match_by_checksum. Identify a game by providing its hash.
  • parse_save_file. Read emulator save files (.sav, .srm, .states).
  • scan_collection. Scan a directory and identify all ROM files.
  • get_download_link. Get direct download URL from Internet Archive.
  • download_rom. Download a ROM to a local directory.
  • detect_console. Detect the console from filename or path.

Install

bash
npx rom-mcp

Claude Desktop setup

Add this to your claude_desktop_config.json:

json
{  "mcpServers": {    "rom": {      "command": "npx",      "args": ["-y", "rom-mcp"]    }  }}

Example usage

Ask Claude:

"Search Internet Archive for Super Mario World ROMs"

"Verify this ROM file at ~/Downloads/game.sfc"

"What game is this? MD5: a1b2c3d4e5f6..."

"Scan my ROM collection at ~/ROMs and tell me what I have"

"Download the Sonic the Hedgehog ROM to my desktop"

"Parse this save file and tell me how much playtime I have"

Checksum verification

The server computes MD5 and SHA1 hashes of ROM files and checks them against known databases to verify integrity and identify games.

Save file support

Parses common emulator save formats including .srv, .srm, .sav, .states, and .ss files.

License

MIT

Source: README.md at commit de564b4

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

2
  1. v1.2.1LatestSep 22, 2026
  2. v1.2.0Sep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.