Godot MCP

NPM · @TUGCANTOPALOGLU/GODOT-MCP · SCANNED AUG 7

MCP server for full Godot 4.x engine control with 165 tools for AI-driven game development

Available components

+40 this week 61 61 Trust /100

Trust breakdown (6 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 →

Supply Chain Security70

No malware found by supply-chain analysis.Pass
CVE check failed: a known high-severity CVE affects @modelcontextprotocol/sdk 0.6.0, a direct dependency. A fixed version is available. View diagnostics → Fail
No install/post-install scripts declared.Pass
Dependency health was assessed across the 47 of 48 dependencies we could resolve, so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 152 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability71

AI-judged instruction clarity (good).Pass
Tool/resource definitions use about 12471 tokens (~80/item across 154 items; 154 tools + 0 resources), lean.Pass
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management37

Stability observed for 11 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities20

Spec-recency check failed: implements MCP spec 2024-11-05; the latest is 2026-07-28. See how to fix → Fail

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @tugcantopaloglu/godot-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add tugcantopaloglu-godot-mcp -- npx -y @tugcantopaloglu/godot-mcp

# add to Codex CLI

codex mcp add tugcantopaloglu-godot-mcp -- npx -y @tugcantopaloglu/godot-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "tugcantopaloglu-godot-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@tugcantopaloglu/godot-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add tugcantopaloglu-godot-mcp --command npx --arg -y --arg @tugcantopaloglu/godot-mcp

# ~/.hermes/config.yaml

mcp_servers:
  tugcantopaloglu-godot-mcp:
    command: "npx"
    args: ["-y", "@tugcantopaloglu/godot-mcp"]

// mcp.json

{
  "mcpServers": {
    "tugcantopaloglu-godot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@tugcantopaloglu/godot-mcp"
      ]
    }
  }
}

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.

7 Aug 26 +1

No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.
5 Aug 26 +1
- Security disclosure: unverified → fail ▼ functional
4 Aug 26 +4
- Security disclosure: fail → unverified ▼ functional
- Stability: unverified → 0.27 ▲ functional
2 Aug 26 +50
- CVE-2025-66414 affects this package: high ▼ security
- Known CVEs: unverified → fail ▼ security
- Provenance: unverified → fail ▼ security
- Install scripts: unverified → pass ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
- MCP protocol: unverified → fail ▼ functional
- Tool coverage: unverified → 100 ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- Schema quality: unverified → good ▲ functional
- Licence: MIT functional
1 Aug 26 −16
- Tool coverage: 100 → unverified ▼ functional
31 Jul 26 +15
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −40
- Malware scan: pass → unverified ▼ security
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
27 Jul 26 46

First indexed and scored.

Show 5 earlier entries Hide earlier entries

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 7 Aug 2026 · Analysed npm/@tugcantopaloglu/[email protected]

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result	No attestation
Ecosystem	npm

Vulnerabilities 1 finding

ID	CVE	Severity	Vector	Fix available
GHSA-w48q-cv73-mx4w	CVE-2025-66414	high		yes

Dependencies 47 packages

Packages resolved	47
Deprecated	47
Stale	13
Tree resolution	Partial

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools · 154 exposed · ~12,471 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.

Tool Tokens

add_node ~121

Add a node to an existing scene

Input Output Examples

Name	Type	Req	Description
nodeName	string	yes	Name for the new node
nodeType	string	yes	Type of node to add (e.g., Sprite2D, CollisionShape2D)
parentNodePath	string	–	Path to the parent node (e.g., "root" or "root/Player")
projectPath	string	yes	Godot project path
properties	object	–	Optional properties to set on the node
scenePath	string	yes	Scene file path (relative to project)

No output schema declared.

No examples provided.

attach_script ~90

Attach a GDScript to a scene node (headless)

Input Output Examples

Name	Type	Req	Description
nodePath	string	yes	Path to the node within the scene (e.g., "root/Player")
projectPath	string	yes	Godot project path
scenePath	string	yes	Scene file path (relative to project)
scriptPath	string	yes	Path to the .gd script file (relative to project)

No output schema declared.

No examples provided.

create_directory ~43

Create a directory inside a Godot project

Input Output Examples

Name	Type	Req	Description
directoryPath	string	yes	Directory path relative to project root
projectPath	string	yes	Godot project path

No output schema declared.

No examples provided.

create_project ~44

Create a new Godot project from scratch

Input Output Examples

Name	Type	Req	Description
projectName	string	yes	Name of the project
projectPath	string	yes	Directory where the project will be created

No output schema declared.

No examples provided.

create_resource ~92

Create a .tres resource file (headless)

Input Output Examples

Name	Type	Req	Description
projectPath	string	yes	Godot project path
properties	object	–	Optional properties to set on the resource
resourcePath	string	yes	Where to save the .tres file (relative to project)
resourceType	string	yes	Godot class name (e.g., "StandardMaterial3D", "Theme", "Environment")

No output schema declared.

No examples provided.

create_scene ~73

Create a new Godot scene file

Input Output Examples

Name	Type	Req	Description
projectPath	string	yes	Godot project path
rootNodeType	string	–	Type of the root node (e.g., Node2D, Node3D)
scenePath	string	yes	Path where the scene file will be saved (relative to project)

No output schema declared.

No examples provided.

create_script ~97

Create a GDScript file from a template

Input Output Examples

Name	Type	Req	Description
className	string	–	Optional class_name
extends	string	–	Base class to extend. Default: Node
methods	array	–	Method stubs to include
projectPath	string	yes	Godot project path
scriptPath	string	yes	Script file path (relative to project)
source	string	–	Full source code (overrides template)

No output schema declared.

No examples provided.

delete_file ~43

Delete a file from a Godot project

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	File path relative to project root
projectPath	string	yes	Godot project path

No output schema declared.

No examples provided.

export_mesh_library ~90

Export a scene as a MeshLibrary resource

Input Output Examples

Name	Type	Req	Description
meshItemNames	array	–	Optional: Names of specific mesh items to include (defaults to all)
outputPath	string	yes	Path where the mesh library (.res) will be saved
projectPath	string	yes	Godot project path
scenePath	string	yes	Path to the scene file (.tscn) to export

No output schema declared.

No examples provided.

export_project ~69

Export a Godot project using a preset

Input Output Examples

Name	Type	Req	Description
debug	boolean	–	Use debug export. Default: false
outputPath	string	yes	Output file path for the exported build
presetName	string	yes	Export preset name
projectPath	string	yes	Godot project path

No output schema declared.

No examples provided.

game_3d_effects ~82

Create ReflectionProbe, Decal, or FogVolume

Input Output Examples

Name	Type	Req	Description
effectType	string	yes	Type: reflection_probe, decal, fog_volume
intensity	number	–	Effect intensity
name	string	–	Node name
parentPath	string	yes	Parent node path
size	object	–	Effect size {x,y,z}

No output schema declared.

No examples provided.

game_add_collision ~108

Add a collision shape to a physics body node

Input Output Examples

Name	Type	Req	Description
collisionLayer	number	–	Collision layer bitmask
collisionMask	number	–	Collision mask bitmask
disabled	boolean	–	Start disabled
parentPath	string	yes	Path to CollisionBody/Area node
shapeParams	object	–	Shape dimensions (e.g. {radius, height})
shapeType	string	yes	Shape: box, sphere/circle, capsule, cylinder, ray, segment

No output schema declared.

No examples provided.

game_animation_control ~83

AnimationPlayer seek/queue/speed/info control

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action: seek, queue, set_speed, get_info, stop
animationName	string	–	Animation name
nodePath	string	yes	Path to AnimationPlayer node
position	number	–	Seek position in seconds
speed	number	–	Playback speed scale

No output schema declared.

No examples provided.

game_animation_tree ~80

AnimationTree state machine travel and params

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action: travel, set_param, get_state, get_params
nodePath	string	yes	Path to AnimationTree node
paramName	string	–	Parameter name
paramValue	–	–	Parameter value
stateName	string	–	State name (for travel)

No output schema declared.

No examples provided.

game_audio_bus ~71

Set volume, mute, or solo on an audio bus

Input Output Examples

Name	Type	Req	Description
busName	string	–	Bus name. Default: "Master"
mute	boolean	–	Mute the bus
solo	boolean	–	Solo the bus
volume	number	–	Volume (linear 0-1)

No output schema declared.

No examples provided.

game_audio_bus_layout ~72

Create/remove/reorder audio buses and routing

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action: add, remove, move, set_send, list
busName	string	–	Bus name
index	number	–	Target index (for move)
sendTo	string	–	Send target bus name

No output schema declared.

No examples provided.

game_audio_effect ~90

Add/remove/configure audio bus effects

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action: add, remove, configure, list
busName	string	–	Audio bus name. Default: Master
effectType	string	–	Effect: reverb, delay, chorus, eq, compressor, limiter
index	number	–	Effect index
properties	object	–	Effect properties to set

No output schema declared.

No examples provided.

game_audio_play ~118

Play, stop, or pause an AudioStreamPlayer node

Input Output Examples

Name	Type	Req	Description
action	string	–	Action: play, stop, pause, resume
bus	string	–	Audio bus name
fromPosition	number	–	Start position in seconds
nodePath	string	yes	Path to AudioStreamPlayer/2D/3D node
pitch	number	–	Pitch scale
stream	string	–	Optional res:// path to load a new stream
volume	number	–	Volume (linear 0-1)

No output schema declared.

No examples provided.

game_audio_spatial ~101

Configure AudioStreamPlayer3D spatial properties

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action: configure, get_info
attenuationModel	string	–	Model: inverse, inverse_square, logarithmic
maxDb	number	–	Maximum volume in dB
maxDistance	number	–	Maximum audible distance
nodePath	string	yes	Path to AudioStreamPlayer3D
unitSize	number	–	Unit size for distance attenuation

No output schema declared.

No examples provided.

game_await_signal ~58

Await a signal with timeout and return args

Input Output Examples

Name	Type	Req	Description
nodePath	string	yes	Path to the node
signalName	string	yes	Signal name to await
timeout	number	–	Timeout in seconds. Default: 10

No output schema declared.

No examples provided.

game_bone_pose ~120

Get or set bone poses on a Skeleton3D node

Input Output Examples

Name	Type	Req	Description
action	string	–	Action: list, get, or set. Default: list
boneIndex	number	–	Bone index
boneName	string	–	Bone name (alternative to index)
nodePath	string	yes	Path to Skeleton3D node
position	object	–	Bone position {x,y,z}
rotation	object	–	Bone rotation quaternion {x,y,z,w}
scale	object	–	Bone scale {x,y,z}

No output schema declared.

No examples provided.

game_call_method ~62

Call a method on any node in the running game with optional arguments

Input Output Examples

Name	Type	Req	Description
args	array	–	Optional array of arguments to pass to the method
method	string	yes	Method name to call
nodePath	string	yes	Path to the node

No output schema declared.

No examples provided.

game_camera_attributes ~110

Configure DOF, exposure, auto-exposure on camera

Input Output Examples

Name	Type	Req	Description
action	string	–	Action: get or set
autoExposure	boolean	–	Enable auto exposure
autoExposureScale	number	–	Auto exposure scale
dofBlurAmount	number	–	DOF blur amount
dofBlurFar	number	–	DOF far blur distance
dofBlurNear	number	–	DOF near blur distance
exposureMultiplier	number	–	Exposure multiplier

No output schema declared.

No examples provided.

game_canvas ~93

Create/configure CanvasLayer and CanvasModulate

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action: create_layer, create_modulate, configure
color	object	–	Modulate color {r,g,b,a}
layer	number	–	Canvas layer number
name	string	–	Node name
nodePath	string	–	Node path (for configure)
parentPath	string	–	Parent node path

No output schema declared.

No examples provided.

game_canvas_draw ~182

2D drawing: line/rect/circle/polygon/text/clear

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action: line, rect, circle, polygon, text, clear
center	object	–	Center point {x,y}
color	object	–	Draw color {r,g,b,a}
filled	boolean	–	Fill shape. Default: true
from	object	–	Start point {x,y}
parentPath	string	–	Parent node path for draw node
points	array	–	Polygon points [{x,y},...]
radius	number	–	Circle radius
rect	object	–	Rectangle {x,y,w,h}
text	string	–	Text to draw
to	object	–	End point {x,y}
width	number	–	Line width. Default: 2

No output schema declared.

No examples provided.

game_change_scene ~50

Switch to a different scene file in the running game

Input Output Examples

Name	Type	Req	Description
scenePath	string	yes	Resource path to the scene (e.g., "res://scenes/levels/level2.tscn")

No output schema declared.

No examples provided.

game_click ~70

Click at a position in the running Godot game window

Input Output Examples

Name	Type	Req	Description
button	number	–	Mouse button (1=left, 2=right, 3=middle). Default: 1
x	number	yes	X coordinate to click
y	number	yes	Y coordinate to click

No output schema declared.

No examples provided.

game_connect_signal ~89

Connect a signal from one node to a method on another node in the running game

Input Output Examples

Name	Type	Req	Description
method	string	yes	Method name to call on the target node
nodePath	string	yes	Path to the source node that emits the signal
signalName	string	yes	Name of the signal to connect
targetPath	string	yes	Path to the target node that receives the signal

No output schema declared.

No examples provided.

game_create_animation ~109

Create an animation with tracks and keyframes

Input Output Examples

Name	Type	Req	Description
animationName	string	yes	Name for the new animation
length	number	–	Animation length in seconds. Default: 1.0
library	string	–	Animation library name. Default: ""
loopMode	number	–	0=none, 1=linear, 2=pingpong
nodePath	string	yes	Path to AnimationPlayer node
tracks	array	–	Array of track definitions

No output schema declared.

No examples provided.

game_create_joint ~162

Create a physics joint between two bodies

Input Output Examples

Name	Type	Req	Description
damping	number	–	Spring damping (spring_2d)
jointType	string	yes	Joint type: pin_2d, spring_2d, groove_2d, pin_3d, hinge_3d, cone_3d, slider_3d
length	number	–	Length (spring_2d, groove_2d)
nodeAPath	string	–	Path to first body
nodeBPath	string	–	Path to second body
parentPath	string	yes	Parent node path for the joint
softness	number	–	Softness (pin_2d)
stiffness	number	–	Spring stiffness (spring_2d)

No output schema declared.

No examples provided.

game_create_timer ~94

Create a Timer node with configuration

Input Output Examples

Name	Type	Req	Description
autostart	boolean	–	Auto-start the timer. Default: false
name	string	–	Optional timer node name
oneShot	boolean	–	One-shot mode. Default: false
parentPath	string	–	Parent node path. Default: "/root"
waitTime	number	–	Timer duration in seconds. Default: 1.0

No output schema declared.

No examples provided.

game_csg ~150

Create/configure CSG nodes with boolean operations

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action: create or configure
csgType	string	–	CSG type: box, sphere, cylinder, mesh, combiner
height	number	–	Height (cylinder)
material	string	–	Material resource path
name	string	–	Node name
nodePath	string	–	Node path (for configure)
operation	string	–	Boolean op: union, intersection, subtraction
parentPath	string	–	Parent node path
radius	number	–	Radius (sphere/cylinder)
size	object	–	Size {x,y,z} (box)

No output schema declared.

No examples provided.

game_debug_draw ~142

Draw debug lines, spheres, or boxes in 3D

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action: line, sphere, box, or clear
center	object	–	Sphere/box center {x,y,z}
color	object	–	Draw color {r,g,b,a}. Default: red
duration	number	–	Frames to persist (0=permanent)
from	object	–	Line start {x,y,z}
radius	number	–	Sphere radius. Default: 0.5
size	object	–	Box size {x,y,z}
to	object	–	Line end {x,y,z}

No output schema declared.

No examples provided.

game_disconnect_signal ~68

Disconnect a signal connection in the running game

Input Output Examples

Name	Type	Req	Description
method	string	yes	Method name on the target
nodePath	string	yes	Path to the source node
signalName	string	yes	Name of the signal
targetPath	string	yes	Path to the target node

No output schema declared.

No examples provided.

game_emit_signal ~64

Emit a signal on a node in the running game, optionally with arguments

Input Output Examples

Name	Type	Req	Description
args	array	–	Optional arguments to pass with the signal
nodePath	string	yes	Path to the node
signalName	string	yes	Name of the signal to emit

No output schema declared.

No examples provided.

game_environment ~278

Get or set environment and post-processing settings

Input Output Examples

Name	Type	Req	Description
action	string	–	Action: get or set. Default: set
ambientLightColor	object	–	Ambient light color {r,g,b,a}
ambientLightEnergy	number	–	Ambient light energy
backgroundColor	object	–	Background color {r,g,b,a}
backgroundMode	number	–	0=clear, 1=custom_color, 2=sky, 3=canvas
brightness	number	–	Brightness adjustment
contrast	number	–	Contrast adjustment
fogDensity	number	–	Fog density
fogEnabled	boolean	–	Enable fog
fogLightColor	object	–	Fog light color {r,g,b,a}
glowBloom	number	–	Glow bloom
glowEnabled	boolean	–	Enable glow
glowIntensity	number	–	Glow intensity
saturation	number	–	Saturation adjustment
ssaoEnabled	boolean	–	Enable SSAO
ssaoIntensity	number	–	SSAO intensity
ssaoRadius	number	–	SSAO radius
ssrEnabled	boolean	–	Enable SSR
tonemapMode	number	–	0=linear, 1=reinhardt, 2=filmic, 3=aces

No output schema declared.

No examples provided.

game_eval ~45

Execute GDScript in the running game. Use "return" for values.

Input Output Examples

Name	Type	Req	Description
code	string	yes	GDScript code to execute. Use "return" to return values.

No output schema declared.

No examples provided.

game_find_nodes_by_class ~71

Find all nodes of a specific class type in the running game

Input Output Examples

Name	Type	Req	Description
className	string	yes	Class name to search for (e.g., "CharacterBody3D", "Light3D")
rootPath	string	–	Root node path to start searching from. Default: "/root"

No output schema declared.

No examples provided.

game_gamepad ~85

Send gamepad button or axis input event

Input Output Examples

Name	Type	Req	Description
device	number	–	Gamepad device index. Default: 0
index	number	yes	Button or axis index
type	string	yes	"button" or "axis"
value	number	yes	Value: 0/1 for buttons, -1.0 to 1.0 for axes

No output schema declared.

No examples provided.

game_get_audio ~17

Get audio bus layout and playing streams

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

game_get_camera ~19

Get active camera position, rotation, and size

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

game_get_errors ~21

Get new push_error/push_warning messages since last call

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

game_get_logs ~21

Get new print output from the running game since last call

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

game_get_node_info ~44

Get node info: class, properties, signals, methods, children

Input Output Examples

Name	Type	Req	Description
nodePath	string	yes	Path to the node (e.g., "/root/Player")

No output schema declared.

No examples provided.

game_get_nodes_in_group ~47

Get all nodes belonging to a specific group in the running game

Input Output Examples

Name	Type	Req	Description
group	string	yes	Group name (e.g., "enemies", "player", "checkpoints")

No output schema declared.

No examples provided.

game_get_property ~73

Get a property value from any node in the running game by its path

Input Output Examples

Name	Type	Req	Description
nodePath	string	yes	Path to the node (e.g., "/root/Player", "/root/Main/Enemy")
property	string	yes	Property name to get (e.g., "position", "health", "visible")

No output schema declared.

No examples provided.

game_get_scene_tree ~19

Get scene tree structure of the running game

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

game_get_ui ~18

Get visible UI elements from the running game

Input Output Examples

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

game_gi ~72

Create/configure VoxelGI or LightmapGI

Input Output Examples

Name	Type	Req	Description
giType	string	yes	Type: voxel_gi or lightmap_gi
name	string	–	Node name
parentPath	string	yes	Parent node path
size	object	–	Extents size {x,y,z}

No output schema declared.

No examples provided.

game_gridmap ~104

GridMap set/get/clear cells and query used cells

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action: set_cell, get_cell, clear, get_used
item	number	–	MeshLibrary item index
nodePath	string	yes	Path to GridMap node
orientation	number	–	Cell orientation index
x	number	–	Cell X coordinate
y	number	–	Cell Y coordinate
z	number	–	Cell Z coordinate

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 7 Aug

Day	Score
27 Jul	46
28 Jul	46
30 Jul	6
31 Jul	21
1 Aug	5
2 Aug	55
3 Aug	55
4 Aug	59
5 Aug	60
6 Aug	60
7 Aug	61