Godot MCP
PYPI · GODOT-MCP-UVX · SCANNED OCT 4
Pure-Python FastMCP server for Godot 4 — 28 headless & animation tools. Runs via uvx.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs hatchling.build at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
- 0 of 28 dependencies flagged as unhealthy. View diagnostics → Pass
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to jxlee007/godot_mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 7 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability53
- AI-judged instruction clarity (fair).Partial
- Tool/resource definitions use about 1596 tokens (~57/item across 28 items; 28 tools + 0 resources), lean.Pass
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management27
- Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage71
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 0% of tool parameters carry a description.Fail
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 3 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 28 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the Godot MCP server?
Godot MCP runs locally as a PyPI package, launched with uvx godot-mcp-uvx. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · godot-mcp-uvx
claude mcp add jxlee007-godot-mcp -- uvx godot-mcp-uvx
{
"mcpServers": {
"jxlee007-godot-mcp": {
"command": "uvx",
"args": [
"godot-mcp-uvx"
]
}
}
} {
"servers": {
"jxlee007-godot-mcp": {
"command": "uvx",
"args": [
"godot-mcp-uvx"
]
}
}
} codex mcp add jxlee007-godot-mcp -- uvx godot-mcp-uvx
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"jxlee007-godot-mcp": {
"type": "local",
"command": [
"uvx",
"godot-mcp-uvx"
],
"enabled": true
}
}
} openclaw mcp add jxlee007-godot-mcp --command uvx --arg godot-mcp-uvx
mcp_servers:
jxlee007-godot-mcp:
command: "uvx"
args: ["godot-mcp-uvx"] {
"McpServers": {
"jxlee007-godot-mcp": {
"Transport": "stdio",
"Command": "uvx",
"Arguments": [
"godot-mcp-uvx"
]
}
}
} assistant mcp add jxlee007-godot-mcp -t stdio -c uvx -a godot-mcp-uvx
{
"mcpServers": {
"jxlee007-godot-mcp": {
"command": "uvx",
"args": [
"godot-mcp-uvx"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 4 Oct 26 +3
- Stability: unverified → 0.27 ▲ functional
- 1 Oct 26 +15
- Malware scan: unverified → pass ▲ security
- 30 Sept 26 −15
- Malware scan: pass → unverified ▼ security
- 28 Sept 26 +11
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 26 Sept 26 64
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 4 Oct 2026 · Analysed pypi/godot-mcp-uvx@1.0.4
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | pypi |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | jxlee007/godot_mcp |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/jxlee007/godot_mcp/.github/workflows/publish.yml@refs/tags/v1.0.4 |
| Rekor log index | 2966372511 |
| Predicate type | PyPI publish attestation https://docs.pypi.org/attestations/publish/v1 |
| Subject digest | sha256:b2518020a2364621f56f7a801f48548e182b5c015512c6a1d82baa6e16c2bf4d |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | hatchling.build |
Background: Why install scripts are a supply-chain risk →
Dependencies 28 packages
| Packages resolved | 28 |
|---|---|
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
add_node ~74
Instantiates and appends a node of specified Godot class and property dictionary into an existing scene.
| Name | Type | Req | Description |
|---|---|---|---|
| node_name | string | yes | – |
| node_type | string | yes | – |
| parent_node_path | string | – | – |
| project_path | string | yes | – |
| properties | – | – | – |
| scene_path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
batch_shader_uniforms ~65
Batch scans .tres ShaderMaterial files in a directory and overwrites shader_parameter/* values for global NPR look adjustments.
| Name | Type | Req | Description |
|---|---|---|---|
| directory | string | yes | – |
| dry_run | boolean | – | – |
| recursive | boolean | – | – |
| uniform_overrides | object | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
build_camera_switcher_timeline ~76
Synthesizes an Animation resource that toggles Camera3D.current across multiple cameras at defined cut timestamps for cinematic editing.
| Name | Type | Req | Description |
|---|---|---|---|
| anim_player_node | string | yes | – |
| animation_name | string | – | – |
| scene_path | string | yes | – |
| switches | array | yes | – |
| timeline_length | number | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
calculate_blend_space_2d ~87
Computes and injects an AnimationNodeBlendSpace2D sub-resource for directional movement blending based on 2D controller coordinates.
| Name | Type | Req | Description |
|---|---|---|---|
| anim_player_path | string | – | – |
| blend_points | array | yes | – |
| node_name | string | yes | – |
| scene_path | string | yes | – |
| x_label | string | – | – |
| y_label | string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
compile_state_transitions ~60
Serializes and injects transition logic connections, advance conditions, and crossfade times into an existing AnimationNodeStateMachine block.
| Name | Type | Req | Description |
|---|---|---|---|
| scene_path | string | yes | – |
| state_machine_resource_id | string | yes | – |
| transitions | array | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
create_scene ~59
Creates a new Godot scene (.tscn) file with a validated root node type using the headless GDScript bridge.
| Name | Type | Req | Description |
|---|---|---|---|
| project_path | string | yes | – |
| root_node_type | string | – | – |
| scene_path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
export_mesh_library ~67
Extracts 3D mesh instances from a scene and compiles them into a MeshLibrary (.res) resource for GridMap tiles.
| Name | Type | Req | Description |
|---|---|---|---|
| mesh_item_names | – | – | – |
| output_path | string | yes | – |
| project_path | string | yes | – |
| scene_path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
generate_bezier_camera_path ~102
Generates a 3D Catmull-Rom bezier camera rail (Path3D, Curve3D, PathFollow3D) with adjustable speed-curve tension multiplier in a .tscn scene.
| Name | Type | Req | Description |
|---|---|---|---|
| add_camera | boolean | – | – |
| add_path_follow | boolean | – | – |
| path_node_name | string | yes | – |
| scene_path | string | yes | – |
| tension | number | – | – |
| waypoints | array | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
generate_state_machine ~74
Injects an AnimationNodeStateMachine sub-resource graph with layout coordinates and state nodes into a target .tscn scene file.
| Name | Type | Req | Description |
|---|---|---|---|
| anim_player_path | string | – | – |
| node_name | string | yes | – |
| scene_path | string | yes | – |
| start_state | string | – | – |
| states | array | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
generate_track_filter ~58
Generates an AnimationNodeBlendFilter resource block and configuration code to isolate upper-body bones from locked lower-body bones.
| Name | Type | Req | Description |
|---|---|---|---|
| blend_node_name | string | – | – |
| locked_bone_paths | array | yes | – |
| scene_path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
get_debug_output ~26
Reads currently buffered stdout and stderr log lines from the active background Godot debug process.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
get_godot_version ~29
Retrieves the installed Godot 4 engine version string by querying the local Godot binary.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
get_project_info ~40
Inspects project.godot and project tree to return metadata, asset counts, script inventory, and engine compatibility.
| Name | Type | Req | Description |
|---|---|---|---|
| project_path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
get_uid ~47
Reads and returns the Godot 4.4+ unique resource identifier (UID) for a specified asset file.
| Name | Type | Req | Description |
|---|---|---|---|
| file_path | string | yes | – |
| project_path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
inject_lookat_tracking ~74
Generates and attaches a procedural slerp look-at tracking GDScript to a Camera3D node to follow target Node3D transforms.
| Name | Type | Req | Description |
|---|---|---|---|
| camera_node_path | string | yes | – |
| scene_path | string | yes | – |
| script_output_path | string | – | – |
| target_node_path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
launch_editor ~36
Spawns the Godot visual editor GUI as an independent desktop process anchored to the specified project directory.
| Name | Type | Req | Description |
|---|---|---|---|
| project_path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
list_projects ~43
Discovers and lists Godot project directories containing a valid project.godot file within a target directory.
| Name | Type | Req | Description |
|---|---|---|---|
| directory | string | yes | – |
| recursive | boolean | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
load_sprite ~63
Loads a texture resource and binds it to a 2D or 3D sprite node within a scene file.
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
| project_path | string | yes | – |
| scene_path | string | yes | – |
| texture_path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
quantize_animation_keyframes ~71
Parses raw keyframe times in a .tscn or .tres animation and quantizes them to discrete frame steps (e.g. 12-fps stepped anime look).
| Name | Type | Req | Description |
|---|---|---|---|
| animation_name | string | – | – |
| file_path | string | yes | – |
| target_fps | integer | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
remap_texture_channels ~50
Rewires texture slot properties and manages ext_resource references in a .tres material file for hand-painted art workflows.
| Name | Type | Req | Description |
|---|---|---|---|
| channel_map | object | yes | – |
| material_path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
run_headless_diagnostics ~64
Executes automated project diagnostics by invoking an external system command (Godot CLI binary) to validate resource imports, check UID integrity, and detect broken shader entry points.
| Name | Type | Req | Description |
|---|---|---|---|
| checks | – | – | – |
| project_path | string | yes | – |
| timeout_seconds | integer | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
run_project ~43
Executes a Godot project in debug mode as a background process and captures runtime stdout/stderr streams.
| Name | Type | Req | Description |
|---|---|---|---|
| project_path | string | yes | – |
| scene | string | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
save_scene ~48
Persists scene modifications or creates a variant scene copy at a new relative path.
| Name | Type | Req | Description |
|---|---|---|---|
| new_path | string | – | – |
| project_path | string | yes | – |
| scene_path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
set_animation_interpolation_mode ~57
Bulk-edits animation track interpolation modes (nearest/constant, linear, cubic) in a scene or resource file.
| Name | Type | Req | Description |
|---|---|---|---|
| file_path | string | yes | – |
| mode | string | – | – |
| track_index | integer | – | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
stitch_animation_library ~46
Compiles external animation clip files into a unified master AnimationLibrary (.tres) resource referencing named animations.
| Name | Type | Req | Description |
|---|---|---|---|
| clips | array | yes | – |
| output_res_path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
stop_project ~25
Terminates the actively running Godot debug process and returns its final flushed console output.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
toggle_movie_maker ~67
Configures project.godot to toggle Godot Movie Maker mode, locking render time-steps for deterministic video and frame sequence capture.
| Name | Type | Req | Description |
|---|---|---|---|
| enable | boolean | – | – |
| fps | integer | – | – |
| output_file | string | – | – |
| project_path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
update_project_uids ~45
Recursively iterates all project scenes, scripts, and shaders to regenerate and update missing Godot 4.4+ UIDs.
| Name | Type | Req | Description |
|---|---|---|---|
| project_path | string | yes | – |
| Name | Type | Req | Description |
|---|---|---|---|
| result | string | yes | – |
No examples provided.
What is the Godot MCP server?
Godot MCP is listed in the public MCP registry as io.github.jxlee007/godot-mcp. Pure-Python FastMCP server for Godot 4, 28 headless & animation tools. Runs via uvx. This page covers its PyPI package (godot-mcp-uvx).
Is the Godot MCP server safe to use?
Godot MCP scores 78 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 4 October 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Godot MCP server expose?
Godot MCP exposes 28 tools: get_godot_version, launch_editor, run_project, get_debug_output, stop_project, and 23 more. Their descriptions and schemas cost roughly 1,596 tokens of context every time the server is loaded.
Is the Godot MCP server still maintained?
Godot MCP is still listed as active in the MCP registry. We last reached this channel on 4 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Godot MCP server under?
Godot MCP declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.