clintplay-mcp

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

Install

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

# Or install globally
npm install -g clintplay-mcp

Configuration

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

{
  "mcpServers": {
    "clintplay": {
      "command": "npx",
      "args": ["-y", "clintplay-mcp"],
      "env": {
        "CLINTPLAY_PAT": "cp_pat_...",
        "CLINTPLAY_API_URL": "https://api.clintplay.example"
      }
    }
  }
}

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

Environment variables

| Variable | Required | Default | Description | |---|---|---|---| | CLINTPLAY_PAT | Yes | — | Personal access token (cp_pat_* format). Generate one in Settings. | | CLINTPLAY_API_URL | No | https://api.clintplay.example | API base URL. |

Local development

Point the server at a locally-running API:

CLINTPLAY_API_URL=http://localhost:3001 CLINTPLAY_PAT=cp_pat_... npx clintplay-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.