Skip to content
HQ
Sports Data HQ

Documentation

API reference for REST and MCP access. 12 endpoints, pay-as-you-go credits.

Getting Started

Authentication

Include your API key in the Authorization header for REST, or configure it in your MCP client settings. All endpoints require authentication.

Base URL

REST: https://api.sportsdatahq.com/v1 MCP: https://mcp.sportsdatahq.com

Rate Limits

Free accounts: 10 requests/minute. Paid accounts: 60 requests/minute. Enterprise: custom limits available.

MCP Setup

Claude Desktop

{
  "mcpServers": {
    "sportsdatahq": {
      "url": "https://mcp.sportsdatahq.com"
    }
  }
}

Claude Code

claude mcp add sportsdatahq https://mcp.sportsdatahq.com

Endpoints

list_teams1 credit

All 34 franchises with divisions, conferences, status

get_games5 credits

Query by date, team, season, game state, or type

get_schedule2 credits

Upcoming games for next N days

get_game_detail10 credits

Full game detail with odds + goalie starts

get_head_to_head10 credits

Matchup history with win/loss records

search_players2 credits

Find players by name, team, or position

get_player_stats5 credits

Season stats for skaters and goalies

get_goalie_stats5 credits

Leaderboard sorted by save%, GAA, GSAX, wins

get_standings2 credits

Current standings with advanced stats

get_team_stats5 credits

Detailed stats for a specific team with advanced metrics

get_odds10 credits

Odds by game with bookmaker filters

get_line_movement25 credits

Time-series odds grouped by bookmaker

Full API reference coming soon

Detailed parameter schemas, response examples, and integration guides.

Get API Key to Start Building