Back to Browse

Statpad MCP Server

Developer ToolsModerate7.7MCP RegistryLocal
Free

Server data from the Official MCP Registry

Live NFL, NBA, NHL, college football and basketball, and European soccer scores and play-by-play.

About

Live NFL, NBA, NHL, college football and basketball, and European soccer scores and play-by-play.

Security Report

7.7
Moderate7.7Low Risk

The Statpad MCP server is a read-only sports data client with no shell execution, file I/O, or hardcoded credentials. The API key is read from an environment variable, format-checked at startup, sent only in the Authorization header, and redacted from tool output. The main concern is a low-severity configurable base URL that could send the key to an arbitrary host if the environment is tampered with. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

12 files analyzed · 5 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

A Statpad API key from the Keys page at https://app.statpad.dev. Use a dedicated key.Required

Environment variable: STATPAD_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@statpad/mcp@0.1.2"
      ],
      "env": {
        "STATPAD_API_KEY": "your-statpad-api-key-here"
      }
    }
  }
}

Some servers take additional arguments. See the repository for details.

Documentation

View on GitHub

From the project's GitHub README.

@statpad/mcp

CI License: MIT

An MCP server that lets AI agents read Statpad, a live sports data API. Connect it to Claude, Cursor or any MCP client, and the agent can look up schedules, live scores and game situations, play-by-play, drives and box scores for the leagues on your plan.

It runs on your computer over stdio, needs Node.js 20 or later, and only reads data.

Get a key

Create an API key on the Keys page of your Statpad account. Create a new key for the MCP server instead of reusing one from an app. Every key on an account shares one request rate and one monthly allowance, so an agent that makes many calls slows down your production apps too. A key of its own lets you see its usage on the Keys page, and revoke it without touching anything else.

Set it up

Each client below starts the server with npx, which downloads the package the first time. Replace sporty_... with your key.

Claude Code

claude mcp add statpad -e STATPAD_API_KEY=sporty_... -- npx -y @statpad/mcp

Claude Desktop

Open Settings, then Developer, then Edit Config, and add the server to claude_desktop_config.json:

{
  "mcpServers": {
    "statpad": {
      "command": "npx",
      "args": ["-y", "@statpad/mcp"],
      "env": { "STATPAD_API_KEY": "sporty_..." }
    }
  }
}

Restart Claude Desktop after you save the file.

Cursor

Add the server to ~/.cursor/mcp.json for every project, or to .cursor/mcp.json in one project:

{
  "mcpServers": {
    "statpad": {
      "command": "npx",
      "args": ["-y", "@statpad/mcp"],
      "env": { "STATPAD_API_KEY": "sporty_..." }
    }
  }
}

Don't commit a project's .cursor/mcp.json with a key in it.

Other clients

Any client that launches stdio servers works. The command is npx -y @statpad/mcp, and the server reads its key from the STATPAD_API_KEY environment variable. On Windows, a client that can't find npx may need the command cmd with the arguments /c npx -y @statpad/mcp.

The server checks the key's format when it starts. If STATPAD_API_KEY is missing or isn't shaped like a Statpad key, the server prints why and exits, and your client shows it as failed to start.

Tools

ToolWhat it returns
list_leaguesThe leagues your key can read, with each league's alias, name, sport and level.
find_teamsTeams in one league and their ids, matched by name, city or abbreviation, ignoring case and accents.
find_gamesOne league's games for a day, a time range of up to 31 days, or the games live right now, with ids, status, start time, teams and scores. It can narrow to one team.
get_gameOne game's status, score and live situation, such as period, clock, possession, and down and distance, with the time Statpad last updated it.
get_box_scorePlayer stat lines grouped by category, filtered by team, player or category.
get_playsThe latest plays, the scoring plays or the drives, and what changed since an earlier call.

Statpad covers the NFL, NBA, NHL, NCAA football and men's basketball, the Premier League, LaLiga, Bundesliga, Serie A and Ligue 1. list_leagues returns the leagues your plan includes, and the agent checks it instead of assuming.

Ask questions in your own words, such as "What's the score of the Bills game?", "Who led the Vikings in receiving on Sunday?" or "What happened on the last drive?". The agent picks the tools.

What isn't available yet

Statpad doesn't serve these yet. The server's instructions list them, so the agent tells you they're unavailable instead of guessing:

  • standings
  • injuries and transactions
  • team rosters and depth charts
  • betting odds
  • season stats and league leaders
  • player profiles and player search
  • team totals and score by period in box scores

For a team total, the agent can add up player lines, and it says when it did. Statpad started collecting each league in November 2026, so earlier games aren't there. Statpad lists every game the league has published with both teams known, through the end of its season, so you can ask about upcoming games too.

Limits and budgets

The server keeps each tool call small, so an agent can't run up your usage by accident:

  • A tool call sends at most 3 requests to Statpad, and gives up after 10 seconds.
  • The server retries a failed request once, and never retries a quota_exhausted answer.
  • A result aims for about 2,000 tokens and never goes past about 6,000. When it trims a list, it says so and tells the agent how to ask for the rest, such as filtering a box score by team.
  • When less than 5% of your monthly allowance is left, every result carries a warning that the agent passes on to you.

Every request the server sends counts against your plan like any other request, including one that answers 304. The rate limits guide explains the rate and the allowance.

Privacy

The server runs on your computer. Your key stays in your MCP client's configuration and in the server's environment. The server sends the key only to api.statpad.dev, in the Authorization header, and never puts it in a tool result or a log line. It logs one line per tool call to stderr, with the tool name, request count, duration and size, and never the arguments or the data. At the debug level it also logs each request's path, which holds the league and any game or team id the tool asked for, but never its query string.

The agent's questions and the data it reads go to whichever AI model your client uses, under that client's terms.

Docs search

To let an agent search the Statpad documentation, add the separate docs MCP server at https://statpad.dev/docs/_mcp/server. It needs no key. For example, in Claude Code:

claude mcp add --transport http statpad-docs https://statpad.dev/docs/_mcp/server

Troubleshooting

ResultWhat to do
unauthorizedStatpad doesn't accept the key. Copy a current key from the Keys page into STATPAD_API_KEY and restart the client.
forbiddenThe key can't read that league. Either your plan doesn't include it, or the alias is wrong. list_leagues shows what the key can read.
rate_limitedThe account is sending requests too fast, perhaps from another app. Wait a few seconds.
quota_exhaustedThe account used this month's allowance. The result says when it renews, or you can upgrade the plan.

Set STATPAD_MCP_LOG=debug in the server's environment to also log every request the server sends to Statpad, retries included, with its method, path, status, duration and request ID, in your client's MCP log. Set it to off to silence the log. Any other value logs at info, and the server warns about it when it starts.

Versioning

The server follows semantic versioning. Until 1.0, a minor release can change tool names, arguments and results. npx -y @statpad/mcp runs the latest release, so pin a version such as @statpad/mcp@0.1 if you need a fixed one.

Support

Report bugs in GitHub issues. For questions about the API, your account or your data, see the Statpad docs. To change the server itself, read CONTRIBUTING.md.

License

MIT

Reviews

No reviews yet

Be the first to review this server!