Integration

BALLDONTLIE integration

BALLDONTLIE is a sports data API covering the NBA, NFL, MLB, NHL, WNBA and English Premier League: teams, players, games and live box scores, player and team stats (game, season and advanced), standings, injuries, play-by-play, lineups, betting odds and player props, daily fantasy slates, NFL fantasy projections and NBA contracts. Which tools answer depends on the plan bought for each sport: a free key reaches teams, players and games only, and a tier missing an endpoint answers 401. The opening-line odds variants, account and billing management and the other sports BALLDONTLIE sells are not exposed. Authentication is the account API key, sent as is in the Authorization header.

Connect BALLDONTLIE How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in BALLDONTLIE.Built from the 139 BALLDONTLIE tools below, on the connection you add once.

What you can do with BALLDONTLIE

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Team, 11 operations

epl_list_teamsEpl list teamsGETGet all teams participating in the English Premier League for a given season
mlb_get_teamMlb get teamGETReturns one MLB team. Fields include slug, abbreviation, display name, short display name, name, location, league, division.
mlb_list_teamsMlb list teamsGETReturns MLB teams. Fields include slug, abbreviation, display name, short display name, name, location, league, division. Filters: division, league.
nba_get_teamNba get teamGETReturns one NBA team. Fields include conference, division, city, name, full name, abbreviation.
nba_list_team_contractsNba list team contractsGETReturns all player contracts for a specific team and season. Season defaults to current season if not specified.
nba_list_teamsNba list teamsGETReturns NBA teams. Fields include conference, division, city, name, full name, abbreviation. Filters: division, conference.
nfl_get_teamNfl get teamGETReturns one NFL team. Fields include conference, division, location, name, full name, abbreviation.
nfl_list_teamsNfl list teamsGETReturns NFL teams. Fields include conference, division, location, name, full name, abbreviation. Filters: division, conference.
nhl_get_teamNhl get teamGETReturns one NHL team. Fields include full name, tricode, conference name, division name, season.
nhl_list_teamsNhl list teamsGETReturns NHL teams. Fields include full name, tricode, conference name, division name, season. Filters: conference, division. Paged with cursor and per_page.
wnba_get_teamWnba get teamGETReturns one WNBA team. Fields include conference, city, name, full name, abbreviation.

Player, 10 operations

epl_list_playersEpl list playersGETGet players with optional filtering by team or search term. Supports pagination.
mlb_get_playerMlb get playerGETReturns one MLB player. Fields include first name, last name, full name, debut year, jersey, college, position, active.
mlb_list_playersMlb list playersGETReturns MLB players. Fields include first name, last name, full name, debut year, jersey, college, position, active. Filters: team_ids, player_ids, search, first_name, last_name. Paged with cursor and per_page.
nba_get_playerNba get playerGETReturns one NBA player. Fields include first name, last name, position, height, weight, jersey number, college, country.
nba_list_player_contractsNba list player contractsGETReturns contracts for a specific player, optionally filtered by seasons. Supports pagination.
nba_list_playersNba list playersGETReturns NBA players. Fields include first name, last name, position, height, weight, jersey number, college, country. Filters: team_ids, player_ids, search, first_name, last_name. Paged with cursor and per_page.
nfl_get_playerNfl get playerGETReturns one NFL player. Fields include first name, last name, position, position abbreviation, height, weight, jersey number, college.
nfl_list_playersNfl list playersGETReturns NFL players. Fields include first name, last name, position, position abbreviation, height, weight, jersey number, college. Filters: team_ids, player_ids, search, first_name, last_name. Paged with cursor and per_page.
nhl_list_playersNhl list playersGETReturns NHL players. Fields include first name, last name, full name, position code, shoots catches, height in inches, weight in pounds, birth date. Filters: player_ids, team_ids, name, seasons. Paged with cursor and per_page.
wnba_get_playerWnba get playerGETReturns one WNBA player. Fields include first name, last name, position, position abbreviation, height, weight, jersey number, college.

Game, 8 operations

mlb_get_gameMlb get gameGETReturns one MLB game. Fields include home team name, away team name, home team, away team, season, postseason, season type, date.
mlb_list_gamesMlb list gamesGETReturns MLB games. Fields include home team name, away team name, home team, away team, season, postseason, season type, date. Filters: dates, team_ids, seasons, postseason, season_type. Paged with cursor and per_page.
nba_get_gameNba get gameGETReturns one NBA game. Fields include date, season, status, status state, period, time, period detail, datetime.
nba_list_gamesNba list gamesGETReturns NBA games. Fields include date, season, status, status state, period, time, period detail, datetime. Filters: dates, team_ids, seasons, season_type, start_date, end_date. Paged with cursor and per_page.
nfl_get_gameNfl get gameGETReturns one NFL game. Fields include updated at, visitor team, home team, summary, venue, week, date, season.
nfl_list_gamesNfl list gamesGETReturns NFL games. Fields include updated at, visitor team, home team, summary, venue, week, date, season. Filters: dates, team_ids, seasons, season_types, weeks. Paged with cursor and per_page.
nhl_list_gamesNhl list gamesGETReturns NHL games. Fields include season, game date, start time utc, home team, away team, home sog, away sog, home score. Filters: team_ids, dates, seasons, game_ids, postseason. Paged with cursor and per_page.
wnba_get_gameWnba get gameGETReturns one WNBA game. Fields include date, season, postseason, status, status state, period, time, home team.

Slate, 6 operations

mlb_get_dfs_slateMlb get dfs slateGETReturns one slate with its included real-game events and lineup roster slots. Event game_id values use BALLDONTLIE game IDs when a reference is available.
mlb_list_dfs_slatesMlb list dfs slatesGETReturns DraftKings and FanDuel daily fantasy lineup pools. A slate identifies its format, event window, salary cap, and whether it covers one or multiple games.
nba_get_dfs_slateNba get dfs slateGETReturns one slate with its included real-game events and lineup roster slots. Event game_id values use BALLDONTLIE game IDs when a reference is available.
nba_list_dfs_slatesNba list dfs slatesGETReturns DraftKings and FanDuel daily fantasy lineup pools. A slate identifies its format, event window, salary cap, and whether it covers one or multiple games.
nfl_get_dfs_slateNfl get dfs slateGETReturns one slate with its included real-game events and lineup roster slots. Event game_id values use BALLDONTLIE game IDs when a reference is available.
nfl_list_dfs_slatesNfl list dfs slatesGETReturns DraftKings and FanDuel daily fantasy lineup pools. A slate identifies its format, event window, salary cap, and whether it covers one or multiple games.

Odd, 5 operations

epl_list_oddsEpl list oddsGETGet betting odds for EPL matches. Filter by match IDs or dates. Supports pagination.
mlb_list_oddsMlb list oddsGETRetrieve betting odds for MLB games. Either dates or game_ids is required.
nba_list_oddsNba list oddsGETRetrieve betting odds for NBA games, including preseason games when odds are available. Either dates or game_ids is required.
nfl_list_oddsNfl list oddsGETRetrieve betting odds for NFL games, including preseason. Either (season and week) or game_ids is required.
nhl_list_oddsNhl list oddsGETRetrieve betting odds for NHL games. Either dates or game_ids is required.

Player injury, 5 operations

epl_list_player_injuriesEpl list player injuriesGETRetrieve the current EPL player injury snapshot. Supports filtering by player IDs, team IDs, or injury status. Requires GOAT tier access.
mlb_list_player_injuriesMlb list player injuriesGETReturns MLB player injuries. Fields include player, date, return date, type, detail, side, status, long comment. Filters: team_ids, player_ids. Paged with cursor and per_page.
nba_list_player_injuriesNba list player injuriesGETReturns NBA player injuries. Fields include player, return date, description, status. Filters: team_ids, player_ids. Paged with cursor and per_page.
nfl_list_player_injuriesNfl list player injuriesGETReturns NFL player injuries. Fields include player, status, comment, date. Filters: team_ids, player_ids. Paged with cursor and per_page.
nhl_list_player_injuriesNhl list player injuriesGETReturns all players currently on the injury report. The data is updated regularly to reflect the latest injury reports.

Player prop, 5 operations

epl_list_player_propsEpl list player propsGETRetrieve live player prop betting data for EPL matches. Player prop data is LIVE and updated in real-time. We do not store historical data.
mlb_list_player_propsMlb list player propsGETRetrieve live player prop betting data for MLB games. Player prop data is LIVE and updated in real-time. We do not store historical data.
nba_list_player_propsNba list player propsGETRetrieve live player prop betting data for NBA games. Player prop data is LIVE and updated in real-time. We do not store historical data.
nfl_list_player_propsNfl list player propsGETRetrieve live player prop betting data for NFL games. Player prop data is LIVE and updated in real-time. We do not store historical data.
nhl_list_player_propsNhl list player propsGETRetrieve live player prop betting data for NHL games. Player prop data is LIVE and updated in real-time. We do not store historical data.

Season stat, 5 operations

mlb_list_season_statsMlb list season statsGETReturns MLB season stats. Fields include player, team name, season, postseason, season type, batting gp, batting ab, batting r. Filters: season, player_ids, team_id, postseason, season_type, sort_by, sort_order. Paged with cursor and per_page.
mlb_list_team_season_statsMlb list team season statsGETReturns MLB team season stats. Fields include team, team name, postseason, season type, season, gp, batting ab, batting r. Filters: season, team_id, postseason, season_type.
nfl_list_season_statsNfl list season statsGETSeason totals are unavailable before the first kickoff of the requested season type, so the data array is empty. Rushing and receiving fumble counts cover those play types only.
nhl_get_player_season_statsNhl get player season statsGETReturns NHL player season statistics. Fields include value, name. Filters: season, postseason.
nhl_get_team_season_statsNhl get team season statsGETReturns NHL team season statistics. Fields include value, name. Filters: season, postseason.

Standing, 5 operations

epl_list_standingsEpl list standingsGETReturns EPL standings. Fields include team, season, rank, rank change, group name, note, games played, wins. Filters: season.
mlb_list_standingsMlb list standingsGETReturns MLB team standings. Fields include team, league name, league short name, division name, division short name, wins, losses, win percent. Filters: season.
nba_list_standingsNba list standingsGETReturns NBA team standings. Fields include team, conference record, conference rank, division record, division rank, wins, losses, home record. Filters: season.
nfl_list_standingsNfl list standingsGETReturns NFL team standings. Fields include team, win streak, points for, points against, playoff seed, point differential, overall record, conference record. Filters: season.
nhl_list_standingsNhl list standingsGETReturns NHL standings. Fields include team, season, conference name, division name, games played, points, regulation wins, regulation plus ot wins. Filters: season, conference, division.

Play, 4 operations

mlb_list_playsMlb list playsGETReturns play-by-play data for a specific game including game state, scoring plays, and batted ball details. Plays are ordered by `order` ascending by default.
nba_list_playsNba list playsGETRetrieve play-by-play data for an NBA game. Returns all plays for a game in chronological order, including shot attempts, turnovers, fouls, and other game events.
nfl_list_playsNfl list playsGETRetrieve play-by-play data for NFL games, ordered chronologically by wallclock time
nhl_list_playsNhl list playsGETReturns play-by-play data for a specific game. Plays are returned in chronological order with a sequential order field starting from 1.

Active, 3 operations

mlb_list_active_playersMlb list active playersGETReturns active MLB players. Fields include first name, last name, full name, debut year, jersey, college, position, active. Filters: team_ids, player_ids, search, first_name, last_name. Paged with cursor and per_page.
nba_list_active_playersNba list active playersGETReturns active NBA players. Fields include first name, last name, position, height, weight, jersey number, college, country. Filters: team_ids, player_ids, search, first_name, last_name. Paged with cursor and per_page.
nfl_list_active_playersNfl list active playersGETReturns active NFL players. Fields include first name, last name, position, position abbreviation, height, weight, jersey number, college. Filters: team_ids, player_ids, search, first_name, last_name. Paged with cursor and per_page.

Draftable, 3 operations

mlb_list_dfs_draftablesMlb list dfs draftablesGETReturns players or teams that can be selected for a slate roster slot, including position, salary, availability, and linked BALLDONTLIE entities when available.
nba_list_dfs_draftablesNba list dfs draftablesGETReturns players or teams that can be selected for a slate roster slot, including position, salary, availability, and linked BALLDONTLIE entities when available.
nfl_list_dfs_draftablesNfl list dfs draftablesGETReturns players or teams that can be selected for a slate roster slot, including position, salary, availability, and linked BALLDONTLIE entities when available.

Leader, 3 operations

nba_list_leadersNba list leadersGETReturns NBA stat leaders. Fields include player, value, stat type, rank, season, games played. Filters: stat_type, season, season_type.
nhl_list_player_stat_leadersNhl list player stat leadersGETReturns NHL player statistical leaders. Fields include player, name, value, season, postseason. Filters: season, type, postseason.
nhl_list_team_stat_leadersNhl list team stat leadersGETReturns NHL team statistical leaders. Fields include team, name, value, season, postseason. Filters: season, type, postseason.

Stat, 3 operations

mlb_list_player_game_statsMlb list player game statsGETReturns MLB player stats for each game played. Fields include player, team, game id, team name, at bats, runs, hits, rbi. Filters: player_ids, game_ids, seasons. Paged with cursor and per_page.
nba_list_player_game_statsNba list player game statsGETReturns NBA player stats for each game played. Fields include min, fgm, fga, fg pct, fg3m, fg3a, fg3 pct, ftm. Filters: player_ids, game_ids, dates, seasons, season_type, start_date, end_date, period. Paged with cursor and per_page.
nfl_list_player_game_statsNfl list player game statsGETReturns NFL player stats for each game played. Fields include player, team, game, passing completions, passing attempts, passing yards, yards per pass attempt. Filters: player_ids, game_ids, seasons, season_types. Paged with cursor and per_page.

Box score, 2 operations

nba_list_box_scoresNba list box scoresGETReturns NBA box scores for a specific date. Fields include date, season, status, status state, period, time, postseason, home team score. Filters: date, season_type.
nhl_list_box_scoresNhl list box scoresGETReturns NHL box scores. Fields include player, team, game, position, goals, assists, points, plus minus. Filters: player_ids, team_ids, dates, season, game_ids. Paged with cursor and per_page.

Lineup, 2 operations

mlb_list_lineupsMlb list lineupsGETGet pre-game batting lineups and probable pitchers for MLB games. Lineups typically appear 1-2 hours before first pitch. Lineup data is available starting from the 2026 season.
nba_list_lineupsNba list lineupsGETReturns NBA game lineups. Fields include game id, starter, position, player, team. Filters: game_ids. Paged with cursor and per_page.

Roster, 2 operations

epl_list_rostersEpl list rostersGETGet player roster information for a specific team and season
nfl_get_team_rosterNfl get team rosterGETRetrieve the current roster and depth chart for a specific NFL team. Note: Roster data is only available starting with the 2025 season.

Season average, 2 operations

nba_list_season_averagesNba list season averagesGETReturns NBA season averages. Fields include games played, pts, ast, reb, stl, blk, turnover, min. Filters: season, player_id.
nba_list_season_averages_by_typeNba list season averages by typeGETReturns NBA season averages by type. Fields include player id, season, season type, stats. Filters: player_ids, season, season_type. Paged with cursor and per_page.

Adp, 1 operation

nfl_list_fantasy_adpNfl list fantasy adpGETReturns average draft position, auction value, rostered and started percentages, and their available changes. Results are ordered by average draft position.

Advanced, 1 operation

nba_list_advanced_statsNba list advanced statsGETRetrieve comprehensive advanced statistics for NBA player performances.

Aggregate, 1 operation

nba_list_player_contract_aggregatesNba list player contract aggregatesGETReturns multi-year contract aggregates for a specific player, including total value, guarantees, and contract metadata.

Hitter pitch type game stat, 1 operation

mlb_list_hitter_pitch_type_game_statsMlb list hitter pitch type game statsGETReturns per-game hitter pitch-type usage, command, whiff/contact, and damage metrics.

Hitter pitch type season stat, 1 operation

mlb_list_hitter_pitch_type_season_statsMlb list hitter pitch type season statsGETReturns season-level hitter pitch-type usage, command, whiff/contact, and damage metrics.

Live, 1 operation

nba_list_live_box_scoresNba list live box scoresGETReturns live NBA box scores. Fields include date, season, status, status state, period, time, postseason, home team score. Filters: season_type.

Market, 1 operation

mlb_list_odds_marketsMlb list odds marketsGETReturns all current MLB betting markets. Fields include deeplinks, game id, vendor, key, name, type, period, scope. Filters: game_id, vendors. Paged with cursor and per_page.

Match, 1 operation

epl_list_matchesEpl list matchesGETGet matches with optional filtering by season, dates, or teams. Supports pagination.

Match avg position, 1 operation

epl_list_match_avg_positionsEpl list match avg positionsGETRetrieve each player's average pitch position (heatmap centroid) for a match. Coordinates are normalized 0-100. Available for matches in the current and future seasons only.

Match best player, 1 operation

epl_list_match_best_playersEpl list match best playersGETRetrieve the top-rated players for each match (best XI per side and the man of the match). Available for matches in the current and future seasons only. Requires GOAT tier.

Match event, 1 operation

epl_list_match_eventsEpl list match eventsGETGet events (goals, cards, substitutions) for matches. Supports pagination.

Match heatmap, 1 operation

epl_list_match_heatmapsEpl list match heatmapsGETReturns EPL player heatmaps. Fields include match id, player id, team id, dots, dot count. Filters: match_ids, player_ids. Paged with cursor and per_page.

Match lineup, 1 operation

epl_list_match_lineupsEpl list match lineupsGETReturns EPL match lineups. Fields include match id, team id, player, is starter, position, position abbreviation, formation position, jersey number. Filters: match_ids. Paged with cursor and per_page.

Match momentum, 1 operation

epl_list_match_momentumEpl list match momentumGETRetrieve per-minute attack momentum values. Positive values favor the home side, negative values favor the away side. Available for matches in the current and future seasons only.

Match pregame form, 1 operation

epl_list_match_pregame_formsEpl list match pregame formsGETRetrieve a pre-match team-form summary for each side - recent average rating, league position entering the match, and a list of the team's most-recent results.

Match shot, 1 operation

epl_list_match_shotsEpl list match shotsGETRetrieve shot-map entries with expected goals (xG / xGoT) and pitch coordinates. Available for matches in the current and future seasons only; older matches return empty results.

Passing, 1 operation

nfl_list_advanced_passing_statsNfl list advanced passing statsGETReturns NFL advanced passing stats. Fields include player, season, week, postseason, aggressiveness, attempts, avg air distance, avg air yards differential. Filters: season, player_id, week, season_types. Paged with cursor and per_page.

Pitcher pitch type game stat, 1 operation

mlb_list_pitcher_pitch_type_game_statsMlb list pitcher pitch type game statsGETReturns per-game pitcher pitch-type usage, command, whiff/contact, and damage metrics.

Pitcher pitch type season stat, 1 operation

mlb_list_pitcher_pitch_type_season_statsMlb list pitcher pitch type season statsGETReturns season-level pitcher pitch-type usage, command, whiff/contact, and damage metrics.

Plate appearance, 1 operation

mlb_list_plate_appearancesMlb list plate appearancesGETReturns plate appearance data for a specific game. Each plate appearance includes the outcome and all individual pitches with detailed advanced pitch metrics.

Player designation, 1 operation

nfl_list_player_designationsNfl list player designationsGETRequires GOAT access. Returns one row per player and game in the selected week. Supply season and week together; season_types defaults to [2] for an explicit week.

Player match stat, 1 operation

epl_list_player_match_statsEpl list player match statsGETGet individual player statistics for matches. Supports pagination.

Projection, 1 operation

nfl_list_fantasy_projectionsNfl list fantasy projectionsGETReturns season projections when `week` is omitted and weekly lineup projections with game context when `week` is supplied.

Ranking, 1 operation

nfl_list_fantasy_rankingsNfl list fantasy rankingsGETReturns fantasy ranking variants, position ranks, and auction values.

Receiving, 1 operation

nfl_list_advanced_receiving_statsNfl list advanced receiving statsGETReturns NFL advanced receiving stats. Fields include player, season, week, postseason, avg cushion, avg expected yac, avg intended air yards, avg separation. Filters: season, player_id, week, season_types. Paged with cursor and per_page.

Rushing, 1 operation

nfl_list_advanced_rushing_statsNfl list advanced rushing statsGETReturns NFL advanced rushing stats. Fields include player, season, week, postseason, avg time to los, expected rush yards, rush attempts, rush pct over expected. Filters: season, player_id, week, season_types. Paged with cursor and per_page.

Scoring format, 1 operation

nfl_list_fantasy_scoring_formatsNfl list fantasy scoring formatsGETReturns season-specific scoring definitions referenced by available fantasy data.

Shot chart, 1 operation

nba_list_shot_chartsNba list shot chartsGETReturns one row per field-goal attempt after a game finishes. Requires NBA GOAT or ALL-ACCESS. Preseason is excluded.

Snap count, 1 operation

nfl_list_snap_countsNfl list snap countsGETPlayer participation on offense, defense, and special teams for completed games. Available with ALL-STAR and GOAT.

Split, 1 operation

mlb_get_player_splitsMlb get player splitsGETGet player splits grouped by split_category (e.g., vs RHP/LHP, by month, by opponent, etc.)

Team match stat, 1 operation

epl_list_team_match_statsEpl list team match statsGETReturns EPL team match statistics. Fields include match id, team id, possession pct, shots, shots on target, fouls, yellow cards, red cards. Filters: match_ids, team_ids. Paged with cursor and per_page.

Team season average, 1 operation

nba_list_team_season_averagesNba list team season averagesGETRetrieve team season averages for various statistical categories. Each category requires a specific type parameter that determines the exact stats returned.

Team season stat, 1 operation

nfl_list_team_season_statsNfl list team season statsGETRetrieve comprehensive team season statistics including offense, defense, special teams, and opponent stats

Team stat, 1 operation

nfl_list_team_game_statsNfl list team game statsGETReturns NFL team game stats. Fields include game, team, home away, first downs, first downs passing, first downs rushing, third down efficiency. Filters: team_ids, seasons, game_ids, season_types. Paged with cursor and per_page.

Versus, 1 operation

mlb_get_player_versusMlb get player versusGETGet head-to-head batting statistics for batter against pitchers for a specific team, or pitcher against batters from a specific team

Weekly stat, 1 operation

nfl_list_fantasy_weekly_statsNfl list fantasy weekly statsGETReturns observed weekly player or team-defense statistics, game context, and fantasy-point totals for every available scoring variant.

Showing the first 120 of 139 endpoints. The rest are in the product, searchable from the workflow builder and from chat.

Use BALLDONTLIE from Claude Code, Cursor or Codex

Connect BALLDONTLIE in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its BALLDONTLIE operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect BALLDONTLIE

Create your workspace
Sign up free. Nothing to install.
Connect BALLDONTLIE once
Add your BALLDONTLIE connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.