# isco-tec/scorezilla-mcp [Health: Active]

**Category:** 🎮 Gaming  
**Repository:** https://github.com/isco-tec/scorezilla-mcp  
**GitHub Stars:** 1  
**npm Downloads (last month):** 1950  
**Views:** 5  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/isco-tec-scorezilla-mcp

## Description
Provision and inspect leaderboards for Scorezilla. Six tools — including bootstrapleaderboard which creates a game + board + keys and returns ready-to-paste SDK code in one call. Closed beta; request a token at scorezilla.dev/early-access.

## Tools
Capabilities this server exposes over MCP:

- **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).
- **mint_key** — Mints a fresh public/secret key pair for an existing game. The secret is shown once.
- **update_board_config** — Changes a board's score bounds (e.g. an anti-cheat `maxScore`) and retention. Partial updates; `null` clears a bound.
- **update_game_config** — Sets a game's browser-submit origin allowlist (e.g. `https://yourgame.com`, `*.yourgame.com`). An empty list allows all origins.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "scorezilla-mcp": {
    "command": "npx",
    "args": ["-y","@scorezilla/mcp"],
    "env": {
      "SCOREZILLA_TOKEN": ""
    }
  }
}
```

**Requires environment variables:** `SCOREZILLA_TOKEN` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What isco-tec/scorezilla-mcp does

isco-tec/scorezilla-mcp exposes the Scorezilla API as MCP tools for game and leaderboard administration. It can inspect the games associated with a developer account, enumerate boards, read leaderboard results, create resources, manage keys, and adjust selected configuration settings.

The main setup shortcut is `bootstrap_leaderboard`. It creates a game and its first board in one operation, then returns a widget embed, an SDK code sample, and a plain-language recommendation. For an existing game, use the separate game and board creation tools instead. SDK output can be tailored for anonymous or OAuth identities, client-only or server-validated anti-cheat, and TypeScript, Python, Go, or C#.

## How it works

The server runs as a local stdio MCP process through `npx -y @scorezilla/mcp`. It sends requests to the Scorezilla API, which defaults to `https://api.scorezilla.dev`. Authentication uses the `SCOREZILLA_TOKEN` bearer token issued from the Scorezilla dashboard.

Write operations use an idempotency key derived from their arguments. If a create request times out and the same request is retried within five minutes, the API can return the original result rather than creating a duplicate. After a partial failure or an active slug conflict, inspect the account with `list_games` and `list_boards` before completing the setup with a narrower operation.

The process requires Node.js 20 or newer and network access to the Scorezilla API. A `--read-only` mode omits all resource-creation and configuration-update tools, which is useful for shared or CI client configurations.

## Setup and configuration

Create an MCP token in the Scorezilla dashboard, then pass it as `SCOREZILLA_TOKEN`. Claude Code can register the server with `claude mcp add`, while Cursor can load a server entry from its MCP configuration using `npx` and the token environment variable. Claude Desktop can install the `.mcpb` package from the latest GitHub release and enter the token during setup. Other MCP-compatible clients can launch the same npm command with the environment variable set.

The optional `SCOREZILLA_BASE_URL` variable changes the API origin. The equivalent `--base-url` flag takes precedence when both are supplied. `SCOREZILLA_BETA_TOKEN` is retained for compatibility but is no longer needed for access.

Treat the MCP token as a bearer credential. Keep it out of source control and shared configuration, and revoke it from the Scorezilla account if it is exposed. The server returns a public key and secret-key prefix through `get_keys`, but the full game secret remains available only from the dashboard.

## Tools and capabilities

- `list_games` and `list_boards` locate existing Scorezilla resources.
- `get_board_top_n` reads the leading entries on a board for integration checks.
- `get_sdk_snippet` produces integration code with identity, anti-cheat, and language options.
- `bootstrap_leaderboard` creates an initial game and board and returns embed and SDK material.
- `create_game` and `create_board` create resources separately.
- `mint_key` creates a new public and secret key pair; the secret is shown once.
- `update_board_config` changes score bounds and retention, including clearing a bound with `null`.
- `update_game_config` controls the browser-submit origin allowlist. An empty list permits all origins.

Board creation supports settings such as sort direction, score type, retention, and score bounds. Plan limits apply to game and board creation; failed limit checks return a `plan_limit` error and an upgrade link. Requests can also be rate-limited, with the response indicating when to retry.

## Limitations and notes

The server operates on the games visible to the token's issuing developer account. Creating games and boards consumes the account plan's quotas; the free plan allows two games with three boards per game. Nothing is billed automatically when a plan limit is reached.

The default API endpoint can be replaced for staging or self-hosted deployments with the command-line flag or environment variable. The server itself does not expose the full game secret through MCP, so integrations that need it must retrieve it from the Scorezilla dashboard. The MIT-licensed package is distributed through npm as `@scorezilla/mcp`.

_Full upstream README: https://allmcps.com/mcp/isco-tec-scorezilla-mcp/readme_