Glitchless MCP logo

Glitchless MCP

MCP tools for inspecting real-player game performance, crashes, funnels, version changes, and bug reports.

Install Glitchless MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "glitchless-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "glitchless-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

glitchless-mcp MCP server gives coding agents access to Glitchless game-observability data from real player sessions. Its tools cover triage, performance, errors, player funnels, version comparisons, and bug reports, with related playtest automation available in the wider project. Reach for it when an agent needs production evidence to diagnose a game issue and check whether a change improved it. Glitchless runs on Node 20+ with a file store, either locally or in a server environment.

Use cases

  • Triage crashes and errors from real player sessions
  • Compare performance across game releases
  • Find levels where players abandon a game
  • Review opt-in player bug reports
  • Validate fixes with automated playtests

Key features

  • Player-session observability over MCP
  • Performance and hitch investigation
  • Crash and error retrieval
  • Funnel and version comparison tools
  • Bug report inspection
  • Optional automated playtest checks

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars5Stargazers on the source repository.
npm downloads5.5kPackage downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.

How Glitchless MCP works

What glitchless-mcp does

Glitchless connects game telemetry to coding-agent workflows. Instrumented games send player-session data to Glitchless, where the server provides queryable findings about performance, crashes, player progression, and feedback. Agents can then inspect those findings through MCP rather than relying only on local reproduction.

The broader Glitchless project supports Unity 6.0 LTS and later, Godot 4.5+, Unreal Engine 5.8 and later, GameMaker 2024.2+, Roblox, and browser games built with Three.js, Phaser, Babylon.js, or PlayCanvas. The SDK records signals such as frame timing, hitch causes, errors, levels, crashes, and player behavior. Bug reports can include a screenshot, level, and session when players opt in.

How it works

The MCP package sits alongside Glitchless's intake and query API. A game uses the relevant Glitchless SDK or engine integration to send anonymous-by-default telemetry. The MCP server exposes selected production data to an agent, which can use it to identify issues, inspect context, and compare releases.

The repository also includes WebMCP tools exposed by the running game and a playtest package with autoplay bots. Those components serve different parts of the workflow: MCP queries collected player data, while WebMCP and playtesting can help an agent interact with or validate a running build. The server can run anywhere Node runs, including a laptop, VPS, or container, and uses a file store without npm dependencies.

Setup and configuration

Run the server from the repository with npm run server. The server requires Node 20 or newer. Glitchless can be used with Glitchless Cloud, which includes a free allowance of 5,000 play sessions per month, or self-hosted using the open-source server and its file store.

Game-specific setup is handled by the corresponding SDK or engine package. Unity is installed by git URL; Godot, Unreal, GameMaker, and Roblox each have their own integration paths in the repository. Browser games can use the SDK and framework adapters. Source maps can be uploaded separately with the glitchless-sourcemaps CLI or Vite plugin so minified errors identify their original function, file, and line.

Tools and capabilities

The MCP package includes tools for:

  • Triage and ranked findings with glitchless_triage.
  • Performance investigation with glitchless_performance.
  • Retrieving an individual error with glitchless_get_error.
  • Examining progression through glitchless_player_funnel.
  • Comparing releases with glitchless_compare_versions.
  • Reviewing submitted feedback with glitchless_bug_reports.
  • Running automated build checks through the related glitchless_playtest tool.

Available telemetry can include frame hitches and likely causes, grouped errors with preceding gameplay, death heatmaps, level funnels, quit behavior, and session data. The project can also forward the same data to Datadog or an OpenTelemetry backend.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Glitchless MCP

glitchless-mcp is an MCP server that connects coding agents to Glitchless game-observability data from real player sessions. Its main tools cover triage, performance, individual errors, player funnels, version comparisons, and bug reports, helping agents investigate game issues with production telemetry.

Run the server from the Glitchless repository with `npm run server` on Node 20 or newer. It uses a file store and can run locally, on a VPS, or in a container.

glitchless-mcp works with telemetry from Unity 6.0 LTS and later, Godot 4.5+, Unreal Engine 5.8 and later, GameMaker 2024.2+, Roblox, and browser games using Three.js, Phaser, Babylon.js, or PlayCanvas.

Yes. The `glitchless_compare_versions` tool compares releases, while `glitchless_performance` and `glitchless_triage` help inspect performance and ranked findings from player data.

Yes. Cursor is named as a supported coding-agent client for Glitchless workflows, alongside Claude Code and Codex.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGlitchless MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/glitchless-mcp?style=directory)](https://allmcps.com/mcp/glitchless-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/glitchless-mcp"><img src="https://allmcps.com/api/badge/glitchless-mcp?style=directory" alt="Glitchless MCP on AllMCPs" /></a>