Gearlynx is an Atari Lynx emulator and debugger by Drhelius, built primarily with C++ and C. It functions as an embedded Model Context Protocol (MCP) server, enabling AI-assisted debugging and development for the Atari Lynx platform. Available as standalone binaries for Windows, macOS, Linux, and BSD, a RetroArch/Libretro core, and an MCPB package for Claude Desktop, it supports portable mode. Its design targets AI agents and developers, offering deep inspection and control over Atari Lynx hardware.

What does Gearlynx connect to?

Gearlynx functions as an Atari Lynx emulator and debugger, embedding a Model Context Protocol (MCP) server. Its primary connection targets are AI agents and assistants, including GitHub Copilot, Claude, and Codex. It supports STDIO and HTTP as transport protocols, with STDIO being the preferred method for communication. This server design enables remote control and data exchange for AI-driven analysis of the Atari Lynx system.

Core features and tools

The MCP server exposes callable tools for deep debugging and execution control. These include 6502 CPU debugging, breakpoint management, and hardware inspection for Mikey and Suzy registers. It also offers disassembly analysis, execution tracing, memory read/write, and screenshot capture. Tools like debug_get_status, get_tool_info, and execute_tool are used, with get_suzy_registers as an example of a routed call through the MCP router.

Who is it for?

Gearlynx's MCP server functionality is for AI agents and assistants such as GitHub Copilot, Claude, and Codex. It also serves Atari Lynx game developers, homebrew developers, and reverse engineers. It provides specialized tools for intricate tasks involving hardware and software interaction on the Lynx platform, supporting advanced development and analysis. This is not the right fit if you are solely looking for a basic Atari Lynx player without debugging or development needs.

How to get started

The server authenticates using an API key passed as an environment variable. For HTTP transport on non-loopback addresses, the GEARLYNX_MCP_HTTP_TOKEN environment variable must be set, and the server will not start without it.

Use cases

• AI-assisted game debugging, code tracing, and breakpoint management to inspect CPU registers, hardware state, and step through code.
• ROM hacking, including cheat creation, memory searching, ROM data modification, and game patching.
• Detailed hardware inspection and analysis, such as examining Mikey/Suzy registers and diagnosing rendering, audio, or timing issues.

Gearlynx delivers a powerful Atari Lynx emulation and debugging environment tailored for AI integration and advanced development. Its MCP server provides fine-grained control and data access, essential for complex tasks like ROM hacking and hardware analysis. Developers and AI agents can benefit from its specialized toolset for detailed system interaction.