@scoreflow/mcp

@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Ü.