Skip to content

Connect a client

Every call to the MCP gateway should include:

HeaderValue
AuthorizationBearer <YOUR_PAT>
Acceptapplication/json, text/event-stream
Content-Typeapplication/json

If you see 406 (Client must accept text/event-stream), add Accept explicitly in Cursor headers.

Obtain YOUR_PAT via token exchange; do not paste secret_key here.

Settings → MCP, or ~/.cursor/mcp.json / project .cursor/mcp.json:

{
"mcpServers": {
"statscore-mcp": {
"url": "https://mcp.statscore.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_PAT",
"Accept": "application/json, text/event-stream"
}
}
}
}

Replace YOUR_PAT. Restart Cursor or reload MCP after saving.

Claude Desktop, Antigravity, stdio-only clients

Section titled “Claude Desktop, Antigravity, stdio-only clients”

Many clients do not speak Streamable HTTP natively. Use a local proxy such as supergateway with --streamableHttp and --header "Authorization: Bearer YOUR_PAT".

Full matrix (Windows paths, npx, Python proxy): see MCP client connection in the statscore-mcp repository.

After connect, the client lists tools such as:

ToolPurpose
sports_api_get_eventsMatches / events
sports_api_get_standingsLeague tables
sports_api_get_h2hHead-to-head
sports_api_get_lineupsLineups
sports_api_get_participantsTeams / athletes
sports_api_get_usageUsage telemetry

Parameters match Sports API concepts (sport_id, season_id, etc.). Tool names and availability can change between gateway releases - after connect, your MCP client's tool list is the source of truth, not a static table in these docs.

SymptomWhat to check
401 on /mcpPAT missing, wrong, or revoked
403 on dataValid PAT but missing contract entitlement - see below
406Add Accept header (see above)
429Rate limit on /mcp or on token exchange
502 on POST /api/v1/tokenSTATSCORE OAuth unreachable; retry, see Get a PAT
Client timeout on bare URLUse supergateway for non-HTTP-native clients

A 403 with a valid PAT (no 401) usually means the underlying Sports API would also refuse that data for your account. MCP tools mirror REST access: competitions, seasons, and feeds you have not licensed are not returned, even when authentication succeeds.

  1. Retry the same question with a REST access token from Get a token. If REST returns forbidden or empty where you expect data, the limit is contractual, not MCP-specific.
  2. To extend coverage, contact STATSCORE support or your account manager.