Skip to content
Agentmart
Submit a tool

Gopeak

GoPeak — The most comprehensive MCP server for Godot Engine.

Connector by HaD0Yun · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 269
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/had0yun-gopeak

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

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

Use cases: code-generation, debugging

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.

Tools
45 read · 47 write · 5 delete · 14 not yet classified
Secrets
None asked for
Install scripts
Not scanned yet
Runs as
Node.js package

Tools by what they do 111

Read from the source code; the running server may list different tools.

Read 45 · Look things up without changing anything.

  • capture_intent_snapshot
  • capture_screenshot
  • capture_viewport
  • connect_animation_states
  • dap_get_output
  • dap_get_stack_trace
  • enforce_version_gate
  • find_resource_usages
  • get_audio_buses
  • get_debug_output
  • get_dependencies
  • get_editor_status
Show 33 more tools
  • get_godot_version
  • get_import_options
  • get_import_status
  • get_node_properties
  • get_project_health
  • get_project_info
  • get_project_setting
  • get_recording_mode
  • get_runtime_metrics
  • get_runtime_status
  • get_script_info
  • get_uid
  • inspect_inheritance
  • inspect_runtime_tree
  • list_asset_providers
  • list_autoloads
  • list_connections
  • list_export_presets
  • list_plugins
  • list_projects
  • list_scene_nodes
  • lsp_get_completions
  • lsp_get_diagnostics
  • lsp_get_hover
  • lsp_get_symbols
  • parse_error_log
  • query_class_info
  • query_classes
  • search_assets
  • search_project
  • summarize_intent_context
  • tool_catalog
  • validate_project

Write 47 · Create, change, send or run things.

  • add_animation_state
  • add_animation_track
  • add_autoload
  • add_input_action
  • add_node
  • apply_theme_shader
  • call_runtime_method
  • connect_signal
  • create_animation
  • create_animation_tree
  • create_audio_bus
  • create_material
Show 35 more tools
  • create_navigation_agent
  • create_navigation_region
  • create_resource
  • create_scene
  • create_script
  • create_shader
  • create_tileset
  • dap_set_breakpoint
  • disable_plugin
  • duplicate_node
  • enable_plugin
  • inject_mouse_click
  • load_sprite
  • manage_tool_groups
  • modify_resource
  • modify_script
  • record_decision_log
  • record_execution_trace
  • record_work_step
  • reparent_node
  • run_project
  • save_scene
  • scaffold_gameplay_prototype
  • set_audio_bus_effect
  • set_audio_bus_volume
  • set_import_options
  • set_main_scene
  • set_node_properties
  • set_project_setting
  • set_recording_mode
  • set_runtime_property
  • set_theme_color
  • set_theme_font_size
  • set_tilemap_cells
  • update_project_uids

Delete 5 · Delete, drop, revoke or wipe things.

  • dap_remove_breakpoint
  • delete_node
  • disconnect_signal
  • remove_autoload
  • stop_project

Not yet classified 14 · We could not tell from the name and description.

  • dap_continue
  • dap_pause
  • dap_step_over
  • export_handoff_pack
  • export_project
  • fetch_asset
  • generate_handoff_brief
  • inject_action
  • inject_key
  • inject_mouse_motion
  • launch_editor
  • map_project
Show 2 more tools
  • reimport_resource
  • validate_patch_with_lsp

Files it touches

  • Any path the agent passes to its tools

Tools (111)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • add_animation_state

    Add a state to an AnimationTree state machine

  • add_animation_track

    Adds a property or method track to an animation. Prerequisite: animation must exist (use create_animation first). Use to animate position, rotation, color, or call methods at specific times. Keyframes define values over time.

  • add_autoload

    Registers a script/scene as an autoload singleton. Use for global managers (GameManager, AudioManager, etc.). Loads automatically on game start.

  • add_input_action

    Registers a new input action in project.godot InputMap. Use to set up keyboard, mouse, or gamepad controls for player actions like jump, move, attack.

  • add_node

    Adds ANY node type to an existing scene. This is the universal node creation tool — replaces all specialized create_* node tools. Supports ALL ClassDB node types (Camera3D, DirectionalLight3D, AudioStreamPlayer, HTTPRequest, RayCast3D, etc.). Set any property via the properties parameter with type conversion support (Vector2, Vector3, Color, etc.). Use query_classes to discover available node types. Use query_class_info to discover available properties for a type.

  • apply_theme_shader

    Generate and apply theme-appropriate shader to a material in a scene

  • call_runtime_method

    Call a method on a node in a running Godot instance

  • capture_intent_snapshot

    Capture/update an intent snapshot for current work (goal, constraints, acceptance criteria) and persist it for handoff.

  • capture_screenshot

    Capture a screenshot of the running Godot game viewport. Requires the runtime addon to be active (game must be running with the MCP runtime autoload).

  • capture_viewport

    Capture a viewport texture as base64 image from the running Godot game. Similar to capture_screenshot but captures a specific viewport by path.

  • connect_animation_states

    Connect two states with a transition

  • connect_signal

    Creates a signal connection between nodes in a scene. Prerequisite: source and target nodes must exist. Use to wire up button clicks, collision events, custom signals. Saved to scene file.

  • create_animation

    Creates a new animation in an AnimationPlayer. Prerequisite: AnimationPlayer node must exist in scene (use add_node first). Use to set up character animations, UI transitions, or cutscenes. Supports loop modes: none, linear, pingpong.

  • create_animation_tree

    Create an AnimationTree node linked to an AnimationPlayer

  • create_audio_bus

    Creates a new audio bus for mixing. Use to set up separate volume controls for music, SFX, voice, etc.

Show 96 more tools
  • create_material

    Creates a material resource for 3D/2D rendering. Types: StandardMaterial3D (PBR), ShaderMaterial (custom), CanvasItemMaterial (2D), ParticleProcessMaterial (particles).

  • create_navigation_agent

    Creates a NavigationAgent for AI pathfinding. Use for enemies, NPCs that need to navigate around obstacles.

  • create_navigation_region

    Creates a NavigationRegion for pathfinding. Use to define walkable areas for AI navigation.

  • create_resource

    Creates ANY resource type as a .tres file. This is the universal resource creation tool — replaces all specialized create_* resource tools (PhysicsMaterial, Environment, Theme, etc.). Supports ALL ClassDB resource types. Set any property via the properties parameter with type conversion support. Use query_classes with category "resource" to discover available resource types. Use query_class_info to discover available properties.

  • create_scene

    Creates a new Godot scene file (.tscn) with a specified root node type. Use to start building new game levels, UI screens, or reusable components. The scene is saved automatically after creation.

  • create_script

    Creates a new GDScript (.gd) file with optional templates. Use to generate scripts for game logic. Templates: "singleton" (autoload), "state_machine" (FSM), "component" (modular), "resource" (custom Resource).

  • create_shader

    Creates a shader file (.gdshader) with optional templates. Types: canvas_item (2D), spatial (3D), particles, sky, fog. Templates: basic, color_shift, outline.

  • create_tileset

    Creates a TileSet resource from texture atlases. Use for 2D tilemaps in platformers, RPGs, etc. Supports multiple atlas sources.

  • dap_continue

    Continue execution after a breakpoint or pause

  • dap_get_output

    Get captured Godot DAP console output lines

  • dap_get_stack_trace

    Get the current stack trace from the Godot debugger

  • dap_pause

    Pause execution of the running Godot debug target

  • dap_remove_breakpoint

    Remove a breakpoint in a Godot script at a specific line

  • dap_set_breakpoint

    Set a breakpoint in a Godot script at a specific line

  • dap_step_over

    Step over the current line in the debugger

  • delete_node

    Removes a node and all its children from a scene. Use to clean up unused nodes. Cannot delete root node. Scene is saved automatically unless saveScene=false.

  • disable_plugin

    Disables a plugin in the project. Updates project.godot automatically. Plugin files remain in addons/ folder.

  • disconnect_signal

    Removes a signal connection from a scene. Use to clean up unused connections or rewire logic.

  • duplicate_node

    Creates a copy of a node with all its properties and children. Use to replicate enemies, UI elements, or any repeated structures. Scene is saved automatically unless saveScene=false.

  • enable_plugin

    Enables a plugin from addons/ folder. Updates project.godot automatically. Use list_plugins first to see available plugins.

  • enforce_version_gate

    Checks Godot version and runtime addon protocol/capabilities against minimum requirements before risky operations.

  • export_handoff_pack

    Export a machine-readable handoff pack combining intent, decisions, and execution traces.

  • export_project

    Exports the project to a distributable format. Use to build final game executables. Requires export templates installed.

  • fetch_asset

    Download a CC0 asset from any supported source (Poly Haven, AmbientCG, Kenney) to your Godot project.

  • find_resource_usages

    Finds all files that reference a resource. Use before deleting or renaming to avoid breaking references.

  • generate_handoff_brief

    Generate a handoff brief from saved intents, decisions, and execution traces for the next AI/operator.

  • get_audio_buses

    Lists all audio buses and their configuration. Use to check current audio setup.

  • get_debug_output

    Retrieves console output and errors from the currently running Godot project. Use after run_project to check logs, errors, and print statements. Returns empty if no project is running.

  • get_dependencies

    Analyzes resource dependencies and detects circular references. Use to understand what a scene/script depends on before refactoring.

  • get_editor_status

    Returns the connection status of the Godot Editor Plugin bridge. Use to check if the editor is connected before using scene/resource tools that require the editor plugin.

  • get_godot_version

    Returns the installed Godot engine version string. Use to check compatibility (e.g., Godot 4.4+ features like UID). Returns version like "4.3.stable" or "4.4.dev".

  • get_import_options

    Returns current import settings for a resource. Use to check compression, mipmaps, filter settings before modifying.

  • get_import_status

    Returns import status for project resources. Use to find outdated or failed imports. Shows which resources need reimporting.

  • get_node_properties

    Returns all properties of a specific node in a scene. Use to inspect current values before modifying. Returns property names, values, and types.

  • get_project_health

    Generates a health report with scoring for project quality. Checks for unused resources, script errors, missing references, etc.

  • get_project_info

    Returns metadata about a Godot project including name, version, main scene, autoloads, and directory structure. Use to understand project before modifying. Requires valid project.godot.

  • get_project_setting

    Reads a value from project.godot settings. Use to check game name, window size, physics settings, etc.

  • get_recording_mode

    Get current recording mode and queue status.

  • get_runtime_metrics

    Get performance metrics from a running Godot instance

  • get_runtime_status

    Checks if a Godot game instance is running and connected for live debugging. Use before other runtime tools.

  • get_script_info

    Analyzes a GDScript and returns its structure: functions, variables, signals, class_name, extends. Use before modify_script to understand existing code.

  • get_uid

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

  • inject_action

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

  • inject_key

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

  • inject_mouse_click

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

  • inject_mouse_motion

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

  • inspect_inheritance

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

  • inspect_runtime_tree

    Inspect the scene tree of a running Godot instance

  • launch_editor

    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.

  • list_asset_providers

    List all available CC0 asset providers and their capabilities.

  • list_autoloads

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

  • list_connections

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

  • list_export_presets

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

  • list_plugins

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

  • list_projects

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

  • list_scene_nodes

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

  • load_sprite

    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.

  • lsp_get_completions

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

  • lsp_get_diagnostics

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

  • lsp_get_hover

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

  • lsp_get_symbols

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

  • manage_tool_groups

    Manage tool groups. Actions: list (show all core + dynamic groups), activate (enable a dynamic group), deactivate (disable a dynamic group), reset (disable all dynamic), status (show current state). Core groups (always visible, 33 tools): core_meta, core_project, core_editor, core_scene, core_script, core_class, core_signal, core_resource, core_export, core_runtime, core_visualizer, core_diagnostics. Dynamic groups (on-demand, 78 tools): scene_advanced, uid, import_export, autoload, signal, runtime, resource, animation, plugin, input, tilemap, audio, navigation, theme_ui, asset_store, testing,…

  • map_project

    Description is built at runtime.

  • modify_resource

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

  • modify_script

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

  • parse_error_log

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

  • query_class_info

    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.

  • query_classes

    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.

  • record_decision_log

    Record a structured decision log entry with rationale and alternatives.

  • record_execution_trace

    Record execution trace for a work step (command/tool, files changed, result, artifacts).

  • record_work_step

    Unified operation: records execution trace and optionally refreshes handoff pack in one call.

  • reimport_resource

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

  • remove_autoload

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

  • reparent_node

    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.

  • run_project

    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.

  • save_scene

    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.

  • scaffold_gameplay_prototype

    Creates a minimal playable prototype scaffold in one shot: main scene, player scene, basic nodes, common input actions, and optional starter player script.

  • search_assets

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

  • search_project

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

  • set_audio_bus_effect

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

  • set_audio_bus_volume

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

  • set_import_options

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

  • set_main_scene

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

  • set_node_properties

    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.

  • set_project_setting

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

  • set_recording_mode

    Set recording mode: lite (minimal overhead) or full (richer context).

  • set_runtime_property

    Set a property on a node in a running Godot instance

  • set_theme_color

    Set a color in a Theme resource

  • set_theme_font_size

    Set a font size in a Theme resource

  • set_tilemap_cells

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

  • stop_project

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

  • summarize_intent_context

    Summarize current intent context (goal, open decisions, risks, next actions) in compact form.

  • tool_catalog

    Discover available tools including hidden legacy tools. Use query to search by capability keywords. Results include group categorization (core/dynamic). Matching dynamic groups are auto-activated and become available immediately. Core groups (always visible): core_meta, core_project, core_editor, core_scene, core_script, core_class, core_signal, core_resource, core_export, core_runtime, core_visualizer, core_diagnostics. Dynamic groups (on-demand): scene_advanced, uid, import_export, autoload, signal, runtime, resource, animation, plugin, input, tilemap, audio, navigation, theme_ui, asset_stor…

  • update_project_uids

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

  • validate_patch_with_lsp

    Runs Godot LSP diagnostics for a script and returns whether it is safe to apply changes. Intended as a pre-apply quality gate.

  • validate_project

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

Compare and alternatives

    Featured in

    Signals

    Stars
    269
    Forks
    28
    Open issues
    0
    Contributors
    3
    Last commit
    May 13, 2026 (5 months ago)
    Last release
    Sep 12, 2026 (1 month ago)

    From GitHub (fetched Oct 24, 2026).

    Details

    Registry name
    io.github.HaD0Yun/gopeak
    Version
    2.0.1
    Auth
    No auth
    Packages
    npm gopeak
    License
    MIT
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026
    Cite this page

    Gopeak MCP server. Agent Mart. https://agentmart.dev/connectors/had0yun-gopeak (last updated 2026-10-24)