GodotBridge
PYPI · GODOTBRIDGE
Lets AI agents build, run and test Godot 4 projects in the real editor. Free Lite tier.
Available components
Last scanned (20 hours ago)
Scores higher than 48% of PyPI servers
Category Developer Tools
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 30 dependencies flagged as unhealthy. View diagnostics → Pass
Provenance & Transparency32
- 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
- License check failed: the license (Proprietary) isn't a recognized OSI-approved license. See how to fix → Fail
- Actively maintained (last published 10 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability54
- AI-judged instruction clarity (fair).Partial
- Tool/resource definitions use about 16077 tokens (~46/item across 345 items; 345 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 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 (0% of tools); any adoption earns full credit.Pass
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 12 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "disconnect_signal" implies "remove" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
- An AI judge read all 345 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
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 →
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 +16
- Malware scan: unverified → pass ▲ security
- 19 Nov 26 −15
- Malware scan: pass → unverified ▼ security
- 18 Nov 26 +4
- Stability: unverified → 0.27 ▲ functional
- 14 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 13 Nov 26 −15
- Malware scan: pass → unverified ▼ security
- 12 Nov 26 +15
- Malware scan: unverified → pass ▲ security
- 11 Nov 26 +5
- Source repository: unverified → pass ▲ security
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/godotbridge@1.0.4
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | pypi |
| Reason | No attestation published |
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 30 packages
| Packages resolved | 30 |
|---|---|
| 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 →
find_nodes ~38
Searches the currently open scene by node class and/or a case-insensitive name glob pattern.
| Name | Type | Req | Description |
|---|---|---|---|
| class_name | – | – | – |
| name_pattern | – | – | – |
No output schema declared.
No examples provided.
find_unused_resources ~46
Heuristically locates resource files nothing else references and that aren't an entry point (main scene or an autoload). A lead list to review, not a guaranteed-safe deletion list.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
game_assert_property ~44
[Full] Validates a running node's property against an expected value.
| Name | Type | Req | Description |
|---|---|---|---|
| expected | – | yes | – |
| node_path | string | yes | – |
| property | string | yes | – |
No output schema declared.
No examples provided.
game_call_method ~41
[Full] Invokes a method on a running node.
| Name | Type | Req | Description |
|---|---|---|---|
| args | – | – | – |
| method | string | yes | – |
| node_path | string | yes | – |
No output schema declared.
No examples provided.
game_capture_gif ~95
[Full] Captures viewport frames over a duration at a fixed interval. Despite the name (kept for catalog parity with the tool it's modeled on), returns a frames_png_base64 array of individual PNG frames rather than a single encoded animated .gif file — Godot has no built-in GIF encoder. Same rendering-backend requirement as game_screenshot.
| Name | Type | Req | Description |
|---|---|---|---|
| duration | number | – | – |
| interval | number | – | – |
No output schema declared.
No examples provided.
game_click_ui ~39
[Full] Simulates clicking the first UI element (by visible text) that has a "pressed" signal.
| Name | Type | Req | Description |
|---|---|---|---|
| text | string | yes | – |
No output schema declared.
No examples provided.
game_describe_screen ~26
[Full] Provides a structured description of the running scene's visible UI layout.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
game_find_ui ~45
[Full] Locates Control nodes in the running scene, optionally filtered by visible text and/or class.
| Name | Type | Req | Description |
|---|---|---|---|
| class_name | string | – | – |
| text | string | – | – |
No output schema declared.
No examples provided.
game_get_collision_report ~53
[Full] Reports physics contacts for an Area2D/Area3D (overlap queries), or a body with contact_monitor enabled (get_colliding_bodies()).
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
No output schema declared.
No examples provided.
game_get_errors ~47
[Full] Returns buffered stderr (errors/warnings) from a game_launch_process-launched game. Requires the game to have been started via game_launch_process, not play_scene/play_project.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
game_get_node_properties ~36
[Full] Queries live node property values in the running game.
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
| properties | – | – | – |
No output schema declared.
No examples provided.
game_get_output ~47
[Full] Returns buffered stdout (print() output) from a game_launch_process-launched game. Requires the game to have been started via game_launch_process, not play_scene/play_project.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
game_get_performance ~27
[Full] Retrieves FPS, memory, and node/object counts from the running game.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
game_get_scene_tree ~51
[Full] Accesses the live running game's node hierarchy. Relayed to the mcp_runtime_probe.gd autoload inside the playing game; fails with NO_GAME_RUNNING if no game is currently running.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
game_launch_process ~132
[Full] Launches the game as a standalone OS subprocess this server owns directly (using the godot_executable/project_path reported by get_project_info), instead of going through the editor's Play action. This is what makes game_get_output/game_get_errors possible — the editor-Play path never exposes the played game's console output to GDScript. An alternative to play_scene/play_project, not a complement: don't run both against the same project at once. Every other game_* tool still works unchanged against a game launched this way.
| Name | Type | Req | Description |
|---|---|---|---|
| headless | boolean | – | – |
| scene_path | string | – | – |
No output schema declared.
No examples provided.
game_monitor_property ~58
[Full] Samples a node property at a fixed interval over a duration and returns the time series.
| Name | Type | Req | Description |
|---|---|---|---|
| duration | number | – | – |
| interval | number | – | – |
| node_path | string | yes | – |
| property | string | yes | – |
No output schema declared.
No examples provided.
game_raycast_3d ~55
[Full] Casts a physics ray in 3D space and reports the first hit, if any.
| Name | Type | Req | Description |
|---|---|---|---|
| collision_mask | – | – | – |
| from_ | object | yes | – |
| to | object | yes | – |
No output schema declared.
No examples provided.
game_reload_scene ~19
[Full] Restarts the current running scene.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
game_replay_input ~35
[Full] Replays a previously recorded input sequence (or the last recording if events is omitted).
| Name | Type | Req | Description |
|---|---|---|---|
| events | – | – | – |
No output schema declared.
No examples provided.
game_screenshot ~53
[Full] Captures the running game's viewport as a base64-encoded PNG. Requires a real rendering backend — fails with INTERNAL_ERROR under a headless/dummy display driver, which has no framebuffer to read back.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
game_set_debug_draw ~34
Set the debug draw mode on a viewport (wireframe, overdraw, etc.).
| Name | Type | Req | Description |
|---|---|---|---|
| mode | string | – | – |
No output schema declared.
No examples provided.
game_set_node_property ~40
[Full] Modifies a running game property.
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
| property | string | yes | – |
| value | – | yes | – |
No output schema declared.
No examples provided.
game_set_paused ~30
[Full] Toggles the running game's scene tree pause state.
| Name | Type | Req | Description |
|---|---|---|---|
| paused | boolean | – | – |
No output schema declared.
No examples provided.
game_set_time_scale ~29
[Full] Adjusts the running game's engine speed.
| Name | Type | Req | Description |
|---|---|---|---|
| time_scale | number | – | – |
No output schema declared.
No examples provided.
game_simulate_input ~104
[Full] Triggers a single synthesized input event via Input.parse_input_event (or Input.action_press/release for named actions). `type` is one of "action", "key", "mouse_button", "mouse_motion".
| Name | Type | Req | Description |
|---|---|---|---|
| action | – | – | – |
| button_index | – | – | – |
| keycode | – | – | – |
| position | – | – | – |
| pressed | boolean | – | – |
| relative | – | – | – |
| strength | number | – | – |
| type | string | yes | – |
No output schema declared.
No examples provided.
game_simulate_sequence ~49
[Full] Executes a timed sequence of input events. Each step is {delay: seconds_before_this_step, input: <game_simulate_input params>}.
| Name | Type | Req | Description |
|---|---|---|---|
| steps | array | yes | – |
No output schema declared.
No examples provided.
game_start_input_recording ~20
[Full] Starts capturing player input events.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
game_stop_input_recording ~30
[Full] Stops capturing and returns the recorded events, replayable via game_replay_input.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
game_stop_process ~25
[Full] Stops the game subprocess started by game_launch_process, if any.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
game_wait_for_node ~52
[Full] Waits, across real engine frames (non-blocking), for a node to appear in the running game's current scene.
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
| timeout | number | – | – |
No output schema declared.
No examples provided.
get_agent_content_info ~24
Return information about the MCP agent (version, capabilities, tool count).
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_animation_info ~41
[Full] Retrieves an animation's length, loop mode, and track count.
| Name | Type | Req | Description |
|---|---|---|---|
| animation_name | string | yes | – |
| node_path | string | yes | – |
No output schema declared.
No examples provided.
get_animation_tree_info ~33
[Full] Retrieves an AnimationTree's state machine structure (state names).
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
No output schema declared.
No examples provided.
get_audio_buses ~30
[Full] Lists every audio bus with its volume, mute/solo state, and effect count.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_audio_info ~37
[Full] Audits an audio player node's bus, volume, stream, and playback state.
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
No output schema declared.
No examples provided.
get_bridge_status ~31
Returns the status of the GodotBridge MCP connection including Godot version, project name, and connection uptime.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_collision_info ~33
[Full] Queries a collision object's layer/mask/material/shape-count configuration.
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
No output schema declared.
No examples provided.
get_curve_info ~32
[Full] Get info about a Curve resource (point count, points data).
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | – |
No output schema declared.
No examples provided.
get_debugger_errors ~58
Returns errors/warnings logged by the most recently played game (via play_scene/play_project or game_launch_process), read from the project's shared debug log file and filtered to ERROR:/WARNING:/SCRIPT ERROR: entries plus their backtrace/context lines.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_editor_errors ~60
Get ALL log lines from the editor log file (unfiltered). Unlike get_debugger_errors which filters to ERROR:/WARNING:/SCRIPT ERROR: entries, this returns every line, giving a complete picture of editor output.
| Name | Type | Req | Description |
|---|---|---|---|
| max_lines | integer | – | – |
No output schema declared.
No examples provided.
get_editor_log ~113
Returns the last N lines from the project's shared debug log file (same file get_debugger_errors reads). Despite the name, this is not a log of the editor's own activity — the editor's own operations never write here, confirmed empirically. It only ever has the engine's startup banner plus output from a game actually played this session (play_scene/play_project/game_launch_process). Unlike get_debugger_errors, this returns all lines unfiltered, not just errors/warnings.
| Name | Type | Req | Description |
|---|---|---|---|
| max_lines | integer | – | – |
No output schema declared.
No examples provided.
get_editor_screenshot ~79
Captures a screenshot of the editor's main viewport. Without save_path, returns a base64-encoded PNG; with save_path, writes the PNG directly to disk instead (avoids copy-pasting a large base64 string through a UI, which is fragile) and returns that file's absolute path.
| Name | Type | Req | Description |
|---|---|---|---|
| save_path | string | – | – |
No output schema declared.
No examples provided.
get_export_status ~17
Get the status of an export operation.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_gradient_info ~32
[Full] Get info about a Gradient resource (point count, color stops).
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | – |
No output schema declared.
No examples provided.
get_image_info ~36
[Full] Returns metadata about an image file — dimensions, format, has_alpha, file size.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | – |
No output schema declared.
No examples provided.
get_image_studio_generation_request ~33
[Full] Check the status of a previously submitted generation request.
| Name | Type | Req | Description |
|---|---|---|---|
| request_id | string | yes | – |
No output schema declared.
No examples provided.
get_input_actions ~19
Lists every InputMap action with its bound events.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_license_info ~31
Return the current license tier (lite or full) and details. Pure Python — no Godot connection needed.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
get_mesh_info ~39
[Full] Retrieves mesh surface details (vertex counts, blend shape names) for a MeshInstance3D.
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
No output schema declared.
No examples provided.
get_navigation_info ~35
[Full] Queries a navigation node's configuration (region/agent/obstacle/link).
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
No output schema declared.
No examples provided.
How do I install the GodotBridge MCP server?
GodotBridge runs locally as a PyPI package, launched with uvx godotbridge. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · godotbridge
claude mcp add godotbridge-godotbridge -- uvx godotbridge
What is the GodotBridge MCP server?
GodotBridge is an MCP server listed in the public MCP registry as io.github.godotbridge/godotbridge. Lets AI agents build, run and test Godot 4 projects in the real editor. Free Lite tier. This page covers its PyPI package (godotbridge).
Is the GodotBridge MCP server safe to use?
GodotBridge scores 50 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. 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 GodotBridge MCP server expose?
GodotBridge exposes 345 tools: get_project_info, get_project_settings, list_project_files, read_file, write_file, and 340 more. Their descriptions and schemas cost roughly 16,077 tokens of context every time the server is loaded.
Is the GodotBridge MCP server still maintained?
GodotBridge 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 GodotBridge MCP server under?
GodotBridge declares the Proprietary licence, which is not on the OSI-approved list. Read the terms before using it at work, and note this covers the source only, not the cost of any service it calls.
What did VerifyMCP test on the GodotBridge MCP server?
VerifyMCP ran 15 checks on GodotBridge, 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 GodotBridge: 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.