pod
Other formats agents might prefer:
markdownjsonllms.txt

Agent? You probably want markdown or json, or Pod over MCP.

Reported issues for godot-mcp

Pod holds 23 of 30 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to godot-mcp.

Most discussed

Delete .uid files

Hi, can i suggest a small behavior addition to delete_script tool? I have been using this MPC and noticed that the .uid files are not being deleted when the script is deleted, which is leaving orphaned .uid files in the project.

In my project, i added the code below to godot_mcp/tools/script_tools.gd::delete_script tool to adjust this behavior:

# =============================================================================
# delete_file
# ==========================================

[Read the thread](https://github.com/tomyud1/godot-mcp/issues/47) · 2026-05-02 · open · external user · 3 comments

### Feature: configurable timeout and port via environment variables

## Problem

1. The 30-second tool timeout (`DEFAULT_TIMEOUT` in `godot-bridge.ts`) is too short for some operations (e.g. `map_project` on large codebases). No way to override without editing source.
2. The WebSocket port (6505) is hardcoded. Multiple Godot instances or MCP sessions can't coexist.

## Proposed Fix

Two environment variables:
- **`GODOT_MCP_TIMEOUT_MS`** — override tool timeout (default: 30000)
- **`GODOT_MCP_PORT`** — override WebSocket port (default: 6505)

```typescript
const 

[Read the thread](https://github.com/tomyud1/godot-mcp/issues/20) · 2026-03-28 · closed · external user · 3 comments

### Feature: classdb_query tool — expose ClassDB to prevent API hallucination

## Problem

AI assistants frequently hallucinate non-existent Godot methods (e.g. using Godot 3 API in Godot 4 code, or inventing methods that don't exist). There's no way for the AI to verify that a class, method, or property exists before writing code that uses it.

## Proposed Tool

### `classdb_query`
- Input: `class_name` (required), `query` (optional: `"all"`, `"properties"`, `"methods"`, `"signals"`)
- Output: properties with types, methods with argument signatures and return types, signa

[Read the thread](https://github.com/tomyud1/godot-mcp/issues/19) · 2026-03-28 · closed · external user · 3 comments

### Feature: run_scene / stop_scene / is_playing tools

## Problem

There's no way for an AI agent to run a scene, check if it's running, or stop it. This means the edit→run→debug loop requires the user to manually press Play in the editor, breaking the autonomous workflow.

## Proposed Tools

### `run_scene`
- Defaults to main scene
- Accepts `scene: "current"` for the open scene, or a `res://` path for a specific scene
- Returns error if a scene is already running

### `stop_scene`
- Stops the currently running scene

### `is_playing`
- Returns `{ 

[Read the thread](https://github.com/tomyud1/godot-mcp/issues/18) · 2026-03-28 · closed · external user · 3 comments

### WebSocket server should bind to IPv4 (127.0.0.1) — fixes connection failures

## Problem

The WebSocket server in `godot-bridge.ts` creates a server without specifying a host:

```typescript
this.wss = new WebSocketServer({ port: this.port });

The ws library defaults to binding on :: (IPv6). Godot's WebSocketPeer connects to ws://127.0.0.1:6505 (IPv4). On systems where IPv6 dual-stack doesn't transparently bridge to IPv4, the connection silently fails — the plugin logs [MCP] Connecting to ws://127.0.0.1:6505... but never succeeds.

This is likely the root c

Read the thread · 2026-03-28 · closed · external user · 3 comments

Codex on Windows: Godot connects successfully, then MCP server shuts down and later tool calls fail with "Transport closed"

Summary

On Windows, godot-mcp-server starts successfully in Codex and the Godot plugin connects successfully, but the connection drops shortly after when Codex probes the server via /mcp. After that, any Godot MCP tool call from Codex fails with:

Transport closed

This appears to be a runtime compatibility / lifecycle issue rather than an installation or initial setup issue.

Environment

  • OS: Windows
  • MCP client: Codex CLI / Codex app
  • Codex version: 0.117.0
  • Model: `gpt-5.4

Read the thread · 2026-03-27 · closed · external user · 4 comments

Add screenshot support

Ability to render what the camera is seeing to a screenshot file for the agent to read. Either in editor, or running the game in development. Could allow agents to run the game and visualize what is happening, to inform decisions / fix bugs.

Read the thread · 2026-03-14 · closed · external user · 5 comments

Server never connecting (win11/linux/ godot 4.6.1 asset store version)

I did everything according to the instructions and plugin is stuck on mpc connecting, tried to do npm install and point to the absolute directory but got the same results, im using LMStudio with mcp.

Read the thread · 2026-03-14 · closed · external user · 8 comments

Most recent

Primary MCP server lingers as orphan after its only stdio client (single DSH) exits, breaking the next session

Summary

With a single MCP client (e.g. DeepSeek Harness DSH, or a lone Codex/Claude session), when the client exits, the PRIMARY \godot-mcp-server\ process does not exit (by design: \stdin close does NOT kill the server). It keeps listening on :6505/:6506 while Godot stays connected.

On the next launch, the freshly spawned server detects the lingering PRIMARY via the :6506 probe and enters PROXY mode against that orphan. If the orphan's stdio is gone but it still holds the

Read the thread · 2026-08-25 · closed · external user · 1 comment

run map_project cannot show visual

this is cursor tip:

" The injected JSON is corrupted (unescaped newlines appear). The HTML gets truncated by in the middle of