# GodotBridge

> GodotBridge is a freemium MCP server for developer tools. Let an agent build, run and test Godot 4 projects in the real editor. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://godotbridge.com
- **Repository:** https://github.com/godotbridge/addon
- **MCP Registry name:** io.github.godotbridge/godotbridge
- **Categories:** developer tools, games and play
- **Listing updated:** 2026-11-14

## About

The server connects to a running Godot 4 editor and its game, so an agent edits the actual project instead of guessing from files. The sample prompt in the page has it add a node, set an input action, create a script, launch the scene and read errors.

It covers scenes and scripts, runtime control with input simulation and screenshots, animation and rigging, shaders, physics, navigation, terrain, particles and project health checks. An image studio for pixel-art sprites uses your own PixelLab API key, and an addon search installs from the Godot Asset Library.

The free Lite tier has 96 tools; the Full licence has 345 and is a one-time payment covering v1.x updates on three devices. A licence key is set as an environment variable or through a tool. It installs from PyPI.

## Features

- **Real editor control:** Inspect and change a live Godot 4 editor session.
- **Run and observe:** Launch the game, simulate input, read properties and capture screenshots.
- **Scene and script authoring:** Create nodes, scenes and GDScript.
- **Animation and shaders:** Rigging, blend trees, materials and shaders.
- **Addon install:** Search and install Asset Library addons.
- **Project health:** Find unused resources and circular dependencies.

## Good for

- Prototype a player controller by describing it
- Debug runtime errors in a running game
- Set up physics and navigation
- Install an addon without manual zipping

## Install

### Claude Code (Terminal)

```sh
claude mcp add godotbridge -- uvx godotbridge
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "godotbridge": {
      "command": "uvx",
      "args": [
        "godotbridge"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "godotbridge": {
      "command": "uvx",
      "args": [
        "godotbridge"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "godotbridge": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "godotbridge"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "godotbridge": {
      "command": "uvx",
      "args": [
        "godotbridge"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "godotbridge": {
      "command": "uvx",
      "args": [
        "godotbridge"
      ]
    }
  }
}
```

## Tools

- `add_node`: Adds a node to a scene under a given parent.
- `add_input_action`: Adds an input action with its keys.
- `create_script`: Creates a script file in the project.
- `game_launch_process`: Launches the game from a scene as a real process.
- `game_get_errors`: Returns structured errors from the running game.
- `activate_license`: Activates a Full licence key.

## FAQ

### Is there a free tier?

Yes. Lite is free forever with 96 tools.

### How is Full priced?

As a one-time payment covering v1.x updates on three devices; the price is not published here.

### Does Image Studio cost extra?

It uses your own PixelLab API key, with no added charge from GodotBridge.

### How many tools exist in total?

345 across 36 categories in the Full version.

### Is GodotBridge free?

GodotBridge has a free plan, with paid plans for more usage or features.

### How do I add GodotBridge to Claude Code?

Run this command in your terminal: claude mcp add godotbridge -- uvx godotbridge

### What are the best alternatives to GodotBridge?

The closest alternatives to GodotBridge are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/godotbridge
