mcp-extension-creator

Create Godot MCP Gateway extensions that register custom MCP tools in GDScript or C#.

Updated Aug 20, 2026
One-click install
npx skills add https://github.com/di404/godot-mcp-gateway --skill mcp-extension-creator-di404
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-extension-creator
Source: https://github.com/di404/godot-mcp-gateway/tree/main/addons/godot_mcp_gateway/CompanionSkills/mcp-extension-creator
Command: npx skills add https://github.com/di404/godot-mcp-gateway --skill mcp-extension-creator-di404

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building third-party extensions for the Godot MCP Gateway requires knowing many non-obvious rules — the options builder verbs, path guards, error envelopes, naming conventions, hot-reload behavior, and C# discovery gotchas. This Skill guides an AI agent through authoring a correct, safe, distributable extension without the user memorizing the API surface. ## Core Features & Use Cases - Complete extension scaffolding: Produces a working MCPGatewayExtension subclass with register(), an options builder chain, input schema, and a handler returning proper success/error envelopes. - Correct configuration decisions: Applies the decision table for mark_read_only, mark_destructive, mark_scene_independent, mark_cancellable, path guards, tool groups, and timeouts so tools behave correctly under multi-agent concurrency. - Safety and distribution guidance: Enforces path-traversal guards, untrusted-output wrapping, headless guards, doc-comment conventions, hot-reload workflow, and AssetLib packaging rules. - Use Case: Ask the agent to "build an extension that writes markdown notes to res:// paths" and receive a ready-to-load GDScript addon with a guarded notes_write tool, schema, and doc comments. ## Quick Start Ask the agent to build a Godot MCP Gateway extension that adds a custom tool, describing what the tool should do and its parameters.

Frequently Asked Questions about mcp-extension-creator

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a custom MCP tool extension for the Godot MCP Gateway?

Create a GDScript file in addons/<extension_name>/ with @tool, a class extending MCPGatewayExtension, and a register(registry, server) method. Inside register, build MCPGatewayExtensionOptions and call registry.add with a namespace.action wire name and your handler.

How do I write a Godot MCP Gateway extension in C#?

C# extensions use a [Tool, GlobalClass] partial class extending RefCounted with a public Register(GodotObject registry, Node server) method. The class name must start with MCPGateway and the file name must match the class name, then run dotnet build before the gateway discovers it.

Why is my Godot MCP Gateway extension not discovered or registered?

Common causes are a missing @tool annotation, not extending MCPGatewayExtension directly, a wrong register() signature, or a reserved namespace. For C#, verify the file name matches the class name and that dotnet build has updated the global class cache.

Does hot-reload work when editing a Godot MCP Gateway extension?

Yes — saving the file and alt-tabbing to the editor, or calling extensions_refresh, picks up changes. On Godot 4.2, edits to an already-loaded extension require an editor restart, while adds and removals apply live; Godot 4.3+ applies all changes live.

How do I prevent path traversal attacks in a custom MCP tool?

Add guard_project_path or guard_user_path to the options builder so dispatch rejects traversal paths with PATH_DENIED before the handler runs. For paths the declarative guard cannot handle, use FileGuard.resolve_safe imperatively inside the handler.