Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Godot MCP

PYPI · GODOT-MCP-UVX

Pure-Python FastMCP server for Godot 4 — 28 headless & animation tools. Runs via uvx.

Available components

0 this week 74 Trust /100

Last scanned (11 hours ago)

Scores higher than 67% of PyPI servers

Category Entertainment and Games

Trust breakdown (7 categories)

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 Security50
  • Malware scan not yet available for this package.Unverified
  • 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 56 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 Management100
  • No destabilizing schema changes in the last 30 days.Pass
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
What we tested

Checks we ran (15)

  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Security disclosure
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Checks we could not complete (1)

These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.

  • Malware scan in Supply Chain SecurityMalware scan not yet available for this package.

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

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.

  • 21 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
  • 20 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 19 Nov 26 +1
    • Stability: 0.97 → pass security
  • 18 Nov 26 −1
    • Stability: pass → 0.97 functional
  • 12 Nov 26 +1
    • Stability: 0.97 → pass security
  • 11 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
  • 10 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.

  • 8 Nov 26 −2
    • Stability: pass → 0.87 functional
Diagnostics

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 21 Nov 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 Known build tool 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 →

MCP tools · 28 exposed · ~1,596 tokens

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 →

Tool Tokens
add_node ~74

Instantiates and appends a node of specified Godot class and property dictionary into an existing scene.

NameTypeReqDescription
node_namestringyes–
node_typestringyes–
parent_node_pathstring––
project_pathstringyes–
properties–––
scene_pathstringyes–
NameTypeReqDescription
resultstringyes–

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.

NameTypeReqDescription
directorystringyes–
dry_runboolean––
recursiveboolean––
uniform_overridesobjectyes–
NameTypeReqDescription
resultstringyes–

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.

NameTypeReqDescription
anim_player_nodestringyes–
animation_namestring––
scene_pathstringyes–
switchesarrayyes–
timeline_lengthnumber––
NameTypeReqDescription
resultstringyes–

No examples provided.

calculate_blend_space_2d ~87

Computes and injects an AnimationNodeBlendSpace2D sub-resource for directional movement blending based on 2D controller coordinates.

NameTypeReqDescription
anim_player_pathstring––
blend_pointsarrayyes–
node_namestringyes–
scene_pathstringyes–
x_labelstring––
y_labelstring––
NameTypeReqDescription
resultstringyes–

No examples provided.

compile_state_transitions ~60

Serializes and injects transition logic connections, advance conditions, and crossfade times into an existing AnimationNodeStateMachine block.

NameTypeReqDescription
scene_pathstringyes–
state_machine_resource_idstringyes–
transitionsarrayyes–
NameTypeReqDescription
resultstringyes–

No examples provided.

create_scene ~59

Creates a new Godot scene (.tscn) file with a validated root node type using the headless GDScript bridge.

NameTypeReqDescription
project_pathstringyes–
root_node_typestring––
scene_pathstringyes–
NameTypeReqDescription
resultstringyes–

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.

NameTypeReqDescription
mesh_item_names–––
output_pathstringyes–
project_pathstringyes–
scene_pathstringyes–
NameTypeReqDescription
resultstringyes–

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.

NameTypeReqDescription
add_cameraboolean––
add_path_followboolean––
path_node_namestringyes–
scene_pathstringyes–
tensionnumber––
waypointsarrayyes–
NameTypeReqDescription
resultstringyes–

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.

NameTypeReqDescription
anim_player_pathstring––
node_namestringyes–
scene_pathstringyes–
start_statestring––
statesarrayyes–
NameTypeReqDescription
resultstringyes–

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.

NameTypeReqDescription
blend_node_namestring––
locked_bone_pathsarrayyes–
scene_pathstringyes–
NameTypeReqDescription
resultstringyes–

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.

NameTypeReqDescription
resultstringyes–

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.

NameTypeReqDescription
resultstringyes–

No examples provided.

get_project_info ~40

Inspects project.godot and project tree to return metadata, asset counts, script inventory, and engine compatibility.

NameTypeReqDescription
project_pathstringyes–
NameTypeReqDescription
resultstringyes–

No examples provided.

get_uid ~47

Reads and returns the Godot 4.4+ unique resource identifier (UID) for a specified asset file.

NameTypeReqDescription
file_pathstringyes–
project_pathstringyes–
NameTypeReqDescription
resultstringyes–

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.

NameTypeReqDescription
camera_node_pathstringyes–
scene_pathstringyes–
script_output_pathstring––
target_node_pathstringyes–
NameTypeReqDescription
resultstringyes–

No examples provided.

launch_editor ~36

Spawns the Godot visual editor GUI as an independent desktop process anchored to the specified project directory.

NameTypeReqDescription
project_pathstringyes–
NameTypeReqDescription
resultstringyes–

No examples provided.

list_projects ~43

Discovers and lists Godot project directories containing a valid project.godot file within a target directory.

NameTypeReqDescription
directorystringyes–
recursiveboolean––
NameTypeReqDescription
resultstringyes–

No examples provided.

load_sprite ~63

Loads a texture resource and binds it to a 2D or 3D sprite node within a scene file.

NameTypeReqDescription
node_pathstringyes–
project_pathstringyes–
scene_pathstringyes–
texture_pathstringyes–
NameTypeReqDescription
resultstringyes–

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).

NameTypeReqDescription
animation_namestring––
file_pathstringyes–
target_fpsinteger––
NameTypeReqDescription
resultstringyes–

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.

NameTypeReqDescription
channel_mapobjectyes–
material_pathstringyes–
NameTypeReqDescription
resultstringyes–

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.

NameTypeReqDescription
checks–––
project_pathstringyes–
timeout_secondsinteger––
NameTypeReqDescription
resultstringyes–

No examples provided.

run_project ~43

Executes a Godot project in debug mode as a background process and captures runtime stdout/stderr streams.

NameTypeReqDescription
project_pathstringyes–
scenestring––
NameTypeReqDescription
resultstringyes–

No examples provided.

save_scene ~48

Persists scene modifications or creates a variant scene copy at a new relative path.

NameTypeReqDescription
new_pathstring––
project_pathstringyes–
scene_pathstringyes–
NameTypeReqDescription
resultstringyes–

No examples provided.

set_animation_interpolation_mode ~57

Bulk-edits animation track interpolation modes (nearest/constant, linear, cubic) in a scene or resource file.

NameTypeReqDescription
file_pathstringyes–
modestring––
track_indexinteger––
NameTypeReqDescription
resultstringyes–

No examples provided.

stitch_animation_library ~46

Compiles external animation clip files into a unified master AnimationLibrary (.tres) resource referencing named animations.

NameTypeReqDescription
clipsarrayyes–
output_res_pathstringyes–
NameTypeReqDescription
resultstringyes–

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.

NameTypeReqDescription
resultstringyes–

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.

NameTypeReqDescription
enableboolean––
fpsinteger––
output_filestring––
project_pathstringyes–
NameTypeReqDescription
resultstringyes–

No examples provided.

update_project_uids ~45

Recursively iterates all project scenes, scripts, and shaders to regenerate and update missing Godot 4.4+ UIDs.

NameTypeReqDescription
project_pathstringyes–
NameTypeReqDescription
resultstringyes–

No examples provided.

Install

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

# add to Claude Code
claude mcp add jxlee007-godot-mcp -- uvx godot-mcp-uvx
Common questions

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 74 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 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 21 November 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.

What did VerifyMCP test on the Godot MCP server?

VerifyMCP ran 15 checks on Godot MCP, covering Known CVEs, Install scripts, Dependency health, Source repository and 11 more. One item could not be completed, a gap on our side rather than a finding about Godot MCP: Malware scan. Endpoint Security and Transport & Reachability do not apply to a PyPI package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.