@scoreflow/mcp

Read-only Model Context Protocol server for Scoreflow — query your level, XP, achievements, and the global leaderboard from any MCP-compatible client (Claude Code, Claude Desktop, Cursor, Zed).

Install

If you already ran scoreflow init, the MCP server is registered automatically. Otherwise:

# Claude Code (user scope — available in every project)
claude mcp add scoreflow --scope user -- npx -y @scoreflow/mcp

For Claude Desktop, add this to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or the equivalent on other OSes:

{
  "mcpServers": {
    "scoreflow": {
      "command": "npx",
      "args": ["-y", "@scoreflow/mcp"]
    }
  }
}

Tools

| Tool | Auth | Description | |---|---|---| | scoreflow_status | yes | Your current level, XP, tier, skills, and achievements. | | scoreflow_leaderboard | yes | Global top-N by XP (default 20, max 100). | | scoreflow_profile | no | Any user's public profile by handle (scoreflow.dev/u/<handle>). | | scoreflow_explain_ccs | no | Breakdown of the Craftsmanship Score components. |

Auth

The MCP server loads the bearer token from ~/.scoreflow/config.json — the same file written by @scoreflow/cli during scoreflow init. Run that first.

Alternatively, set SCOREFLOW_API_TOKEN and SCOREFLOW_API_URL in your MCP client's env block for a token-only setup.

License

MIT. Infinite Labs OÜ.