ghostplay-mcp

Ghostplay MCP server for Claude Code and other MCP clients. Gives AI agents read/write access to Ghostplay session recordings, errors, analytics, and more.

Install

# One-shot via npx (no install needed)
npx -y ghostplay-mcp

# Or install globally
npm install -g ghostplay-mcp

Configuration

Claude Code MCP config (~/.claude/claude_desktop_config.json)

{
  "mcpServers": {
    "ghostplay": {
      "command": "npx",
      "args": ["-y", "ghostplay-mcp"],
      "env": {
        "GHOSTPLAY_PAT": "gp_pat_...",
        "GHOSTPLAY_API_URL": "https://api.ghostplay.dev"
      }
    }
  }
}

Generate a PAT at Ghostplay dashboard → Settings → Personal Access Tokens.

Environment variables

| Variable | Required | Default | Description | |---|---|---|---| | GHOSTPLAY_PAT | Yes | — | Personal access token (gp_pat_* format). Generate one in Settings. | | GHOSTPLAY_API_URL | No | https://api.ghostplay.dev | API base URL. |

Local development

Point the server at a locally-running API:

GHOSTPLAY_API_URL=http://localhost:3001 GHOSTPLAY_PAT=gp_pat_... npx ghostplay-mcp

Available tools

36 tools across six categories:

• Discovery — list projects, list sessions, get session details
• Granular reads — session events, errors, analytics, jobs
• Cross-session analysis — aggregate queries, trend detection
• Annotations / share / links — create annotations, share sessions, manage links
• Execution — extract repro steps, replay, run sandbox queries
• Meta — whoami (GET /v1/mcp/whoami)

Plus 7 URI-addressable resources and 6 prompt runbooks.

License

MIT — see LICENSE.