Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words Sign in

HexManiacAdvance (hma-mcp)

by dewaynekuversion 0.3.1i★ 0iRuns on your computerRepository ↗
Registry nameio.github.dewayneku/hma-mcp

How to install

What it does

Hack GBA Pokémon ROMs with HexManiacAdvance's engine: tables, maps, scripts, text, undo.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Travel, maps & weather

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score12/100

Quality: Passed 2/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Passed 2/3 checks · Runs on your computer

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

  1. Download the maker’s installer

    Download the maker’s .mcpb file

    The .mcpb file comes straight from the maker; we do not change it

  2. Double-click the file, then click Install in the Claude desktop app

  3. Try it

    Use HexManiacAdvance (hma-mcp) and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using HexManiacAdvance (hma-mcp) or shows a HexManiacAdvance (hma-mcp) tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect HexManiacAdvance (hma-mcp) yet

HexManiacAdvance (hma-mcp) runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect HexManiacAdvance (hma-mcp)

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

B · Others in Travel, maps & weather that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Claude Code cannot connect HexManiacAdvance (hma-mcp) yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect HexManiacAdvance (hma-mcp)

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Cursor cannot connect HexManiacAdvance (hma-mcp) yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect HexManiacAdvance (hma-mcp)

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

VS Code cannot connect HexManiacAdvance (hma-mcp) yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect HexManiacAdvance (hma-mcp)

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use HexManiacAdvance (hma-mcp)💬 Discussion →

At a glance

Downloads per weeki
Not on npm/PyPI
Licencei
No licence stated
Connection
Runs on your computer
Latest versioni
0.3.1
Published to registryi
Nov 15, 2026
Code last changedi
Nov 16, 2026
Maker
dewayneku
Packages
mcpb: …/hma-mcp-darwin.mcpb
mcpb: …/hma-mcp-linux.mcpb
mcpb: …/hma-mcp-win32.mcpb
Website
github.com
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 21, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account dewayneku, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 5 days ago

  • ! Caution

    Has a licence

    GitHub could not identify the licence type; open the file to check

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked: only npm and PyPI packages with a version can be checked

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/dewayneku-hma-mcp.svg)](https://mcp.popnx.com/en/servers/dewayneku-hma-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Travel, maps & weatheri

  • More stars than 0% of the other 2083 servers in this category
  • Published to the registry more recently than 83% of the other 2083 servers in this category
  • Basic checks equal to or better than 58% of the other 2083 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is HexManiacAdvance (hma-mcp) safe?

It passed 2 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 5 days ago, and the latest version (0.3.1) reached the registry 6 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need MCPB on your computer.

What can I use instead?

In the same category: Mu, Award Travel Finder, Killbottleneck, Gondola Award Travel Search, Whimsical

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

by microGrowing★ 441Updated 4 months ago

Runs in the cloud✓ micro.mu

Whimsical

Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.

by WhimsicalCodeEarly★ 11Updated 2 months ago

Runs in the cloud✓ service owner · whimsical.com
Compared with similar ones
This one
HexManiacAdvance (hma-mcp)
MuAward Travel FinderKillbottleneckGondola Award Travel SearchWhimsical
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoYesNoNo
Add with + in ClaudeNoNoNoNoNoYes
Basic checks2/34/43/33/34/44/4
LicenseNOASSERTIONAGPL-3.0MITMITMITMIT
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

An MCP server for GBA Pokémon ROM hacking.

Claude (or any MCP client) reads and edits your ROM through the engine behind HexManiacAdvance :

the same anchors, tables, script compiler and repointing, with every edit undoable and saves that open straight back up in HMA.

Quick start · Example · Tools · How it works · Contributing


Why

HMA already understands a ROM: it knows where the Pokémon stats table is, which bytes are a type, and how to recompile a script and move it if it grows. hma-mcp gives an AI assistant that same understanding, so you can describe a change in plain words and have it done correctly:

  • No GUI clicking. The assistant calls HMA's engine directly, without driving the HMA window.
  • Names, not bytes. Types, moves, species and items read and write as names (FIRE, THUNDERBOLT). A typo is rejected with suggestions instead of writing garbage.
  • Repointing handled. When a script or text grows, HMA's engine finds free space, moves it, and updates every pointer.
  • Safe by default. Nothing touches the disk until you say save, the first save backs up your original, and every edit is one undo away.

What it looks like

These are real results from a FireRed (U) 1.0 test run:

You: Open C:/hacks/firered.gba and show me Bulbasaur's base stats.

Claude: *(open_rom, read_table)* BULBASAUR: 45 HP / 49 Atk / 49 Def / 45 Spe / 65 SpA / 65 SpD, GRASS/POISON.

You: Make Charmander Fire/Dragon.

Claude: *(write_table_field)* CHARMANDER type2: FIRE → DRAGON. Not saved yet; say "undo" to revert.

You: Add a second chime to the Safari Zone time's-up script.

Claude: *(decompile_script, compile_script)* The script grew from 17 to 20 bytes and didn't fit, so HMA moved it from 1BFBC5 to free space at 71A280 and updated its 1 pointer. The anchor scripts.fromthumb.safari.end follows it.

You: Save.

Claude: *(save)* Saved firered.gba and firered.toml. Your original is backed up in .hma-mcp-backups/.

Quick start

You'll need a ROM you dumped yourself.

1. Get the server

Download the latest release. The builds are self-contained, so you don't need .NET installed.

You useDownload
Claude Desktopthe .mcpb for your system (win32, darwin for Apple Silicon Macs, linux), then double-click it
Anything elsehma-mcp- .zip / .tar.gz, unpacked somewhere permanent, e.g. %LOCALAPPDATA%\hma-mcp or ~/.local/share/hma-mcp

Keep the hma-mcp executable next to its resources/ folder. On macOS, a downloaded build is quarantined until you run xattr -dr com.apple.quarantine .

Or build it from source (needs the .NET 8 SDK )

git clone --recurse-submodules https://github.com/dewayneku/hma-mcp.git

cd hma-mcp dotnet publish src/HmaMcp -c Release -o ~/.local/share/hma-mcp

On Windows, -o %LOCALAPPDATA%\hma-mcp is a good spot, or run scripts/install.ps1, which also works while an MCP client is using the server. Publish outside the repo: an MCP client keeps the server running, and on Windows a running .exe can't be overwritten, so pointing a client at bin/ breaks your next build. To update, pull, close your MCP client (or start a new session), and run the same publish command again.

2. Connect your client

Claude Code:

claude mcp add --scope user hma -- "C:/Users/you/AppData/Local/hma-mcp/hma-mcp.exe"

--scope user makes it available in every project. Servers load when a session starts, so open a new one afterwards.

Claude Desktop (if you didn't use the .mcpb) and other MCP clients:

{

"mcpServers": { "hma": { "command": "C:/Users/you/AppData/Local/hma-mcp/hma-mcp.exe" } } }

ChatGPT and other clients that connect by URL

Some clients, like ChatGPT (Developer Mode), only connect to MCP servers on the internet over HTTPS. hma-mcp has an HTTP mode for them, plus a tunnel so the client can reach your PC:

hma-mcp --http --rom-dir "C:/hacks"
cloudflared tunnel --url http://127.0.0.1:3333

The server prints a URL with a secret token, like http://127.0.0.1:3333/mcp/3f9c.... Give your client the same path on the tunnel's address: https:// .trycloudflare.com/mcp/3f9c.... (ngrok and other tunnels work too.)

  • The token is the password. Requests without it get a 404. A new one is made each run; pass --token or set HMA_MCP_TOKEN to keep one. Clients that send headers can use Authorization: Bearer on /mcp instead.
  • `--rom-dir` is the only folder it can touch. ROMs, PNGs and saves must be inside it, and paths are shown relative to it.
  • It listens on 127.0.0.1 only. The tunnel is the only way in, and it lasts only while it's running. Stop it when you're done.

All tools work the same over HTTP. Clients that don't display images still get the text part of image tools. Tested with the included HTTP test client; ChatGPT's own setup steps change often, so check OpenAI's help center.

Then just ask, for example:

  • *"Open my ROM and list every table with 'items' in its name."*
  • *"Give Pikachu 90 base Sp. Atk and make it Electric/Steel."*
  • *"Decompile scripts.newgame.setflags and explain what it does."*
  • *"Show me Charmander's shiny sprite, then make its flame blue."*
  • *"Draw Pallet Town with its NPCs."*
  • *"Copy one of Pallet Town's houses into the empty space at the bottom, then widen Route 1 by two blocks."*
  • *"Make a new route east of Pallet Town that looks like Route 1."*
  • *"Import the ground and the dead trees from my tileset PNG into that route, then put a river and a grove on it."*
  • *"Find 512 bytes of free space."*

Tools

ToolWhat it does
📂open_rom · rom_info · close_romOpen a .gba, with HMA's .toml metadata if it's there
🔎list_anchorsSearch named anchors: data.pokemon.stats, scripts.…, graphics.…
🧭resolveAnchor or address → what's there: type of data, table row and field, pointer count
📋describe_table · read_tableTable layout, and rows as JSON: enums as names, flag sets as lists, packed fields as objects, learnsets and teams as text; filter rows with where (bank=3, map=19)
✏️write_table_fieldSet one field by row number or row name (CHARMANDER), checked against the field's size; also learnsets, TM lists, trainer teams
🗺️find_map · map_eventsFind a map by name (PALLET TOWN → 3.0), then list its NPCs, warps, trigger scripts, signs and connections, with addresses ready for write_table_field (to move or change one)
🖼️view_image · import_imageSee any sprite, tileset, tilemap or palette as an image (the assistant sees it too), save it as PNG, and import an edited PNG with HMA's palette fitting
🎨read_palette · write_paletteA palette's colors as #RRGGBB, and which graphics use it
🏞️render_mapA picture of a map, with NPCs and event markers
🧱read_map_blocks · paint_map_blocks · view_blocksetA map's blocks and movement permissions as hex grids; paint blocks (copy a building from one spot to another); see the tiles a map can use
🚪add_map_event · remove_map_event · resize_mapAdd or remove NPCs, warps, triggers and signs; grow or shrink a map (events and connections stay in place)
🆕create_map · connect_maps · disconnect_mapsNew maps modeled on an existing one (its tilesets, music, weather); join or separate neighboring maps, both sides at once
🕊️add_fly_spot · read_town_map · paint_town_mapMake a map a Fly destination; put it on the Town Map
🏷️list_region_names · add_region_nameRegion names (what a map shows on entry, on the Town Map, as a met location): which are free, and new names in free slots
🧍view_overworld_spritesA labeled sheet of NPC sprites, to pick one by number
🧩read_block · write_block · list_block_behaviors · view_tilesWhat a block is made of (8 tiles, 2 layers) and how it behaves (grass, water, door, ...); change either
🎨import_tilesetTurn a top-down PNG tileset (or several images) into a map's own tileset: ground blocks, and objects like trees and houses drawn over them with transparency; colors fitted to the GBA, duplicate and mirrored tiles shared
💬read_text · write_textGame text at an address (a script's message, say); longer text is moved and every pointer to it updated
📜decompile_script · compile_scriptEvent, battle, animation and trainer-AI scripts, with automatic repointing
⌨️hma_editType into HMA's hex view using its full edit language (^anchor, , "text")
🧱read_bytes · write_bytes · find_free_spaceRaw access, for when you need it
↩️undo · redoOne step per tool call, even when HMA records several internally
💾saveWrite the ROM and its .toml; the first save backs up the original
Games

HMA supports FireRed, LeafGreen, Emerald, Ruby and Sapphire, and hacks of them. FireRed (U) 1.0 is tested end to end with hma-mcp, and Emerald (U) passes a shorter check (tables, maps, scripts, text, save). Ruby, Sapphire and LeafGreen use the same engine but haven't been run through hma-mcp's tests yet. Reports are welcome.

How it works

flowchart LR

A["Claude / any MCP client"] <-- "MCP over stdio" --> B["hma-mcp (46 tools)"] B --> C["HexManiac.Core (HMA's engine, built from source)"] C <--> D[("your ROM .gba

  • HMA .toml metadata")]
  • HMA is a git submodule (external/HexManiacAdvance), and its core library is compiled from source by src/HexManiac.Core.Build, so the server runs exactly the editor's code.
  • ROMs open headlessly, the same way HMA's own test suite opens them.
  • compile_script follows HMA's code editor step for step: compile, move if it grew, update pointers, and keep any sub-scripts the edit left orphaned.
  • To move to a newer HMA, run git submodule update --remote external/HexManiacAdvance.

Problems found in HMA itself while building this, with fixes, are tracked in docs/hma-upstream-notes.md.

Testing

python tests/smoke.py <path-to-hma-mcp> [path/to/firered.gba]
  • With a ROM: copies it to a temp folder and edits only the copy. Checks reads, writes, enum validation, undo/redo, a script that has to move to free space, hma_edit, and a save → reopen round trip (written against FireRed (U) 1.0). tests/smoke_emerald.py runs a shorter version on Emerald (U).
  • Without a ROM: ch

Only the beginning is shown; read the rest in the repo