# Godot Forge (npm · godot-forge)

Godot 4 MCP server — test runner, API docs, script analysis, scene parsing, LSP.

- Trust score: 65/100 (medium)
- Change this week: +19
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `godot-forge`: 65/100 (this document), [markdown](https://verifymcp.io/servers/gregario-godot-forge/godot-forge.md), [page](https://verifymcp.io/servers/gregario-godot-forge/godot-forge)

## Channel facts

- Registry: `npm`
- Package: `godot-forge`
- Version: `0.1.2`
- Transport: `stdio`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 86/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (94 of 98), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 98 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1005 tokens (~125/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add gregario-godot-forge -- npx -y godot-forge
```

### Codex

```bash
codex mcp add gregario-godot-forge -- npx -y godot-forge
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "gregario-godot-forge": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "godot-forge"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add gregario-godot-forge --command npx --arg -y --arg godot-forge
```

### Hermes

```yaml
mcp_servers:
  gregario-godot-forge:
    command: "npx"
    args: ["-y", "godot-forge"]
```

### Other

```json
{
  "mcpServers": {
    "gregario-godot-forge": {
      "command": "npx",
      "args": [
        "-y",
        "godot-forge"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 65, +60)

- [security regression] Provenance: unverified → fail
- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [functional improvement] Schema quality: unverified → excellent
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Tool coverage: unverified → 100
- [functional] Licence: MIT

### 2026-08-01 (score 5, −15)

- [functional regression] Tool coverage: 100 → unverified
- [functional] First check of Schema quality: unverified

### 2026-07-31 (score 20, −8)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 28, −18)

- [security regression] Malware scan: pass → unverified

### 2026-07-27 (score 46)

First indexed and scored.

## MCP tools (8)

### `godot_run_tests` (~136 tokens)

Run GUT or GdUnit4 tests headlessly and return structured pass/fail results. Auto-detects the test framework. Returns total/passed/failed counts with failure details including file paths and line numbers.

Input parameters:

- `framework` (string): Force specific framework (auto-detected if omitted)
- `inner_class` (string): Filter to specific inner test class
- `method` (string): Filter to specific test method name
- `script_path` (string): Filter to specific test script (e.g., res://tests/test_inventory.gd)
- `timeout` (number): Timeout in seconds (default: 60)

### `godot_search_docs` (~96 tokens)

Search Godot 4.x API documentation. Returns class overviews, method details, or fuzzy search results. Automatically detects Godot 3 API queries and suggests Godot 4 equivalents — the #1 source of AI-generated GDScript bugs.

Input parameters:

- `query` (string, required): Class name (e.g., 'CharacterBody2D'), method (e.g., 'CharacterBody2D.move_and_slide'), or search term

### `godot_get_diagnostics` (~84 tokens)

Get LSP diagnostics (errors, warnings) from Godot's built-in language server. Requires Godot editor to be running with the project open.

Input parameters:

- `path` (string): File path to get diagnostics for (e.g., scripts/player.gd). Omit for project-wide.
- `port` (number): LSP port (default: 6005)

### `godot_analyze_scene` (~94 tokens)

Parse .tscn scene files or .tres resource files and return structured analysis. Detects antipatterns (deep nesting, oversized scenes, missing scripts) and format errors (preload in .tres, custom class names in type field, integer resource IDs).

Input parameters:

- `path` (string, required): Path to .tscn or .tres file (e.g., res://scenes/main.tscn)

### `godot_analyze_script` (~96 tokens)

Analyse GDScript files for all 10 battle-tested pitfalls: Godot 3→4 API misuse, giant scripts, := on Variant, tight coupling, signal re-entrancy, autoload misuse, missing signal disconnect, _init() timing, Python-isms, and static func on autoloads.

Input parameters:

- `path` (string, required): Path to .gd file (e.g., res://scripts/player.gd)

### `godot_run_project` (~66 tokens)

Launch, stop, or get debug output from a running Godot project. Captures stdout/stderr with timestamps.

Input parameters:

- `action` (string, required): Action to perform
- `scene` (string): Scene to launch directly (e.g., res://scenes/main.tscn)

### `godot_screenshot` (~70 tokens)

Capture a viewport screenshot from the running Godot project. Returns base64-encoded PNG image. Requires a display server (not headless mode).

Input parameters:

- `scene` (string): Scene to capture (e.g., res://scenes/main.tscn). If omitted, captures the project's main scene.

### `godot_get_project_info` (~81 tokens)

Return project structure overview: project name, Godot version, scenes, scripts, autoloads, addons, and directory tree. Uses progressive disclosure — summary by default, full details on request.

Input parameters:

- `detail` (string): Level of detail: 'summary' (default) for counts and top-level dirs, 'full' for complete file listings

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/gregario-godot-forge/godot-forge#diagnostics

## Score history

- 2026-08-03: 65
- 2026-08-02: 65
- 2026-08-01: 5
- 2026-07-31: 20
- 2026-07-30: 28
- 2026-07-28: 46
- 2026-07-27: 46

## Links

- npm package: https://www.npmjs.com/package/godot-forge
- Socket report: https://socket.dev/npm/package/godot-forge
- Repository: https://github.com/gregario/godot-forge
- Changelog RSS feed: https://verifymcp.io/servers/gregario-godot-forge/godot-forge/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/gregario-godot-forge/godot-forge/changelog.json
- HTML version of this page: https://verifymcp.io/servers/gregario-godot-forge/godot-forge