GodotBridge
PYPI · GODOTBRIDGE
Lets AI agents build, run and test Godot 4 projects in the real editor. Free Lite tier.
Available components
Last scanned (21 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 →
play_multiplayer ~42
[Full] Launches multiple additional Godot process instances of this project for local multiplayer testing.
| Name | Type | Req | Description |
|---|---|---|---|
| instance_count | integer | – | – |
| scene_path | – | – | – |
No output schema declared.
No examples provided.
play_project ~13
Runs the main scene.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
play_scene ~30
Runs a specific scene (or the currently edited one if path is omitted).
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | – | – |
No output schema declared.
No examples provided.
prepare_pixel_asset ~78
[Full] Prepare a pixel art asset for game use: flatten all layers, optionally constrain to a max size, save as PNG, and write a .import file with the given import flags.
| Name | Type | Req | Description |
|---|---|---|---|
| import_flags | – | – | – |
| max_size | integer | – | – |
| output_path | string | yes | – |
| project_path | string | yes | – |
No output schema declared.
No examples provided.
project_health_report ~29
Runs a comprehensive project audit: statistics, unused resources, dependency cycles, script validity, node warnings.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
read_file ~27
Loads a UTF-8 text file from within the project.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | – |
No output schema declared.
No examples provided.
read_resource ~30
[Full] Loads a resource and returns its class and editor-visible properties.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | – |
No output schema declared.
No examples provided.
read_script ~25
Retrieves a script's source text via the editor.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | – |
No output schema declared.
No examples provided.
read_shader ~22
[Full] Retrieves shader source.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | – |
No output schema declared.
No examples provided.
reimport_assets ~30
[Full] Triggers a reimport of the given asset paths.
| Name | Type | Req | Description |
|---|---|---|---|
| paths | array | yes | – |
No output schema declared.
No examples provided.
remove_animation ~31
[Full] Deletes an animation.
| Name | Type | Req | Description |
|---|---|---|---|
| animation_name | string | yes | – |
| node_path | string | yes | – |
No output schema declared.
No examples provided.
remove_animation_blend_node ~43
[Full] Removes a blend node from an AnimationTree's state machine.
| Name | Type | Req | Description |
|---|---|---|---|
| blend_node_name | string | yes | – |
| node_path | string | yes | – |
No output schema declared.
No examples provided.
remove_animation_keyframe ~58
[Full] Removes a keyframe from an animation track by its key index.
| Name | Type | Req | Description |
|---|---|---|---|
| animation_name | string | yes | – |
| key_index | integer | yes | – |
| node_path | string | yes | – |
| track_index | integer | yes | – |
No output schema declared.
No examples provided.
remove_animation_track ~44
[Full] Removes an animation track by its index.
| Name | Type | Req | Description |
|---|---|---|---|
| animation_name | string | yes | – |
| node_path | string | yes | – |
| track_index | integer | yes | – |
No output schema declared.
No examples provided.
remove_autoload ~23
Unregisters an autoload.
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | – |
No output schema declared.
No examples provided.
remove_from_group ~34
Unassigns a node from a group.
| Name | Type | Req | Description |
|---|---|---|---|
| group_name | string | yes | – |
| node_path | string | yes | – |
No output schema declared.
No examples provided.
remove_input_action ~22
Deletes an input action.
| Name | Type | Req | Description |
|---|---|---|---|
| action_name | string | yes | – |
No output schema declared.
No examples provided.
remove_visual_shader_node ~40
[Full] Remove a node from a VisualShader graph by its ID.
| Name | Type | Req | Description |
|---|---|---|---|
| node_id | integer | yes | – |
| path | string | yes | – |
No output schema declared.
No examples provided.
rename_animation ~41
[Full] Changes an animation's name.
| Name | Type | Req | Description |
|---|---|---|---|
| new_name | string | yes | – |
| node_path | string | yes | – |
| old_name | string | yes | – |
No output schema declared.
No examples provided.
rename_node ~30
Changes a node's name.
| Name | Type | Req | Description |
|---|---|---|---|
| new_name | string | yes | – |
| node_path | string | yes | – |
No output schema declared.
No examples provided.
reparent_node ~34
Moves a node to a new parent.
| Name | Type | Req | Description |
|---|---|---|---|
| new_parent_path | string | yes | – |
| node_path | string | yes | – |
No output schema declared.
No examples provided.
replace_node_type ~49
Changes a node's class while preserving its children and name, copying over shared property values on a best-effort basis.
| Name | Type | Req | Description |
|---|---|---|---|
| new_type | string | yes | – |
| node_path | string | yes | – |
No output schema declared.
No examples provided.
request_image_studio_generation ~89
[Full] Generate pixel art via PixelLab AI and store the result as a new layer in the Image Studio project. Requires a PixelLab API key (see set_image_studio_api_key). The generated image matches the project's canvas dimensions.
| Name | Type | Req | Description |
|---|---|---|---|
| layer_name | string | – | – |
| project_path | string | yes | – |
| prompt | string | yes | – |
| style | string | – | – |
No output schema declared.
No examples provided.
rescan_filesystem ~26
[Full] Triggers a full filesystem rescan in the Godot editor.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
reset_bone_poses ~33
[Full] Restores every bone's pose to its rest transform.
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
No output schema declared.
No examples provided.
resolve_uid ~43
[Full] Translates between uid:// and res:// identifiers. Provide exactly one of uid or path.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | – | – |
| uid | string | – | – |
No output schema declared.
No examples provided.
run_editor_script ~60
[Full] Executes arbitrary GDScript in the editor process. Runs with full editor privileges — no sandboxing exists. The code becomes the body of a run(ei) function; whatever it returns becomes the result.
| Name | Type | Req | Description |
|---|---|---|---|
| code | string | yes | – |
Structured output declared, but exposes no named fields.
No examples provided.
run_gdscript_test ~87
Runs a GDScript test file's test_* functions in the editor process. GDScript has no exceptions, so failures are signaled by convention: a test_* function returns false or a non-empty String (the failure message) to fail; anything else (including no return) counts as a pass.
| Name | Type | Req | Description |
|---|---|---|---|
| content | string | – | – |
| path | string | – | – |
No output schema declared.
No examples provided.
save_branch_as_scene ~74
Exports the subtree at node_path to a new scene file. This writes a copy; unlike the editor's own "Save Branch as Scene" command it does not replace the original node in the current scene with an instance of the new file.
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
| path | string | yes | – |
No output schema declared.
No examples provided.
save_bus_layout ~31
[Full] Persists the current audio bus configuration to a resource file.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | – | – |
No output schema declared.
No examples provided.
save_scene ~22
Persists changes to the currently open scene, at its existing path.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
scatter_multimesh ~72
[Full] Distributes randomly-placed mesh instances within a box area.
| Name | Type | Req | Description |
|---|---|---|---|
| area | – | – | – |
| count | integer | – | – |
| mesh_properties | – | – | – |
| mesh_type | string | – | – |
| node_name | – | – | – |
| parent_path | string | yes | – |
| seed | integer | – | – |
No output schema declared.
No examples provided.
search_asset_library ~82
[Full] Searches Godot's public Asset Library (godotengine.org/asset-library) for addons matching a query, calling its REST API directly from this server (no GDScript/HTTPRequest involved).
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | – |
| godot_version | string | – | – |
| max_results | integer | – | – |
| query | string | yes | – |
No output schema declared.
No examples provided.
search_in_files ~52
Searches text content of project files for a string or regex pattern. Returns matching file paths and line numbers.
| Name | Type | Req | Description |
|---|---|---|---|
| file_pattern | string | – | – |
| path | string | – | – |
| query | string | yes | – |
No output schema declared.
No examples provided.
select_node ~29
Selects a node in the editor scene tree by its path.
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
No output schema declared.
No examples provided.
set_anchors_preset ~50
[Full] Applies a layout anchor preset (e.g. "full_rect", "center", "top_wide").
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
| preset | string | yes | – |
No output schema declared.
No examples provided.
set_animation_keyframe ~61
[Full] Places a keyframe on a track at a given time.
| Name | Type | Req | Description |
|---|---|---|---|
| animation_name | string | yes | – |
| node_path | string | yes | – |
| time | number | yes | – |
| track_index | integer | yes | – |
| value | – | yes | – |
No output schema declared.
No examples provided.
set_animation_keyframes ~64
[Full] Sets multiple keyframes on a track at once. Each keyframe has a time and value.
| Name | Type | Req | Description |
|---|---|---|---|
| animation_name | string | yes | – |
| keyframes | array | yes | – |
| node_path | string | yes | – |
| track_index | integer | yes | – |
No output schema declared.
No examples provided.
set_audio_bus ~56
[Full] Modifies an existing audio bus's volume/mute/solo/send-target.
| Name | Type | Req | Description |
|---|---|---|---|
| bus_name | string | yes | – |
| mute | – | – | – |
| send | – | – | – |
| solo | – | – | – |
| volume_db | – | – | – |
No output schema declared.
No examples provided.
set_blend_shape ~65
[Full] Adjusts a blend shape (morph target) value on a MeshInstance3D, by name or index.
| Name | Type | Req | Description |
|---|---|---|---|
| blend_shape_index | – | – | – |
| blend_shape_name | – | – | – |
| node_path | string | yes | – |
| value | number | yes | – |
No output schema declared.
No examples provided.
set_bone_pose ~62
[Full] Adjusts a bone's pose transform (position/rotation/scale, relative to rest).
| Name | Type | Req | Description |
|---|---|---|---|
| bone_index | integer | yes | – |
| node_path | string | yes | – |
| position | – | – | – |
| rotation | – | – | – |
| scale | – | – | – |
No output schema declared.
No examples provided.
set_bone_rest ~42
[Full] Modifies a bone's rest transform.
| Name | Type | Req | Description |
|---|---|---|---|
| bone_index | integer | yes | – |
| node_path | string | yes | – |
| position | – | – | – |
No output schema declared.
No examples provided.
set_camera_limits ~50
[Full] Configures a Camera2D's scroll boundaries.
| Name | Type | Req | Description |
|---|---|---|---|
| bottom | – | – | – |
| left | – | – | – |
| node_path | string | yes | – |
| right | – | – | – |
| top | – | – | – |
No output schema declared.
No examples provided.
set_collision_layers ~66
[Full] Configures collision_layer/collision_mask. Each accepts either a raw bitmask int or a list of 1-indexed layer numbers (e.g. [1, 3]).
| Name | Type | Req | Description |
|---|---|---|---|
| layer | – | – | – |
| mask | – | – | – |
| node_path | string | yes | – |
No output schema declared.
No examples provided.
set_collision_layers_by_name ~58
[Full] Sets collision_layer/collision_mask by the project's named physics layers instead of raw bit numbers.
| Name | Type | Req | Description |
|---|---|---|---|
| dimension | string | – | – |
| layers | – | – | – |
| mask_layers | – | – | – |
| node_path | string | yes | – |
No output schema declared.
No examples provided.
set_control_icon ~46
[Full] Places an icon on a control that has an icon property (e.g. a Button).
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
| texture_path | string | yes | – |
No output schema declared.
No examples provided.
set_control_style ~54
[Full] Applies a theme stylebox override directly to a control.
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
| properties | – | – | – |
| stylebox_name | string | – | – |
| stylebox_type | string | – | – |
No output schema declared.
No examples provided.
set_csg_operation ~48
[Full] Modifies a CSG shape's boolean operation ("union", "intersection", or "subtraction").
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
| operation | string | yes | – |
No output schema declared.
No examples provided.
set_curve_points ~36
[Full] Replaces all points on an existing Curve resource.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | – |
| points | array | yes | – |
No output schema declared.
No examples provided.
set_environment_effects ~44
[Full] Configures a WorldEnvironment node's Environment (creating one if it has none).
| Name | Type | Req | Description |
|---|---|---|---|
| node_path | string | yes | – |
| properties | object | 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.