stat-api — Sports Data

Working · 2.9 s

com.stat-api/sports-datav1.0.1 Domain verified

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

Entertainment & Games

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

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

Authorization (optional)

Bearer <api-key> — required for data tools; catalog tools (list_leagues, list_tables, describe_table) work anonymously. Free tier at https://stat-api.com

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

api_usage Read-only

Your account's quota position: plan, monthly record limit, records used, remaining, and when the quota resets. Requires a stat-api sign-in or API key; costs 1 record.

This tool takes no arguments.

Tools (9)

api_usage

Your account's quota position: plan, monthly record limit, records used, remaining, and when the quota resets. Requires a stat-api sign-in or API key; costs 1 record.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {},
  "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.

read-only

Argument	Type	Description
table*	string
league*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "league",
    "table"
  ],
  "properties": {
    "table": {
      "type": "string"
    },
    "league": {
      "enum": [
        "nfl",
        "nba",
        "mlb",
        "nhl",
        "pga",
        "dfs",
        "reference"
      ],
      "type": "string"
    }
  },
  "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 a stat-api sign-in or API key; rows count against quota.

read-only

Argument	Type	Description
date	string	YYYY-MM-DD; defaults to today in US-Eastern time
league*	string

Input schema (JSON)

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

get_record

Fetch a single row by primary key. Returns the row object. Requires a stat-api sign-in or API key; costs 1 record of quota.

read-only

Argument	Type	Description
id*	string	primary-key value (integer or text PK)
table*	string
league*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "league",
    "table",
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "primary-key value (integer or text PK)"
    },
    "table": {
      "type": "string"
    },
    "league": {
      "enum": [
        "nfl",
        "nba",
        "mlb",
        "nhl",
        "pga",
        "dfs",
        "reference"
      ],
      "type": "string"
    }
  },
  "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 a stat-api sign-in or API key; every row resolved anywhere in the tree counts against quota.

read-only

Argument	Type	Description
query*	string
variables	object

Input schema (JSON)

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

list_leagues

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

read-only

No arguments.

Input schema (JSON)

{
  "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.

read-only

Argument	Type	Description
league*	string

Input schema (JSON)

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

query_table

Query any table. Returns `{"<table>": [rows], "limit": N, "next_from_id": M|null, "has_more": bool}`. To read every row, start with from_id=0 and re-call with from_id set to the previous next_from_id until it is null. A call without from_id returns the first page in the table's default sort with next_from_id 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 a stat-api account: sign in when the app asks (free account at https://stat-api.com), or send an API key as Authorization: Bearer <key>. Every returned row counts against the monthly record quota.

read-only

Argument	Type	Description
limit	integer
table*	string
league*	string
filters	object	field or field__op keys → scalar values; see describe_table
from_id	integer	keyset cursor: 0 for the first page of a full walk, then the previous next_from_id

Input schema (JSON)

{
  "type": "object",
  "required": [
    "league",
    "table"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1
    },
    "table": {
      "type": "string"
    },
    "league": {
      "enum": [
        "nfl",
        "nba",
        "mlb",
        "nhl",
        "pga",
        "dfs",
        "reference"
      ],
      "type": "string"
    },
    "filters": {
      "type": "object",
      "description": "field or field__op keys → scalar values; see describe_table",
      "additionalProperties": {
        "type": [
          "string",
          "number",
          "boolean"
        ]
      }
    },
    "from_id": {
      "type": "integer",
      "description": "keyset cursor: 0 for the first page of a full walk, then the previous next_from_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 a stat-api sign-in or API key; rows count against quota.

read-only

Argument	Type	Description
name*	string
limit	integer
league	string

Input schema (JSON)

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