# godot-mcp

> Bridge an AI agent and a live Godot editor over MCP — inspect, mutate, run, and verify a real project. 194 tools across 29 gated toolsets; the server owns safety and typing, the Godot addon owns the editor.

godot-mcp is a generic, game-agnostic MCP server: the FastMCP server owns safety and gating, the Godot addon owns editor API calls, and a versioned JSON envelope joins them. Start with concepts (how it works and why), then getting-started for setup. Every mutation result carries honesty fields (persisted/undoable/aborted_at/rescan_pending) that read as ground truth; errors are a stable enum with recovery hints. Each page below also serves a clean markdown variant at its URL with `.md` appended (e.g. `architecture/bridge.html.md`), plus `llms-full.txt` for the whole site in one fetch.

## Home
- [index](https://hybridindie.github.io/godot-mcp/): [markdown](https://hybridindie.github.io/godot-mcp/index.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/index.md)

## Get started
- [Get started](https://hybridindie.github.io/godot-mcp/getting-started.html): [markdown](https://hybridindie.github.io/godot-mcp/getting-started.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/getting-started.md)
- [Set up with your AI agent](https://hybridindie.github.io/godot-mcp/getting-started-with-an-agent.html): [markdown](https://hybridindie.github.io/godot-mcp/getting-started-with-an-agent.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/getting-started-with-an-agent.md)
- [Install the MCP server](https://hybridindie.github.io/godot-mcp/getting-started-install.html): [markdown](https://hybridindie.github.io/godot-mcp/getting-started-install.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/getting-started-install.md)
- [Install the Godot addon](https://hybridindie.github.io/godot-mcp/getting-started-addon.html): [markdown](https://hybridindie.github.io/godot-mcp/getting-started-addon.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/getting-started-addon.md)
- [Configure your MCP client](https://hybridindie.github.io/godot-mcp/getting-started-clients.html): [markdown](https://hybridindie.github.io/godot-mcp/getting-started-clients.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/getting-started-clients.md)
- [Your first session](https://hybridindie.github.io/godot-mcp/getting-started-first-session.html): [markdown](https://hybridindie.github.io/godot-mcp/getting-started-first-session.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/getting-started-first-session.md)
- [Remote & multi-client](https://hybridindie.github.io/godot-mcp/getting-started-openwebui.html): [markdown](https://hybridindie.github.io/godot-mcp/getting-started-openwebui.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/getting-started-openwebui.md)

## Guides
- [Guides](https://hybridindie.github.io/godot-mcp/guides.html): [markdown](https://hybridindie.github.io/godot-mcp/guides.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/guides.md)
- [Build a scene](https://hybridindie.github.io/godot-mcp/guides-build-scene.html): [markdown](https://hybridindie.github.io/godot-mcp/guides-build-scene.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/guides-build-scene.md)
- [Play-test & debug](https://hybridindie.github.io/godot-mcp/guides-playtest-debug.html): [markdown](https://hybridindie.github.io/godot-mcp/guides-playtest-debug.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/guides-playtest-debug.md)
- [Verify your work](https://hybridindie.github.io/godot-mcp/guides-verify.html): [markdown](https://hybridindie.github.io/godot-mcp/guides-verify.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/guides-verify.md)
- [Ship: export, tests & CI](https://hybridindie.github.io/godot-mcp/guides-ship.html): [markdown](https://hybridindie.github.io/godot-mcp/guides-ship.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/guides-ship.md)
- [Examples](https://hybridindie.github.io/godot-mcp/guides-examples.html): [markdown](https://hybridindie.github.io/godot-mcp/guides-examples.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/guides-examples.md)

## Concepts
- [Why & how it works](https://hybridindie.github.io/godot-mcp/concepts.html): [markdown](https://hybridindie.github.io/godot-mcp/concepts.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/concepts.md)

## Reference
- [Reference](https://hybridindie.github.io/godot-mcp/reference.html): [markdown](https://hybridindie.github.io/godot-mcp/reference.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/reference.md)
- [Toolsets & tools](https://hybridindie.github.io/godot-mcp/reference-toolsets.html): [markdown](https://hybridindie.github.io/godot-mcp/reference-toolsets.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/reference-toolsets.md)
- [Safety classes](https://hybridindie.github.io/godot-mcp/reference-safety-classes.html): [markdown](https://hybridindie.github.io/godot-mcp/reference-safety-classes.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/reference-safety-classes.md)
- [Value shapes](https://hybridindie.github.io/godot-mcp/reference-value-shapes.html): [markdown](https://hybridindie.github.io/godot-mcp/reference-value-shapes.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/reference-value-shapes.md)
- [Errors & recovery](https://hybridindie.github.io/godot-mcp/reference-errors.html): [markdown](https://hybridindie.github.io/godot-mcp/reference-errors.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/reference-errors.md)
- [Environment variables](https://hybridindie.github.io/godot-mcp/reference-env-vars.html): [markdown](https://hybridindie.github.io/godot-mcp/reference-env-vars.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/reference-env-vars.md)
- [Prompts & resources](https://hybridindie.github.io/godot-mcp/reference-prompts.html): [markdown](https://hybridindie.github.io/godot-mcp/reference-prompts.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/reference-prompts.md)
- [Skills](https://hybridindie.github.io/godot-mcp/reference-skills.html): [markdown](https://hybridindie.github.io/godot-mcp/reference-skills.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/reference-skills.md)
- [Consumer integration](https://hybridindie.github.io/godot-mcp/reference-consumers.html): [markdown](https://hybridindie.github.io/godot-mcp/reference-consumers.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/reference-consumers.md)

## Under the hood
- [Architecture](https://hybridindie.github.io/godot-mcp/architecture/): [markdown](https://hybridindie.github.io/godot-mcp/architecture/index.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/architecture/index.md)
- [The Godot addon](https://hybridindie.github.io/godot-mcp/architecture/addon.html): [markdown](https://hybridindie.github.io/godot-mcp/architecture/addon.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/architecture/addon.md)
- [Bridge & transport](https://hybridindie.github.io/godot-mcp/architecture/bridge.html): [markdown](https://hybridindie.github.io/godot-mcp/architecture/bridge.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/architecture/bridge.md)
- [The JSON envelope](https://hybridindie.github.io/godot-mcp/architecture/envelope.html): [markdown](https://hybridindie.github.io/godot-mcp/architecture/envelope.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/architecture/envelope.md)
- [Toolset gating](https://hybridindie.github.io/godot-mcp/architecture/gating.html): [markdown](https://hybridindie.github.io/godot-mcp/architecture/gating.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/architecture/gating.md)
- [The safety model](https://hybridindie.github.io/godot-mcp/architecture/safety.html): [markdown](https://hybridindie.github.io/godot-mcp/architecture/safety.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/architecture/safety.md)
- [Persistence truth](https://hybridindie.github.io/godot-mcp/architecture/persistence.html): [markdown](https://hybridindie.github.io/godot-mcp/architecture/persistence.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/architecture/persistence.md)
- [The readiness envelope](https://hybridindie.github.io/godot-mcp/architecture/readiness.html): [markdown](https://hybridindie.github.io/godot-mcp/architecture/readiness.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/architecture/readiness.md)

## Optional
- [Changelog](https://hybridindie.github.io/godot-mcp/changelog.html): release history — [markdown](https://hybridindie.github.io/godot-mcp/changelog.html.md) · [raw source](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/changelog.md)

## Optional

- [Tool contracts (source of truth)](https://github.com/hybridindie/godot-mcp/blob/main/docs/tool-contracts.md): per-tool result schemas
- [Raw markdown sources](https://raw.githubusercontent.com/hybridindie/godot-mcp/main/docs/site/): every page above, fetchable without the site