# Godot GDScript Diagnostics

> Use this tool when you need to validate GDScript code syntax in real-time, without a full Godot installation, to identify errors and ensure code quality. It solves problems such as syntax checking and error detection, providing outputs including diagnostic reports and error messages through a simple interface that accepts GDScript code files as input. Ideal for developers seeking programmatic access to GDScript syntax validation in their development workflows.

Canonical page: https://skillsregistry.net/skills/ryanmazzolini-godot-gdscript-diagnostics  
JSON: https://api.skillsregistry.net/v1/skills/ryanmazzolini-godot-gdscript-diagnostics

## Description

This MCP server provides real-time GDScript syntax validation by connecting directly to Godot's Language Server Protocol, enabling AI assistants to analyze and validate GDScript code without requiring a full Godot installation. Built with TypeScript and featuring automatic reconnection handling, it offers two core tools: single-file diagnostic checking and workspace-wide scanning that processes all .gd files while excluding addon directories. The implementation includes comprehensive path validation to prevent directory traversal attacks, supports both environment variable configuration and automatic port detection for Godot LSP connections, and maintains an in-memory diagnostic cache for efficient repeated queries, making it valuable for developers who need programmatic access to GDScript syntax checking and error detection in their development workflows.

## Trust

- **Trust score (0–1):** 0.88
- **Verification tier:** verified
- **Last scanned:** 2026-09-19

## Facts

- **Version:** 1.0.0
- **Skill type:** atomic
- **Execution layer:** mcp-remote
- **Runtime environment:** api
- **Category:** file-system
- **Updated:** 2026-09-19

## Source

- **Source listing:** [PulseMCP](https://www.pulsemcp.com/servers/ryanmazzolini-godot-gdscript-diagnostics)
- **Repository:** <https://github.com/ryanmazzolini/minimal-godot-mcp>

## Use it

Resolve this record through the SkillsRegistry MCP server (no auth, read-only):

```
claude mcp add --transport http --scope user skillsregistry https://api.skillsregistry.net/mcp
```

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_skill",
    "arguments": {
      "slug": "ryanmazzolini-godot-gdscript-diagnostics"
    }
  }
}
```

REST: `GET https://api.skillsregistry.net/v1/skills/ryanmazzolini-godot-gdscript-diagnostics` · pull for local use: `GET https://api.skillsregistry.net/v1/skills/ryanmazzolini-godot-gdscript-diagnostics/pull`

---
SkillsRegistry indexes agent skills from public registries and GitHub. Skills we have analysed are scanned with Circle-IR and scored on six dimensions; each listing states its scan coverage. More: https://skillsregistry.net/llms.txt