Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, email [email protected] and we’ll put it right.

io.github.HaD0Yun/gopeak

NPM · GOPEAK · SCANNED AUG 3

GoPeak — The most comprehensive MCP server for Godot Engine. 95+ tools, LSP, DAP, screenshots.

Available components

+11 this week 57 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
  • Only part of the dependency tree could be resolved (47 of 48), so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency19
Schema Quality & AI Usability84
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 10450 tokens (~108/item across 96 items; 95 tools + 1 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 Management27
  • Stability observed for 8 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 · gopeak

# add to Claude Code
claude mcp add had0yun-gopeak -- npx -y gopeak
# add to Codex CLI
codex mcp add had0yun-gopeak -- npx -y gopeak
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "had0yun-gopeak": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "gopeak"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add had0yun-gopeak --command npx --arg -y --arg gopeak
# ~/.hermes/config.yaml
mcp_servers:
  had0yun-gopeak:
    command: "npx"
    args: ["-y", "gopeak"]
// mcp.json
{
  "mcpServers": {
    "had0yun-gopeak": {
      "command": "npx",
      "args": [
        "-y",
        "gopeak"
      ]
    }
  }
}
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.

  • 3 Aug 26 +4
    • Stability: unverified → 0.27 functional
  • 2 Aug 26 +19
    • 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
    • Security disclosure: fail → unverified functional
    • Schema quality: unverified → excellent functional
  • 1 Aug 26 +13
    • CVE-2025-66414 affects this package: high security
    • Provenance: unverified → fail security
    • Known CVEs: unverified → fail security
    • Install scripts: unverified → pass security
    • Maintenance: unverified → pass functional
    • License: unverified → pass functional
    • Dependency health: unverified → partial functional
    • Licence: MIT functional
  • 31 Jul 26 +3
    • 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 −28
    • Schema quality: 100 → unverified functional
    • Tool coverage: 100 → unverified functional
  • 27 Jul 26 46

    First indexed and scored.

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/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Vulnerabilities 1 finding
ID CVE Severity Vector Fix available
GHSA-w48q-cv73-mx4w CVE-2025-66414 high yes
Dependencies 47 packages

47 packages in the resolved dependency tree · 47 deprecated · 13 stale.

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

MCP tools — 95 exposed · ~10,434 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
get_uid ~68

Get the UID for a specific file in a Godot project (for Godot 4.4+)

NameTypeReqDescription
filePathstringyesPath to the file (relative to project) for which to get the UID
projectPathstringyesPath to the Godot project directory

No output schema declared.

No examples provided.

inject_action ~93

Simulate a Godot input action (press/release). Requires runtime addon.

NameTypeReqDescription
actionstringyesAction name as defined in Input Map (e.g., "ui_accept", "jump")
pressedbooleanWhether to press (true) or release (false). Default: true
strengthnumberAction strength 0.0–1.0. Default: 1.0

No output schema declared.

No examples provided.

inject_key ~110

Simulate a keyboard key press/release in the running Godot game. Requires runtime addon.

NameTypeReqDescription
altbooleanAlt modifier. Default: false
ctrlbooleanCtrl modifier. Default: false
keycodestringyesKey name (e.g., "A", "Space", "Escape", "Enter")
pressedbooleanPress (true) or release (false). Default: true
shiftbooleanShift modifier. Default: false

No output schema declared.

No examples provided.

inject_mouse_click ~98

Simulate a mouse click at specified position in the running Godot game. Requires runtime addon.

NameTypeReqDescription
buttonstringMouse button. Default: left
doubleClickbooleanDouble-click. Default: false
pressedbooleanPress (true) or release (false). Default: true
xnumberyesX coordinate in viewport pixels
ynumberyesY coordinate in viewport pixels

No output schema declared.

No examples provided.

inject_mouse_motion ~77

Simulate mouse movement to a position in the running Godot game. Requires runtime addon.

NameTypeReqDescription
relativeXnumberRelative X movement delta
relativeYnumberRelative Y movement delta
xnumberyesTarget X coordinate in viewport pixels
ynumberyesTarget Y coordinate in viewport pixels

No output schema declared.

No examples provided.

inspect_inheritance ~65

Inspect class inheritance hierarchy: ancestors, direct children, all descendants. Use to understand class relationships and find specialized alternatives.

NameTypeReqDescription
classNamestringyesExact Godot class name to inspect
projectPathstringyesAbsolute path to project directory containing project.godot.

No output schema declared.

No examples provided.

inspect_runtime_tree ~68

Inspect the scene tree of a running Godot instance

NameTypeReqDescription
depthnumberMaximum depth to inspect (default: 3)
nodePathstringPath to start inspection from (default: root)
projectPathstringyesPath to the Godot project directory

No output schema declared.

No examples provided.

launch_editor ~81

Opens the Godot editor GUI for a project. Use when visual inspection or manual editing of scenes/scripts is needed. Opens a new window on the host system. Requires: project directory with project.godot file.

NameTypeReqDescription
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.

No output schema declared.

No examples provided.

list_asset_providers ~21

List all available CC0 asset providers and their capabilities.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_autoloads ~60

Lists all registered autoload singletons in the project. Shows name, path, and enabled status.

NameTypeReqDescription
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.

No output schema declared.

No examples provided.

list_connections ~103

Lists all signal connections in a scene. Use to understand event flow or debug connection issues.

NameTypeReqDescription
nodePathstringOptional: filter to connections involving this node. If omitted, shows all.
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
scenePathstringyesPath to .tscn file (e.g., "scenes/player.tscn")

No output schema declared.

No examples provided.

list_export_presets ~88

Lists all export presets defined in export_presets.cfg. Use before export_project to see available targets (Windows, Linux, Android, etc.).

NameTypeReqDescription
includeTemplateStatusbooleanIf true (default), shows if export templates are installed.
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.

No output schema declared.

No examples provided.

list_plugins ~63

Lists all plugins in addons/ folder with enabled/disabled status. Use before enable_plugin or disable_plugin to see available plugins.

NameTypeReqDescription
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.

No output schema declared.

No examples provided.

list_projects ~99

Scans a directory for Godot projects (folders containing project.godot). Use to discover projects before using other tools. Returns array of {path, name}.

NameTypeReqDescription
directorystringyesAbsolute path to search (e.g., "/home/user/godot-projects" on Linux, "C:\Games" on Windows)
recursivebooleanIf true, searches all subdirectories. If false (default), only checks immediate children.

No output schema declared.

No examples provided.

list_scene_nodes ~153

Returns complete scene tree structure with all nodes, types, and hierarchy. Use to understand scene organization before modifying. Returns nested tree with node paths.

NameTypeReqDescription
depthnumberMaximum depth to traverse. -1 = all (default), 0 = root only, 1 = root + children
includePropertiesbooleanIf true, includes all node properties. If false (default), only names and types.
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
scenePathstringyesPath to .tscn file relative to project (e.g., "scenes/Player.tscn")

No output schema declared.

No examples provided.

load_sprite ~158

Assigns a texture to a Sprite2D node in a scene. Use to set character sprites, backgrounds, or UI images. The texture file must exist in the project.

NameTypeReqDescription
nodePathstringyesPath to Sprite2D node in scene (e.g., ".", "Player/Sprite2D")
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
scenePathstringyesPath to .tscn file relative to project (e.g., "scenes/Player.tscn")
texturePathstringyesPath to texture file relative to project (e.g., "assets/player.png", "sprites/enemy.svg")

No output schema declared.

No examples provided.

lsp_get_completions ~78

Get code completions from Godot Language Server at a given position.

NameTypeReqDescription
characternumberyesZero-based character offset
linenumberyesZero-based line number
projectPathstringyesAbsolute path to Godot project root
scriptPathstringyesPath to script relative to project root

No output schema declared.

No examples provided.

lsp_get_diagnostics ~56

Get GDScript diagnostics from Godot Language Server for a script file.

NameTypeReqDescription
projectPathstringyesAbsolute path to Godot project root
scriptPathstringyesPath to script relative to project root

No output schema declared.

No examples provided.

lsp_get_hover ~75

Get hover information from Godot Language Server at a given position.

NameTypeReqDescription
characternumberyesZero-based character offset
linenumberyesZero-based line number
projectPathstringyesAbsolute path to Godot project root
scriptPathstringyesPath to script relative to project root

No output schema declared.

No examples provided.

lsp_get_symbols ~55

Get document symbols for a GDScript file from Godot Language Server.

NameTypeReqDescription
projectPathstringyesAbsolute path to Godot project root
scriptPathstringyesPath to script relative to project root

No output schema declared.

No examples provided.

modify_resource ~134

Modify properties of an existing resource file (.tres/.res). Use to update materials, environments, themes, or any saved resource without recreating it.

NameTypeReqDescription
projectPathstringyesAbsolute path to project directory containing project.godot.
propertiesstringyesJSON object of properties to set (e.g., {"albedo_color": {"_type": "Color", "r": 1, "g": 0, "b": 0, "a": 1}})
resourcePathstringyesPath to existing resource file relative to project (e.g., "materials/player.tres")

No output schema declared.

No examples provided.

modify_script ~110

Adds functions, variables, or signals to an existing GDScript. Use to extend scripts without manual editing. Supports @export, @onready annotations and type hints.

NameTypeReqDescription
modificationsarrayyesArray of modifications to apply
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
scriptPathstringyesPath to existing .gd file relative to project (e.g., "scripts/player.gd")

No output schema declared.

No examples provided.

parse_error_log ~97

Parses Godot error log and provides fix suggestions. Use to diagnose runtime errors or script issues.

NameTypeReqDescription
logContentstringOptional: error log text. If omitted, reads from godot.log
maxErrorsnumberMaximum errors to return. Default: 50
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.

No output schema declared.

No examples provided.

query_class_info ~128

Get detailed information about a specific Godot class: methods, properties, signals, enums. Use to discover available properties before calling add_node/create_resource/set_node_properties, or to find methods before call_runtime_method.

NameTypeReqDescription
classNamestringyesExact Godot class name (e.g., "CharacterBody3D", "StandardMaterial3D", "AnimationPlayer")
includeInheritedbooleanIf true, include inherited members from parent classes (default: false — shows only class-specific members)
projectPathstringyesAbsolute path to project directory containing project.godot.

No output schema declared.

No examples provided.

query_classes ~173

Query available Godot classes from ClassDB with filtering. Use to discover node types, resource types, or any class before using add_node/create_resource. Categories: node, node2d, node3d, control, resource, physics, physics2d, audio, visual, animation.

NameTypeReqDescription
categorystringOptional: filter by category (node, node2d, node3d, control, resource, physics, physics2d, audio, visual, animation)
filterstringOptional: substring filter for class names (case-insensitive, e.g., "light", "collision")
instantiableOnlybooleanIf true, only return classes that can be instantiated (default: false)
projectPathstringyesAbsolute path to project directory containing project.godot.

No output schema declared.

No examples provided.

reimport_resource ~109

Forces reimport of resources. Use after modifying source files or to fix import issues. Can reimport single file or all modified.

NameTypeReqDescription
forcebooleanIf true, reimports even if up-to-date. Default: false
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
resourcePathstringOptional: specific resource to reimport. If omitted, reimports all modified.

No output schema declared.

No examples provided.

remove_autoload ~74

Unregisters an autoload singleton. Use to remove global managers no longer needed.

NameTypeReqDescription
namestringyesSingleton name to remove (e.g., "GameManager")
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.

No output schema declared.

No examples provided.

reparent_node ~179

Moves a node to a different parent in the scene tree, preserving all properties and children. Use for reorganizing scene hierarchy. Scene is saved automatically unless saveScene=false.

NameTypeReqDescription
newParentPathstringyesPath to new parent node (e.g., "NewParent", "UI/Panel")
nodePathstringyesPath to node to move (e.g., "OldParent/Child", "UI/Button")
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
saveScenebooleanIf true (default), saves scene after reparenting. Set false for batch operations.
scenePathstringyesPath to .tscn file relative to project (e.g., "scenes/Level.tscn")

No output schema declared.

No examples provided.

run_project ~111

Launches a Godot project in a new window and captures output. Use to test gameplay or verify script behavior. Runs until stop_project is called. Use get_debug_output to retrieve logs.

NameTypeReqDescription
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
scenestringOptional: specific scene to run (e.g., "scenes/TestLevel.tscn"). If omitted, runs main scene from project settings.

No output schema declared.

No examples provided.

save_scene ~128

Saves changes to a scene file or creates a variant at a new path. Most scene modification tools save automatically, but use this for explicit saves or creating variants.

NameTypeReqDescription
newPathstringOptional: New path to save as variant (e.g., "scenes/PlayerBlue.tscn")
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
scenePathstringyesPath to .tscn file relative to project (e.g., "scenes/Player.tscn")

No output schema declared.

No examples provided.

search_assets ~147

Search for CC0 assets across multiple sources (Poly Haven, AmbientCG, Kenney). Returns results sorted by provider priority.

NameTypeReqDescription
assetTypestringType of asset to search (optional, searches all if not specified)
keywordstringyesSearch term (e.g., "chair", "rock", "tree")
maxResultsnumberMaximum number of results to return (default: 10)
modestringSearch mode: "parallel" queries all providers, "sequential" stops at first with results (default: parallel)
providerstringSpecific provider to search, or "all" for multi-source (default: all)

No output schema declared.

No examples provided.

search_project ~172

Searches for text or regex patterns across project files. Use to find function usages, variable references, or TODOs. Returns file paths and line numbers.

NameTypeReqDescription
caseSensitivebooleanIf true, case-sensitive search. Default: false
fileTypesarrayFile extensions to search. Default: ["gd", "tscn", "tres"]
maxResultsnumberMaximum results to return. Default: 100
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
querystringyesSearch text or regex pattern (e.g., "player", "TODO", "func.*damage")
regexbooleanIf true, treats query as regex. Default: false

No output schema declared.

No examples provided.

set_audio_bus_effect ~132

Adds or configures an audio effect on a bus. Use for reverb, delay, EQ, compression, etc.

NameTypeReqDescription
busIndexnumberyesBus index (0 = Master)
effectIndexnumberyesEffect slot index (0-7)
effectTypestringyesEffect type (e.g., "Reverb", "Delay", "Chorus", "Compressor")
enabledbooleanWhether effect is active
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.

No output schema declared.

No examples provided.

set_audio_bus_volume ~98

Sets volume for an audio bus in decibels. Use to balance audio levels.

NameTypeReqDescription
busIndexnumberyesBus index (0 = Master)
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
volumeDbnumberyesVolume in decibels (0 = unity, -80 = silent, +6 = boost)

No output schema declared.

No examples provided.

set_import_options ~140

Modifies import settings for a resource. Use to change compression, mipmaps, filter mode. Triggers reimport by default.

NameTypeReqDescription
optionsstringyesJSON string of import options (e.g., {"compress/mode": 1, "mipmaps/generate": true})
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
reimportbooleanIf true (default), reimports after setting. Set false for batch changes.
resourcePathstringyesPath to resource file (e.g., "textures/player.png")

No output schema declared.

No examples provided.

set_main_scene ~92

Sets which scene loads first when the game starts. Updates application/run/main_scene in project.godot.

NameTypeReqDescription
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
scenePathstringyesPath to main scene (e.g., "scenes/main_menu.tscn", "scenes/game.tscn")

No output schema declared.

No examples provided.

set_node_properties ~216

Sets multiple properties on a node in a scene. Prerequisite: scene and node must exist (use create_scene and add_node first). Use to modify position, scale, rotation, or any node-specific properties. Scene is saved automatically unless saveScene=false.

NameTypeReqDescription
nodePathstringyesPath to node within scene (e.g., ".", "Player", "Player/Sprite2D")
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
propertiesstringyesJSON object of properties to set (e.g., {"position": {"x": 100, "y": 200}, "scale": {"x": 2, "y": 2}})
saveScenebooleanIf true (default), saves scene after modification. Set false for batch operations.
scenePathstringyesPath to .tscn file relative to project (e.g., "scenes/Player.tscn")

No output schema declared.

No examples provided.

set_project_setting ~104

Writes a value to project.godot settings. Use to configure game name, window size, physics, etc.

NameTypeReqDescription
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
settingstringyesSetting path (e.g., "application/config/name", "display/window/size/width")
valuestringyesValue to set (Godot auto-converts types)

No output schema declared.

No examples provided.

set_runtime_property ~77

Set a property on a node in a running Godot instance

NameTypeReqDescription
nodePathstringyesPath to the target node
projectPathstringyesPath to the Godot project directory
propertystringyesProperty name to set
valuestringyesValue to set (Godot handles type conversion)

No output schema declared.

No examples provided.

set_theme_color ~100

Set a color in a Theme resource

NameTypeReqDescription
colorobjectyesColor value
colorNamestringyesColor name (font_color, etc.)
controlTypestringyesControl type (Button, Label, etc.)
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
themePathstringyesPath to the theme resource

No output schema declared.

No examples provided.

set_theme_font_size ~101

Set a font size in a Theme resource

NameTypeReqDescription
controlTypestringyesControl type (Button, Label, etc.)
fontSizeNamestringyesFont size name
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
sizenumberyesFont size in pixels
themePathstringyesPath to the theme resource

No output schema declared.

No examples provided.

set_tilemap_cells ~151

Places tiles in a TileMap node. Use to programmatically generate levels or modify existing tilemaps.

NameTypeReqDescription
cellsarrayyesArray of cells with coords {x,y}, sourceId, atlasCoords {x,y}
layernumberTileMap layer index. Default: 0
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.
scenePathstringyesPath to scene containing TileMap (e.g., "scenes/level1.tscn")
tilemapNodePathstringyesPath to TileMap node (e.g., "World/TileMap")

No output schema declared.

No examples provided.

stop_project ~52

Terminates the currently running Godot project process. Use to stop a project started with run_project. No effect if no project is running.

NameTypeReqDescription
reasonstringyesBrief explanation of why you are calling this tool

No output schema declared.

No examples provided.

update_project_uids ~47

Update UID references in a Godot project by resaving resources (for Godot 4.4+)

NameTypeReqDescription
projectPathstringyesPath to the Godot project directory

No output schema declared.

No examples provided.

validate_project ~92

Checks project for export issues: missing resources, script errors, configuration problems. Use before export_project.

NameTypeReqDescription
includeSuggestionsbooleanIf true (default), includes fix suggestions for each issue
presetstringOptional: validate against specific export preset requirements
projectPathstringyesAbsolute path to project directory containing project.godot. Use the same path across all tool calls in a workflow.

No output schema declared.

No examples provided.