GameMaker MCP Server

Project-aware MCP server that gives AI coding agents structured, guarded access to GameMaker Studio projects.

Free· Free and open source (MIT license). Install via npm/npx.Agents

Best for

Solo GameMaker Studio developers and small game teams who want an AI agent (Claude, Cursor, Copilot, etc.) to safely read, analyze, patch, and build a .yyp project without ad-hoc shell access.

Skip if

Developers on non-GameMaker engines (Unity, Unreal, Godot), teams that need a hosted collaborative service, or anyone not already using an MCP-capable AI client.

GameMaker MCP Server is an open-source Model Context Protocol server that lets AI coding agents such as Claude Desktop, Cursor, Copilot, Codex, Cline, Gemini CLI, Windsurf, VS Code, Warp, and roughly twenty other MCP-capable clients work directly inside a GameMaker Studio project. It ships as a Node.js package (gamemaker-mcp on npm) and exposes about 190 typed tools, 20 reusable workflow prompts, and 6 project resources for parsing .yyp/.yy files, inspecting rooms/objects/sprites/sounds/shaders/timelines, running static analysis on GML, generating Feather JSDoc, previewing exact GML patches, writing files with SHA-256 optimistic concurrency plus backups, taking integrity-checked project snapshots, scaffolding finite state machines, particle systems, GUI layouts, inventory systems, and unit-test harnesses, and driving official Igor compile/package/run jobs synchronously or as tracked background jobs. A CLI installer (gamemaker-mcp install/doctor/connect) auto-detects installed GameMaker runtimes and Igor.exe, generates client configs, and can attach the server to every supported client in one command. Zero-config workspace auto-detect means opening any folder containing a .yyp file in a supported client is usually enough to bring the tools online. Safety is a first-class concern: file operations are sandboxed to the configured project root, symlinks/junctions are checked, there is a read-only default mode, an explicit workspace-write mode, an opt-in flag for Igor build operations, and per-file size limits. It is aimed at solo GameMaker developers and small studios who want to use an AI agent as a pair-programmer on GML code, room layouts, shaders, and build automation without giving the model unrestricted shell or filesystem access.

Editor's take

This is the most complete GameMaker-specific MCP server I've seen: guarded writes, snapshotting, a genuine static-analysis suite, and first-class Igor build integration make it feel closer to a proper IDE plugin than a hobby wrapper. If you already pair-program GML with Claude or Cursor, the one-line installer is a no-brainer; just leave it in read-only mode until you trust the diffs.

— The AI Tool Bible editorial team

Pros

✅ Very large surface area (~190 MCP tools) covering inspection, static analysis, guarded editing, room/object/shader ops, and Igor builds
✅ Safety-first design: project-root sandbox, SHA-256 optimistic concurrency, backups, read-only default, opt-in build mode
✅ One-line CLI installer and doctor that auto-configures ~20 MCP clients including Claude Desktop, Cursor, Copilot, and Windsurf
✅ Zero-config workspace auto-detect finds the .yyp file when a client opens the project folder
✅ Rich GameMaker-specific analyzers (health score, object hierarchy, dead code, i18n scan, draw-state audit, physics audit)
✅ Scaffold generators for FSM, particle systems, GUI, inventory, and a unit-test framework
✅ MIT-licensed, no telemetry, runs locally over stdio without opening any network port

Cons

⚠️ Windows-centric: Igor build/run flow and most auto-detect paths assume a Windows GameMaker Studio install
⚠️ Requires Node.js 20+ and comfort editing MCP client JSON if the installer does not support your client
⚠️ Only useful if you already own and use GameMaker Studio; the compile/package tools depend on a licensed IDE
⚠️ Young project on a fast-moving version cadence (1.x with frequent minor bumps), so tool signatures can shift
⚠️ No hosted UI or dashboard; all interaction happens through whichever MCP client you connect

Use cases

AI-assisted GML refactoringGameMaker project static analysisGuarded GML patch previewsFeather JSDoc generationRoom and object inspectionShader portability auditsIgor compile and package automationProject health scoringFinite state machine scaffoldingUnit test harness generation