Godot Forge MCP Server

The MCP server for Godot 4. Test runner, API docs, script analysis, and more. AI coding assistants are structurally bad at GDScript. Models trained on data skewed towards Godot 3 hallucinate deprecated APIs (yield instead of await, KinematicBody instead of CharacterBody3D, export var instead of @export var). Godot Forge fixes this. Its 8 documented tools cover godot, analyze, project.

People connecting documentation tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-04-26 · ★ 8 · #117 OF 183 MAINTAINED DOCUMENTATION · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Godot Forge

before you install - you'll need

GODOT_PATH

Environment variables documented in the project's README - it lists which are required and which have defaults.

Claude Code

claude mcp add gregario-godot-forge -- npx -y godot-forge

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "gregario-godot-forge": {
      "command": "npx",
      "args": [
        "-y",
        "godot-forge"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package godot-forge - unscoped; check the name against the project README before installing

registry namespace io.github.gregario is GitHub-verified and matches the repo owner

03 · What Godot Forge can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can detect 10 GDScript pitfalls (deprecated API, coupling, re-entrancy), parse .tscn/.tres, detect antipatterns and format errors, and capture viewport screenshot as base64 PNG.

The 8 tools it gives your agent

Extracted from the project's README - what Godot Forge lets an agent do.

godot_run_tests: - Run GUT/GdUnit4 tests, get structured pass/fail results
godot_search_docs: - Search Godot 4 API docs with 3→4 migration mapping
godot_analyze_script: - Detect 10 GDScript pitfalls (deprecated API, coupling, re-entrancy)
godot_analyze_scene: - Parse .tscn/.tres, detect antipatterns and format errors
godot_get_project_info: - Project structure overview with progressive disclosure
godot_get_diagnostics: - LSP diagnostics from Godot's language server
godot_run_project: - Launch/stop project, capture debug output
godot_screenshot: - Capture viewport screenshot as base64 PNG

Latest releases

v0.1.2 · 2026-03-13

Initial public release. · 8 tools for Godot 4 development: · godot_run_tests - GUT/GdUnit4 test runner with structured results · godot_search_docs - API docs with 30+ Godot 3→4 migration mappings · godot_analyze_script…

04 · Who maintains Godot Forge

Godot Forge is maintained by gregario. We track 12 MCP servers from gregario - 12 actively maintained, 41 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from gregario.

05 · Facts

repository: github.com/gregario/godot-forge
category: documentation - ranked #117 of 183 actively-maintained documentation servers as of 2026-08-25.
registry: io.github.gregario/godot-forge (active, first published 2026-03-13)
packages: npm:godot-forge

06 · Godot Forge FAQ

Is Godot Forge still maintained?

Yes - as of 2026-08-25, its last commit was 2026-04-26. We re-verify nightly.

What can Godot Forge do?

How do I install Godot Forge?

Run `npx -y godot-forge`. The README documents one environment variable (GODOT_PATH) to set first. You can also paste the ready-made client config above.

Does Godot Forge run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Godot Forge

Alternatives to Godot Forge

Maintained documentation servers if Godot Forge isn't the fit.

Pairs well with

Servers that cover what Godot Forge doesn't - only shown when the pairing reason fits the companion.

More documentation MCP servers · Docs Mint · Hormonaly Clinical Intelligence · Rails Agent Skills · Workfile · Memograph

More TypeScript MCP servers · Lego Oracle · Lorcana Oracle · Mtg Oracle · Onepiece Oracle · Warhammer Oracle · see all