Skip to content
Agentmart
Submit a tool

Godot MCP

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

Connector by jxlee007 · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/jxlee007-godot-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
8 read · 10 write · 1 delete · 9 not yet classified
Secrets
None asked for
Install scripts
Not scanned yet
Runs as
Python package

Tools by what they do 28

Read from the source code; the running server may list different tools.

Read 8 · Look things up without changing anything.

  • calculate_blend_space_2d
  • export_mesh_library
  • get_debug_output
  • get_godot_version
  • get_project_info
  • get_uid
  • list_projects
  • quantize_animation_keyframes

Write 10 · Create, change, send or run things.

  • add_node
  • build_camera_switcher_timeline
  • compile_state_transitions
  • create_scene
  • run_headless_diagnostics
  • run_project
  • save_scene
  • set_animation_interpolation_mode
  • toggle_movie_maker
  • update_project_uids

Delete 1 · Delete, drop, revoke or wipe things.

  • stop_project

Not yet classified 9 · We could not tell from the name and description.

  • batch_shader_uniforms
  • generate_bezier_camera_path
  • generate_state_machine
  • generate_track_filter
  • inject_lookat_tracking
  • launch_editor
  • load_sprite
  • remap_texture_channels
  • stitch_animation_library

Files it touches

  • Any path the agent passes to its tools

Tools (28)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • add_node

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

  • batch_shader_uniforms

    Batch scans .tres ShaderMaterial files in a directory and overwrites shader_parameter/* values for global NPR look adjustments.

  • build_camera_switcher_timeline

    Synthesizes an Animation resource that toggles Camera3D.current across multiple cameras at defined cut timestamps for cinematic editing.

  • calculate_blend_space_2d

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

  • compile_state_transitions

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

  • create_scene

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

  • export_mesh_library

    Extracts 3D mesh instances from a scene and compiles them into a MeshLibrary (.res) resource for GridMap tiles.

  • generate_bezier_camera_path

    Generates a 3D Catmull-Rom bezier camera rail (Path3D, Curve3D, PathFollow3D) with adjustable speed-curve tension multiplier in a .tscn scene.

  • generate_state_machine

    Injects an AnimationNodeStateMachine sub-resource graph with layout coordinates and state nodes into a target .tscn scene file.

  • generate_track_filter

    Generates an AnimationNodeBlendFilter resource block and configuration code to isolate upper-body bones from locked lower-body bones.

  • get_debug_output

    Reads currently buffered stdout and stderr log lines from the active background Godot debug process.

  • get_godot_version

    Retrieves the installed Godot 4 engine version string by querying the local Godot binary.

  • get_project_info

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

  • get_uid

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

  • inject_lookat_tracking

    Generates and attaches a procedural slerp look-at tracking GDScript to a Camera3D node to follow target Node3D transforms.

Show 13 more tools
  • launch_editor

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

  • list_projects

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

  • load_sprite

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

  • quantize_animation_keyframes

    Parses raw keyframe times in a .tscn or .tres animation and quantizes them to discrete frame steps (e.g. 12-fps stepped anime look).

  • remap_texture_channels

    Rewires texture slot properties and manages ext_resource references in a .tres material file for hand-painted art workflows.

  • run_headless_diagnostics

    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.

  • run_project

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

  • save_scene

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

  • set_animation_interpolation_mode

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

  • stitch_animation_library

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

  • stop_project

    Terminates the actively running Godot debug process and returns its final flushed console output.

  • toggle_movie_maker

    Configures project.godot to toggle Godot Movie Maker mode, locking render time-steps for deterministic video and frame sequence capture.

  • update_project_uids

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

Signals

Stars
0
Forks
0
Open issues
0
Weekly downloads
46
Last commit
Sep 26, 2026 (1 month ago)
Last release
Sep 26, 2026 (1 month ago)
Last package publish
Sep 26, 2026 (1 month ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.jxlee007/godot-mcp
Version
1.0.4
Auth
No auth
Packages
pypi godot-mcp-uvx
License
MIT
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Cite this page

Godot MCP. Agent Mart. https://agentmart.dev/connectors/jxlee007-godot-mcp (last updated 2026-10-24)