MCP ServerSTDIOOfficialv1.0.4

GB Studio MCP Server

Create and modify Game Boy Studio projects programmatically through MCP tools for scenes, actors, assets, and validation. For developers building GB Studio games who want Claude to help design levels, manage sprites, and validate project structure.

io.github.eoinjordan/gbstudio-claude-mcp

Hosted URL

Local install

Transport

STDIO

Auth

No auth required

What the GB Studio MCP server does

How models use it and what it is built for.

Create and modify Game Boy Studio projects programmatically through MCP tools for scenes, actors, assets, and validation. For developers building GB Studio games who want Claude to help design levels, manage sprites, and validate project structure.

Connect to GB Studio

Local install — runs as a subprocess.

npx gbstudio-claude-mcp@1.0.4

Environment variables

Configuration this server reads at startup.

  • CLAUDE_API_KEYSecret

    Optional Claude API key used by /claude-key endpoints.

Resources

Where to find authoritative docs and source for GB Studio.

Example prompts for GB Studio

Paste any of these into Agent Studio after connecting GB Studio.

  • Add a new scene to my GB Studio project with a 10x10 tilemap
  • Create an actor sprite at position 5,8 in the current scene
  • Validate my GB Studio project structure and report any errors
  • List all assets currently in my project and their types

GB Studio MCP server — FAQ

Common questions about connecting and running GB Studio.

  • What is GB Studio and why would I use this MCP server with it?

    GB Studio is a visual game creation tool for Game Boy games. This MCP server lets Claude programmatically create and modify GB Studio projects—scenes, actors, and assets—so you can design levels and manage game structure through conversation instead of the UI.

  • Do I need a Claude API key to use this server?

    The CLAUDE_API_KEY environment variable is optional and used only by specific /claude-key endpoints. Basic scene, actor, and asset operations work without it, but check the server documentation for which features require authentication.

  • How do I install and run the gbstudio-claude-mcp server?

    Run `npx gbstudio-claude-mcp@1.0.4` to install and start the server. It communicates via stdio, so configure your Claude client (or MCP host) to spawn this process and pipe commands to it.

  • Can this server validate my GB Studio project for errors?

    Yes—the server includes validation tools to check your project structure. You can ask Claude to validate your project and report issues, though specific validation rules depend on the GB Studio version and schema the server supports.

  • What happens if I try to modify a scene or actor that doesn't exist?

    The server will likely return an error or validation failure. Always validate your project structure first, or use the server's tools to list existing scenes and actors before attempting modifications.

Skip the local setup — run MCP in your browser

MCP Playground runs 10,000+ hosted MCP servers — GitHub, Linear, Notion, Stripe, Sentry and more — across Claude, GPT, Gemini, DeepSeek and 60+ AI models. Compare model answers side-by-side, save agent presets, share runs. Zero install.

Open Agent Studio

Related servers

More on MCP Playground