io.github.n24q02m/better-godot-mcp

NPM · @N24Q02M/BETTER-GODOT-MCP · 2 COMPONENTS · SCANNED AUG 3

Composite MCP server for Godot Engine -- 17 composite tools for AI-assisted game development.

Available components

npm · @n24q02m/better-godot-mcp 70 oci · docker.io/n24q02m/better-godot-mcp:latest 27

+51 this week 70 70 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 Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (132 of 136), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (132 of 136), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency71

Repository check failed: the declared repository URL redirects; it must resolve directly. See how to fix → View diagnostics → Fail
Cryptographically verified build provenance (signed, bound to n24q02m/better-godot-mcp). View diagnostics → Pass
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 15 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability56

AI-judged instruction clarity (good).Pass
Context-footprint check failed: tool/resource definitions use about 2668 tokens (~156/item across 17 items; 17 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
Usage-examples check failed: none of the tools include examples. See how to fix → Fail

Stability & Change Management23

Stability observed for 7 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
Structured output schemas are declared (94% of tools); any adoption earns full credit.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

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 · @n24q02m/better-godot-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add n24q02m-better-godot-mcp -- npx -y @n24q02m/better-godot-mcp

# add to Codex CLI

codex mcp add n24q02m-better-godot-mcp -- npx -y @n24q02m/better-godot-mcp

// opencode.json

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

# add to OpenClaw

openclaw mcp add n24q02m-better-godot-mcp --command npx --arg -y --arg @n24q02m/better-godot-mcp

# ~/.hermes/config.yaml

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

// mcp.json

{
  "mcpServers": {
    "n24q02m-better-godot-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@n24q02m/better-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.

2 Aug 26 +44
- Install scripts: unverified → pass ▲ security
- Provenance: unverified → pass ▲ security
- Known CVEs: unverified → partial ▲ security
- Malware scan: unverified → pass ▲ security
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- The attested source repository moved: n24q02m/better-godot-mcp security
- Tool coverage: 100 → unverified ▼ functional
- Capabilities: pass → unverified ▼ functional
- Security disclosure: fail → unverified ▼ functional
- Dependency health: unverified → partial ▲ functional
- Stability: unverified → 0.20 ▲ functional
- License: unverified → pass ▲ functional
- Maintenance: unverified → pass ▲ functional
- Licence: MIT functional
1 Aug 26 +26
- 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 −81
- Install scripts: pass → unverified ▼ security
- Provenance: pass → unverified ▼ security
- Known CVEs: partial → unverified ▼ security
- Malware scan: pass → unverified ▼ security
- The attested source repository moved: n24q02m/better-godot-mcp security
- License: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Dependency health: partial → unverified ▼ functional
- Maintenance: pass → unverified ▼ functional
- Security disclosure: fail → unverified ▼ functional
- Licence: MIT functional
29 Jul 26 +43
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Provenance: unverified → pass ▲ security
- The attested source repository moved: n24q02m/better-godot-mcp security
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- Schema quality: unverified → good ▲ functional
- Licence: MIT functional
28 Jul 26 +19
- Dependency health: partial → unverified ▼ functional
- Tool coverage: unverified → 100 ▲ functional
- First check of Tool coverage: 94 functional
- First check of Schema quality: fail functional
- First check of Schema quality: unverified functional
- First check of Tool coverage: 100 functional
- First check of Schema quality: fail functional
27 Jul 26 19

First indexed and scored.

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

Provenance verified

Ecosystem: npm · Outcome: verified

Reason: verified

Source repo:: n24q02m/better-godot-mcp
Certificate issuer:: https://token.actions.githubusercontent.com
Certificate SAN:: https://github.com/n24q02m/better-godot-mcp/.github/workflows/cd.yml@refs/heads/main
Rekor log index:: 2194263599
Predicate type:: https://slsa.dev/provenance/v1
Subject digest:: sha512:dac39182f4daa257f4e2a8833d5331fbfa0c564e91d706be5eb8999974cf6fc4994d987176e6a6a3645333dc8b748f051d229f4121c9ab2d3f2a207db
Discovery method:: attestation_endpoint

Dependencies 132 packages

132 packages in the resolved dependency tree · 131 deprecated · 49 stale.

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

MCP tools — 17 exposed · ~2,668 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

animation ~163

Animation management. Actions: create_player|add_animation|add_track|add_keyframe|list. Use help tool for full docs.

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
anim_name	string	—	Animation name
duration	number	—	Animation duration in seconds
loop	boolean	—	Whether animation loops
name	string	—	AnimationPlayer node name
node_path	string	—	Target node path for track
parent	string	—	Parent node path
project_path	string	—	Path to Godot project directory
property	string	—	Target property for track
scene_path	string	—	Path to scene file
track_type	string	—	Track type: value, method, bezier

Structured output declared, but exposes no named fields.

No examples provided.

audio ~170

Audio bus and stream management. Actions: list_buses|add_bus|add_effect|create_stream. Use help tool for full docs.

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
bus	string	—	Audio bus (default: Master)
bus_name	string	—	Audio bus name
effect_type	string	—	Effect type (for add_effect)
name	string	—	Stream player node name
parent	string	—	Parent node path
project_path	string	—	Path to Godot project directory
scene_path	string	—	Path to scene file (for create_stream)
send_to	string	—	Send bus target (default: Master)
stream_type	string	—	Stream type: 2D, 3D, or global

Structured output declared, but exposes no named fields.

No examples provided.

config ~91

Server configuration and environment. Actions (required params -> optional): - status: current config - set (key, value): update setting - detect_godot: find Godot binary path - check: verify project and Godot availability

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
key	string	—	Config key (for set)
value	string	—	Config value (for set)

Structured output declared, but exposes no named fields.

No examples provided.

editor ~79

Godot editor control. Actions (required params -> optional): - launch (-> project_path): open editor - status (-> project_path): check if editor is running For running the game, use project(action="run") instead.

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
project_path	string	—	Path to Godot project directory

Structured output declared, but exposes no named fields.

No examples provided.

help ~33

Full documentation for a tool. Use when compressed descriptions are insufficient.

Input Output Examples

Name	Type	Req	Description
tool_name	string	yes	Tool to get documentation for

No output schema declared.

No examples provided.

input_map ~190

Input action management. Actions (required params -> optional): - list (-> project_path): all input actions - add_action (action_name -> deadzone=0.5, project_path) - remove_action (action_name -> project_path) - add_event (action_name, event_type, event_value -> project_path) event_type: key | mouse | joypad. event_value: e.g., KEY_SPACE.

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
action_name	string	—	Input action name
deadzone	number	—	Deadzone value (for add_action, default: 0.5)
event_type	string	—	Event type: key, mouse, joypad (for add_event)
event_value	string	—	Event value, e.g., KEY_SPACE (for add_event)
project_path	string	—	Path to Godot project directory

Structured output declared, but exposes no named fields.

No examples provided.

navigation ~135

Navigation regions, agents, obstacles. Actions: create_region|add_agent|add_obstacle. Use help tool for full docs.

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
dimension	string	—	2D or 3D (default: 3D)
max_speed	number	—	Agent max speed
name	string	—	Node name
parent	string	—	Parent node path (default: .)
project_path	string	—	Path to Godot project directory
radius	number	—	Agent/obstacle radius
scene_path	string	—	Path to scene file

Structured output declared, but exposes no named fields.

No examples provided.

nodes ~263

Scene node operations. Actions (required params -> optional): - add (scene_path, name -> type="Node", parent=".", project_path) - remove (scene_path, name -> project_path) - rename (scene_path, name, new_name -> project_path) - list (scene_path -> project_path) - set_property (scene_path, name, property, value -> project_path) - get_property (scene_path, name, property -> project_path) Node paths: relative to scene root using "/" (e.g., "Player/Sprite2D"). Use "." for root.

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
name	string	—	Node name
new_name	string	—	New name (for rename)
parent	string	—	Parent node path relative to scene root (for add, default: "." = root). Use "/" separator, e.g., "Player/Sprite2D"
project_path	string	—	Path to Godot project directory
property	string	—	Property name (for get/set_property)
scene_path	string	—	Path to scene file
type	string	—	Node type (for add, default: Node)
value	string	—	Property value (for set_property)

Structured output declared, but exposes no named fields.

No examples provided.

physics ~160

Physics config. Actions: layers|collision_setup|body_config|set_layer_name. Use help tool for full docs.

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
collision_layer	number	—	Collision layer bitmask
collision_mask	number	—	Collision mask bitmask
dimension	string	—	2d or 3d (for set_layer_name)
gravity_scale	number	—	Gravity scale (for body_config)
layer_number	number	—	Layer number (for set_layer_name)
mass	number	—	Mass (for body_config)
name	string	—	Node name
project_path	string	—	Path to Godot project directory
scene_path	string	—	Path to scene file

Structured output declared, but exposes no named fields.

No examples provided.

project ~238

Godot project operations. Actions (required params -> optional): - info (-> project_path): project metadata - version: Godot engine version - run (-> scene_path, project_path): launch game - logs (-> pid): last captured stdout/stderr lines from a run (default: most recently started) - stop: stop running game - settings_get (key -> project_path): read project setting - settings_set (key, value -> project_path): write project setting - export (preset, output_path -> project_path): export game build

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
key	string	—	Settings key (for settings_get/set)
output_path	string	—	Export output path (for export)
pid	number	—	PID to read logs for (for logs; default: most recently started)
preset	string	—	Export preset name (for export)
project_path	string	—	Path to Godot project directory
scene_path	string	—	Path to a specific scene to run (optional)
value	string	—	Settings value (for settings_set)

Structured output declared, but exposes no named fields.

No examples provided.

resources ~140

Resource file management. Actions (required params -> optional): - list (-> type, project_path): browse resources (type: image|audio|font|shader|scene|resource) - info (resource_path -> project_path): resource metadata - delete (resource_path -> project_path) - import_config (resource_path -> project_path): view import settings

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
project_path	string	—	Path to Godot project directory
resource_path	string	—	Path to resource file
type	string	—	Filter by type: image, audio, font, shader, scene, resource (for list)

Structured output declared, but exposes no named fields.

No examples provided.

scenes ~222

Scene file (.tscn) CRUD. Actions (required params -> optional): - create (scene_path -> root_type="Node2D", root_name, project_path) - list (-> project_path) - info (scene_path -> project_path) - delete (scene_path -> project_path) - duplicate (scene_path, new_path -> project_path) - set_main (scene_path -> project_path) scene_path: relative to project root (e.g., "scenes/main.tscn"), NOT res:// prefix. Use nodes tool to edit nodes within a scene.

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
new_path	string	—	Destination path (for duplicate)
project_path	string	—	Path to Godot project directory
root_name	string	—	Root node name for create
root_type	string	—	Root node type for create (default: Node2D)
scene_path	string	—	Relative scene file path from project root (e.g., "scenes/main.tscn"), not res:// prefix

Structured output declared, but exposes no named fields.

No examples provided.

scripts ~209

GDScript file CRUD. Actions (required params -> optional): - create (script_path -> extends="Node", content, project_path): generate template - read (script_path -> project_path) - write (script_path, content -> project_path): replace entire file - attach (script_path, scene_path, node_name -> project_path): link to scene node - list (-> project_path) - delete (script_path -> project_path) script_path: relative to project root (e.g., "scripts/player.gd").

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
content	string	—	Script content (for create/write)
extends	string	—	Base class for create (default: Node)
node_name	string	—	Target node name (for attach)
project_path	string	—	Path to Godot project directory
scene_path	string	—	Scene file path (for attach)
script_path	string	—	Path to GDScript file

Structured output declared, but exposes no named fields.

No examples provided.

shader ~106

Godot shader management. Actions: create|read|write|get_params|list. Use help tool for full docs.

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
content	string	—	Shader content (for create/write)
project_path	string	—	Path to Godot project directory
shader_path	string	—	Path to .gdshader file
shader_type	string	—	Shader type: canvas_item, spatial, particles, sky, fog (for create)

Structured output declared, but exposes no named fields.

No examples provided.

signals ~151

Signal connection management. Actions (required params -> optional): - list (scene_path -> project_path): all signal connections - connect (scene_path, signal, from, to, method -> flags, project_path) - disconnect (scene_path, signal, from, to, method -> project_path)

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
flags	number	—	Connection flags
from	string	—	Source node path
method	string	—	Target method name
project_path	string	—	Path to Godot project directory
scene_path	string	—	Path to scene file
signal	string	—	Signal name
to	string	—	Target node path

Structured output declared, but exposes no named fields.

No examples provided.

tilemap ~141

TileSet and TileMap management. Actions: create_tileset|add_source|set_tile|paint|list. Use help tool for full docs.

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
project_path	string	—	Path to Godot project directory
scene_path	string	—	Path to scene file (for list, paint)
texture_path	string	—	Texture source path (for add_source)
tile_size	number	—	Tile size in pixels (default: 16, for create_tileset)
tileset_path	string	—	Path to TileSet .tres file (for create_tileset, add_source)

Structured output declared, but exposes no named fields.

No examples provided.

ui ~177

UI Control nodes and themes. Actions: create_control|set_theme|layout|list_controls. Use help tool for full docs.

Input Output Examples

Name	Type	Req	Description
action	string	yes	Action to perform
font_size	number	—	Default font size (for set_theme)
name	string	—	Control node name
parent	string	—	Parent node path (default: .)
preset	string	—	Layout preset: full_rect, center, top_wide, bottom_wide, left_wide, right_wide
project_path	string	—	Path to Godot project directory
scene_path	string	—	Path to scene file
theme_path	string	—	Path to theme .tres file (for set_theme)
type	string	—	Control type (e.g., Button, Label, HBoxContainer)

Structured output declared, but exposes no named fields.

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 3 Aug