mcp · tool profile

Gearboy

Game Boy / Game Boy Color / Super Game Boy emulator, debugger and embedded MCP server for macOS, Windows, Linux, BSD and RetroArch.

search CodexCursorGeneric

At a glance.

A compact read before the deeper capability notes and official setup links.

Core features.

Feature cards focus on what the tool helps users do, not generated setup commands.

Gearboy is an accurate, cross-platform Game Boy / Game Boy Color / Super Game Boy emulator written in C++ that runs on Windows, macOS, Linux, BSD and RetroArch, with an embedded MCP server for debugging and tooling.

Save states with preview and rewind support.

MCP server for AI-assisted debugging with GitHub Copilot, Claude, Codex and similar, exposing tools for execution control, memory inspection, hardware status, rewind and more.

Gearboy includes a Model Context Protocol (MCP) server that enables AI-assisted debugging through AI agents like GitHub Copilot, Claude, Codex and similar.

The server provides tools for execution control, memory inspection, breakpoints, disassembly, hardware status, and more.

Gearboy provides Agent Skills that teach AI assistants how to effectively use the emulator for specific tasks:

gearboy-debugging — Game debugging, code tracing, breakpoint management, hardware inspection, and reverse engineering.

gearboy-romhacking — Cheat creation, memory searching, ROM data modification, text translation, and game patching.

Agent / Skill / MCP / Workflow fit.

This panel keeps technical format separate from the user-facing AI category.

Tool type MCP

Use categories search

Works with Codex, Cursor, Generic

Official setup path.

Generated install snippets are intentionally not mirrored here because they drift. The page links to source-owned setup docs instead.

source Official source github GitHub docs Docs / README quickstart Quick start releases Releases

Evidence and adoption notes.

These notes help a user decide whether to investigate the official project further.

Source repository last pushed at 2026-05-17T21:56:21Z.

Generated from source metadata; confirm operational details in the official project before adopting it.

Review the upstream license, maintenance activity, and issue history before using it in production.

Trusted source

Trace the origin before adopting.

source https://github.com/drhelius/Gearboy