MCP Server

Point any Model Context Protocol client at stat-api and it can browse the catalog and query every sport directly — no glue code. Same data, auth, and metering as the REST and GraphQL APIs.

Endpoint

Streamable HTTP transport, JSON over POST, protocol version 2025-06-18. Stateless — no session to manage.

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

Connect

Claude Code

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

The --header is optional: omit it to browse the catalog anonymously; add your key to run the data tools.

ChatGPT or any custom MCP client

Drop this server entry into your client's MCP config (clients nest it under their own mcpServers key):

{
  "url": "https://api.stat-api.com/mcp",
  "headers": { "Authorization": "Bearer YOUR_API_KEY" }
}

Claude.ai custom connector

Settings → Connectors → Add custom connector, then paste https://api.stat-api.com/mcp as the remote MCP server URL and add your API key.

Tools

Browse — no key required

The catalog tools are anonymous and unmetered, so a client can discover the whole API before you hand it a key.

Tool	What it does
list_leagues	List every league and how many tables it exposes.
list_tables	List the tables in a league, each with a one-line summary.
describe_table	Full schema for a table: fields, filters, pagination, and an example URL.

Query — API key required

These read data and need an Authorization: Bearer <key> header. Rows are metered against your monthly quota exactly like REST — each response reports your position in x-quota-* headers.

Tool	What it does
query_table	Paginated, filterable query against any table.
get_record	Fetch a single row by its primary key.
search_players	Find players by name within a league.
games_on_date	List the games scheduled on a given date.
game_markets	Betting lines and prediction-market prices for a game.
graphql_query	Run a GraphQL query — nested relations resolved in one call.
api_usage	Your current monthly quota: records used and remaining.

Get a key

The free tier covers 50,000 records a month across every sport — enough to wire up a client and explore. Grab a key on the pricing page.