isco-tec/scorezilla-mcp

Official Model Context Protocol (MCP) server for Scorezilla — the easiest way to add a leaderboard to your game. Connect this server to your AI coding assistant (Claude Code, Cursor, Continue.dev, …) and ship a working leaderboard without leaving your editor.
What you can ask the AI to do
- "Add a leaderboard to my game" → it bootstraps a game + board and pastes ready-to-run TypeScript SDK code into your project
- "What did my last test score rank?" → it reads your live leaderboard
- "List my games" / "show me the boards on X" → it inspects what you already have
Eleven tools total — five read-only, and six that write: four that create resources (bootstrap_leaderboard, create_game, create_board, mint_key) plus two that update config (update_board_config — score bounds + retention, e.g. an anti-cheat maxScore; update_game_config — the browser-submit origin allowlist).
Install + configure
> **Access — open to every Scorezilla account.** Sign up free at dashboard.scorezilla.dev, create a token, and go. Creating games and boards counts toward your plan's limits (Free: 2 games × 3 boards each); when you hit one, the tool error includes a direct upgrade link. See pricing.
1. Get a token
Sign in at dashboard.scorezilla.dev, open **MCP tokens**, click **Create token**. Copy the mcp_live_* value once — it's not shown again.
2. Add the server to your AI coding assistant
**Claude Code** — edit ~/.claude/settings.json:
> 🔒 **Keep ~/.claude/settings.json private.** The token is stored in plaintext in that file. Make sure it's not committed to git (it's usually in your .gitignore), not synced to a public dotfiles repo, and not backed up to a shared location. On macOS/Linux: chmod 600 ~/.claude/settings.json so only your user can read it. If a token leaks, revoke it at dashboard.scorezilla.dev/account/tokens.
**Cursor** — open Settings → Features → MCP → Add new MCP server, then use the same command + args + env shape.
**Anything else MCP-compatible** — point your client at npx -y @scorezilla/mcp with SCOREZILLA_TOKEN set in the environment.
3. Ask away
In Claude Code or Cursor: _"Add a Scorezilla leaderboard to this game."_
Tools
| Tool | What it does |
|---|---|
| list_games | Lists your games. Use this first to orient. |
| list_boards | Lists leaderboards under a game. |
| get_keys | Returns the public key (safe to embed) and the secret-key prefix. The full secret never leaves the dashboard. |
| get_board_top_n | Returns the top entries on a board. The "is my integration working?" tool. |
| get_sdk_snippet | Returns ready-to-paste integration code for a board. Optional axis args tailor it: anonymous/OAuth identity, client-only vs. server-validated **anti-cheat**, and the server language (TS/Python/Go/C#). |
| bootstrap_leaderboard | Creates a new game + first board in one call, then returns the **widget embed** + **SDK snippet** + a plain-English recommendation. Same optional axis args (anti-cheat, OAuth, server language). The 90-second-demo path. |
| create_game | Creates a new (empty) game. Use when a game already exists (so bootstrap_leaderboard would conflict) or you want another. |
| create_board | Adds a leaderboard board to an **existing** game (by gameId), with full options (sortDir, scoreKind, retention, bounds). |