# MCP

> MCP is a freemium MCP server for games and play. Ask Claude Code or Cursor to add a global leaderboard to your game with Scorezilla. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI
- **Repository:** https://github.com/isco-tec/scorezilla-mcp
- **MCP Registry name:** io.github.isco-tec/mcp
- **Categories:** [games and play](https://ai-powered.com/categories/games-and-play), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

Scorezilla's official server turns leaderboard setup into a prompt. It has eleven tools: five read-only (`list_games`, `list_boards`, `get_keys`, `get_board_top_n`, `get_sdk_snippet`) and six that write (`bootstrap_leaderboard`, `create_game`, `create_board`, `mint_key`, `update_board_config`, `update_game_config`). The bootstrap tool creates a game and first board, then returns an embeddable widget, SDK snippet and recommendation.

Snippets can be tailored for anonymous or OAuth identity, client-only or server-validated anti-cheat, and TypeScript, Python, Go or C# servers. Boards can be all-time or reset daily in UTC, with score bounds and retention. Create calls send an idempotency key, so a retry within five minutes returns the original result.

A `SCOREZILLA_TOKEN` from the dashboard is required. The Free plan allows 2 games with 3 boards each, and over-limit errors include an upgrade link. A `--read-only` flag removes the write tools.

## Features

- **One-call bootstrap:** Creates a game and board and returns embed and SDK code.
- **Anti-cheat options:** Snippets for client-only or server-validated scores, with maxScore bounds.
- **Daily boards:** Boards that start empty each UTC day.
- **Read-only mode:** A flag blocks all write tools.
- **Safe retries:** Create tools use idempotency keys.

## Good for

- Add a leaderboard to a browser game in minutes
- Check what your last test score ranked
- Set an anti-cheat score ceiling
- Create a daily challenge board

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp --env SCOREZILLA_TOKEN='<SCOREZILLA_TOKEN>' -- npx -y @scorezilla/mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@scorezilla/mcp"
      ],
      "env": {
        "SCOREZILLA_TOKEN": "<SCOREZILLA_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `list_games`: List your games.
- `list_boards`: List boards under a game.
- `get_keys`: Return the public key and secret-key prefix.
- `get_board_top_n`: Return top entries on a board.
- `get_sdk_snippet`: Return integration code for a board.
- `bootstrap_leaderboard`: Create a game and first board with widget and SDK code.
- `create_game`: Create a new game.
- `create_board`: Add a board to an existing game.
- `mint_key`: Mint a new key pair for a game.
- `update_board_config`: Change score bounds and retention.
- `update_game_config`: Set the browser-submit origin allowlist.

## FAQ

### What do I need to start?

A free Scorezilla account and an MCP token from the dashboard.

### What are Free plan limits?

2 games with 3 boards each.

### Can I stop it creating things?

Yes, start it with --read-only.

### Does it return my secret key?

No, secrets stay in the dashboard; mint_key shows a new one once.

### Is MCP free?

MCP has a free plan, with paid plans for more usage or features.

### How do I add MCP to Claude Code?

Run this command in your terminal: claude mcp add mcp --env SCOREZILLA_TOKEN='<SCOREZILLA_TOKEN>' -- npx -y @scorezilla/mcp

### What are the best alternatives to MCP?

The closest alternatives to MCP are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/mcp-mweo9xu3
