stat-api — Sports Data

Official10 toolsLive

by stat-api

NFL/NBA/MLB/NHL/PGA + DFS and prediction-market data. Browse free; query with a free API key.

Topics

mcpmcp-servernbanflprediction-marketssports-apisports-data

Captured live from the server via tools/list.

list_leagues

List every league/data group this API serves (nfl, nba, mlb, nhl, pga, dfs, kalshi, polymarket, reference) with table counts and availability. No credentials needed. Start here, then call list_tables.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

list_tables

List every queryable table in one league with a one-line summary each. No credentials needed. Follow with describe_table before querying.

Parameters

league

string

required

Raw schema

{
  "type": "object",
  "properties": {
    "league": {
      "type": "string",
      "enum": [
        "nfl",
        "nba",
        "mlb",
        "nhl",
        "pga",
        "dfs",
        "kalshi",
        "polymarket",
        "reference"
      ]
    }
  },
  "required": [
    "league"
  ],
  "additionalProperties": false
}

describe_table

Full contract for one table: fields with types and descriptions, the filters query_table accepts (with operators like __gte/__lte/__between/__like and required filter combinations), page-size limits, primary key, and a runnable example URL. No credentials needed. Always call this before query_table — filters not listed here are rejected.

Parameters

league	string	required
table	string	required

Raw schema

{
  "type": "object",
  "properties": {
    "league": {
      "type": "string",
      "enum": [
        "nfl",
        "nba",
        "mlb",
        "nhl",
        "pga",
        "dfs",
        "kalshi",
        "polymarket",
        "reference"
      ]
    },
    "table": {
      "type": "string"
    }
  },
  "required": [
    "league",
    "table"
  ],
  "additionalProperties": false
}

query_table

Query any table. Returns `{"<table>": [rows], "limit": N, "next_from_id": M|null}`; page by re-calling with from_id set to the previous next_from_id until it is null. filters is a flat object of `field` or `field__op` keys from describe_table (e.g. {"season_id": 2024, "day__between": "20250101,20250131"}). Requires an API key (Authorization: Bearer <key>; free tier at https://stat-api.com). Every returned row counts against the monthly record quota.

Parameters

league	string	required
table	string	required
filters	object	optional	field or field__op keys → scalar values; see describe_table
limit	integer	optional
from_id	integer	optional	keyset cursor from next_from_id

Raw schema

{
  "type": "object",
  "properties": {
    "league": {
      "type": "string",
      "enum": [
        "nfl",
        "nba",
        "mlb",
        "nhl",
        "pga",
        "dfs",
        "kalshi",
        "polymarket",
        "reference"
      ]
    },
    "table": {
      "type": "string"
    },
    "filters": {
      "type": "object",
      "description": "field or field__op keys → scalar values; see describe_table",
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    },
    "limit": {
      "type": "integer",
      "minimum": 1
    },
    "from_id": {
      "type": "integer",
      "description": "keyset cursor from next_from_id"
    }
  },
  "required": [
    "league",
    "table"
  ],
  "additionalProperties": false
}

get_record

Fetch a single row by primary key. Returns the row object. Requires an API key; costs 1 record of quota.

Parameters

league	string	required
table	string	required
id	string	required	primary-key value (integer or text PK)

Raw schema

{
  "type": "object",
  "properties": {
    "league": {
      "type": "string",
      "enum": [
        "nfl",
        "nba",
        "mlb",
        "nhl",
        "pga",
        "dfs",
        "kalshi",
        "polymarket",
        "reference"
      ]
    },
    "table": {
      "type": "string"
    },
    "id": {
      "type": "string",
      "description": "primary-key value (integer or text PK)"
    }
  },
  "required": [
    "league",
    "table",
    "id"
  ],
  "additionalProperties": false
}

search_players

Fuzzy player-name search (typo-tolerant). Currently NBA only — for other leagues query the players table with a name filter via query_table. Returns player rows ordered by match quality. Requires an API key; rows count against quota.

Parameters

name	string	required
league	string	optional
limit	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100
    },
    "league": {
      "type": "string",
      "enum": [
        "nba"
      ],
      "default": "nba"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "required": [
    "name"
  ],
  "additionalProperties": false
}

games_on_date

Games scheduled/played on one calendar date (US-Eastern) for nba, mlb, or nhl; defaults to today. Returns the same envelope as query_table on the games table. NFL is week-based, not date-based — for nfl, use query_table on nfl/games with season_id + week filters instead. Requires an API key; rows count against quota.

Parameters

league	string	required
date	string	optional	YYYY-MM-DD; defaults to today in US-Eastern time

Raw schema

{
  "type": "object",
  "properties": {
    "league": {
      "type": "string",
      "enum": [
        "nba",
        "mlb",
        "nhl"
      ]
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "YYYY-MM-DD; defaults to today in US-Eastern time"
    }
  },
  "required": [
    "league"
  ],
  "additionalProperties": false
}

game_markets

Prediction-market contracts attached to one sporting event: Kalshi events+markets and/or Polymarket events+markets linked via (league_code, competition_id). game_id is the game's id from the league's games table (golf: the tournament id). Returns `{"kalshi": {events, markets}, "polymarket": {events, markets}}` (only the requested sources). Requires an API key; all returned rows count against quota.

Parameters

league	string	required
game_id	integer	required
source	string	optional	omit for both

Raw schema

{
  "type": "object",
  "properties": {
    "league": {
      "type": "string",
      "enum": [
        "nfl",
        "nba",
        "mlb",
        "nhl",
        "golf"
      ]
    },
    "game_id": {
      "type": "integer"
    },
    "source": {
      "type": "string",
      "enum": [
        "kalshi",
        "polymarket"
      ],
      "description": "omit for both"
    }
  },
  "required": [
    "league",
    "game_id"
  ],
  "additionalProperties": false
}

graphql_query

Run a GraphQL query against the same data with relations — nest from a game to its teams/players/odds in one call. Root fields are leagues (nfl, nba, …), each exposing its tables with the same filter arguments as REST plus `first`/`after` pagination. Do NOT send introspection queries (the schema is huge) — use describe_table instead; the SDL is at https://api.stat-api.com/api/v1/graphql/sdl. Requires an API key; every row resolved anywhere in the tree counts against quota.

Parameters

query	string	required
variables	object	optional

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string"
    },
    "variables": {
      "type": "object"
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

api_usage

Your key's quota position: plan, monthly record limit, records used, remaining, and when the quota resets. Requires an API key; costs 1 record.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

README.md3 KBView on GitHub

STAT API — Sports Data MCP Server

Remote MCP server (streamable HTTP) for stat-api.com: NFL, NBA, MLB, NHL, and PGA data — players, games, box scores, play-by-play — plus DFS salaries/slates and prediction-market prices from Kalshi and Polymarket.

Endpoint: https://api.stat-api.com/mcp

Listed in the official MCP Registry as com.stat-api/sports-data.

Setup

Works anonymously out of the box; add a free API key to unlock the data tools.

Claude Code

bash

claude mcp add --transport http stat-api https://api.stat-api.com/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>"

JSON config (Claude Desktop, Cursor, and most other clients)

json

{
  "mcpServers": {
    "stat-api": {
      "type": "streamable-http",
      "url": "https://api.stat-api.com/mcp",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Omit the headers block to connect without credentials — the catalog tools still work, and the server tells you where to get a key when you call a data tool.

Tools

No credentials needed (browse the catalog):

Tool	What it does
`list_leagues`	All leagues/data groups (nfl, nba, mlb, nhl, pga, dfs, kalshi, polymarket, reference) with table counts
`list_tables`	Every queryable table in one league, one-line summary each
`describe_table`	Full contract for a table: fields, types, accepted filters and operators, page limits, a runnable example

Free API key required (get one at stat-api.com):

Tool	What it does
`query_table`	Query any table with filters (`field__gte`, `__between`, `__like`, …) and keyset pagination
`get_record`	Fetch a single row by primary key
`search_players`	Typo-tolerant player-name search
`games_on_date`	Games on one calendar date (US-Eastern)
`game_markets`	Kalshi/Polymarket contracts linked to a specific game
`graphql_query`	Relational queries — game → teams → players → odds in one call
`api_usage`	Your key's plan, quota used/remaining, and reset date

Data coverage

NFL / NBA / MLB / NHL / PGA — teams, players, games, box scores, play-by-play, odds, injuries, news
DFS — DraftKings/FanDuel slates, salaries, contest results
Prediction markets — Kalshi and Polymarket events, markets, prices, and trades, linked to the underlying games

~200 tables total. list_leagues → list_tables → describe_table walks the whole catalog.

Other access methods

REST — OpenAPI 3.1 spec · interactive docs
GraphQL — POST https://api.stat-api.com/api/v1/graphql · SDL · IDE
Clients — @sports-db/client (npm) · sports-db (PyPI)

Install

Tools (10)

list_leagueslist_tablesdescribe_tablequery_tableget_recordsearch_playersgames_on_dategame_markets

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.stat-api.com/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "sports-data": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.stat-api.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Topics

list_leagues

list_tables

describe_table

query_table

get_record

search_players

games_on_date

game_markets

graphql_query

api_usage

STAT API — Sports Data MCP Server

Setup

Claude Code

JSON config (Claude Desktop, Cursor, and most other clients)

Tools

Data coverage

Other access methods

Links

Install

Remote endpoint