Godot Agent Mcp

Godot Agent MCP

A Godot MCP (Model Context Protocol) server that enables AI assistants like Claude, Cursor, and Zed to interact with Godot Engine through standardized tools and commands.

Overview

This plugin transforms your Godot editor into an MCP server, allowing AI coding assistants to:

• Create and manipulate scene nodes
• Inspect and modify project structure
• Execute Godot-specific operations remotely

The server implements the [MCP specification](https://modelcontextprotocol.io/introduction) and provides a robust foundation for building AI-assisted Godot development workflows.

Notably, the MCP runs _in_ Godot, which reduces installation complexity and improves maintainability.

Features

• MCP-compliant HTTP server - Runs on localhost:8080
• Schema validation - Uses Zodot for type-safe parameter validation
• Extensible tool system - Easy to add new tools and capabilities
• JSON-RPC 2.0 support - Standard protocol implementation
• CORS protection - Restricted to localhost connections

Installation

Prerequisites

• Godot 4.x
• Git (for cloning the repository)

Setup

1. **Clone the repository into your Godot project:**

   cd your-godot-project
   git clone https://github.com/toasted-iron-studios/godot-agent-mcp.git
   # Or add as submodule
   git submodule add https://github.com/toasted-iron-studios/godot-agent-mcp.git addons/godot_agent_mcp

2. **Enable the plugin:**

   • Open your project in Godot
   • Go to Project → Project Settings → Plugins
   • Find "Godot Agent MCP" and enable it
   • The server will automatically start on port 8080

3. **Verify installation:**

   • Check the Output panel for "Godot Agent MCP plugin started"
   • The server should be accessible at http://127.0.0.1:8080

Usage

With AI Assistants

Configure your AI assistant to use the MCP server:

**For Cursor/VSCode:**

Copy-pasta the sample MCP config in the repo: mcp.json.sample

Available Tools

`create