Realtime Sports API

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Live scores, play-by-play, box scores, odds, injuries: NFL, NBA, NHL, MLB, NCAA, 23 soccer leagues

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Realtime Sports API": {
      "url": "https://www.realtimesportsapi.com/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (14)

• list_leagues read-only

  List the leagues this API monitors live, with the sport and league slugs every other tool needs. 29 leagues monitored live: NFL, college football, NBA, men's college basketball, MLB, NHL and 23 soccer competitions.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• get_live_events read-only

  Games in progress right now for a league, with score, period/clock and status. Empty list when nothing is live. Data is typically 20-30 s behind live play.

  Parameters:

  • sport (required) — string — Sport slug.
  • league (required) — string — League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure.
  • detail — string — compact (default) returns the key fields per game; full returns the complete v1 event objects.
  • include_odds — boolean — Attach current betting odds when available.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• get_events read-only

  The league's current scoreboard window: recent, live and upcoming games. For specific dates or weeks use get_schedule.

  Parameters:

  • sport (required) — string — Sport slug.
  • league (required) — string — League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure.
  • limit — integer — Max games (default 50).
  • detail — string — compact (default) returns the key fields per game; full returns the complete v1 event objects.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• get_event read-only

  Full details for one game: teams, score, status, venue, season/week, broadcasts, officials.

  Parameters:

  • sport (required) — string — Sport slug.
  • league (required) — string — League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure.
  • event_id (required) — string — Event (game) id from get_live_events, get_events or get_schedule.
  • include_odds — boolean

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• get_plays read-only

  Play-by-play for a game, oldest first, paginated. Use a larger limit (up to 300 here) to get more plays per call; check pagination.hasNextPage.

  Parameters:

  • sport (required) — string — Sport slug.
  • league (required) — string — League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure.
  • event_id (required) — string — Event (game) id from get_live_events, get_events or get_schedule.
  • page — integer — Page number (default 1).
  • limit — integer — Plays per page (default 50).

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• get_box_score read-only

  Team totals and player statistics for a game (basketball, soccer, baseball, football). Not available before kickoff.

  Parameters:

  • sport (required) — string — Sport slug.
  • league (required) — string — League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure.
  • event_id (required) — string — Event (game) id from get_live_events, get_events or get_schedule.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• get_odds read-only

  Current spread, moneyline and total for a game from a single source book. Returns null when no odds are available.

  Parameters:

  • sport (required) — string — Sport slug.
  • league (required) — string — League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure.
  • event_id (required) — string — Event (game) id from get_live_events, get_events or get_schedule.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• get_schedule read-only

  Games in a date range (start_date/end_date, YYYY-MM-DD, at most 31 days, US Eastern calendar days like most US schedules) or, for NFL and college football, a season week (season + week). Up to 200 games.

  Parameters:

  • sport (required) — string — Sport slug.
  • league (required) — string — League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure.
  • week — integer — Week number (NFL / college football only).
  • detail — string — compact (default) returns the key fields per game; full returns the complete v1 event objects.
  • season — integer — Season year, used with week.
  • end_date — Last day, YYYY-MM-DD (US Eastern). Defaults to start_date.
  • start_date — string — First day, YYYY-MM-DD (US Eastern).
  • season_type — integer — 1 preseason, 2 regular (default), 3 postseason.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• list_teams read-only

  Teams in a league (paginated; college football has 800+ teams across divisions).

  Parameters:

  • sport (required) — string — Sport slug.
  • league (required) — string — League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure.
  • page — integer
  • limit — integer — Teams per page (default 50).

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• get_team read-only

  One team: names, record, standing summary, venue.

  Parameters:

  • sport (required) — string — Sport slug.
  • league (required) — string — League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure.
  • team_id (required) — string — Team id from list_teams or from an event's homeTeam/awayTeam.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• get_team_roster read-only

  Current roster for a team, grouped by position.

  Parameters:

  • sport (required) — string — Sport slug.
  • league (required) — string — League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure.
  • team_id (required) — string — Team id from list_teams or from an event's homeTeam/awayTeam.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• search_athletes read-only

  Find players by name within a league; returns athlete ids and teams.

  Parameters:

  • sport (required) — string — Sport slug.
  • league (required) — string — League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure.
  • query (required) — string — Player name, e.g. "mahomes".
  • limit — integer

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• get_injuries read-only

  Current injury report grouped by team (empty in the off-season). Pass team_id for that team's complete report.

  Parameters:

  • sport (required) — string — Sport slug.
  • league (required) — string — League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure.
  • team_id — string — Team id from list_teams or from an event's homeTeam/awayTeam.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

• get_news read-only

  Latest news headlines for a league (optionally one team), with links.

  Parameters:

  • sport (required) — string — Sport slug.
  • league (required) — string — League slug. Monitored leagues (sport/league): football/nfl (NFL), football/college-football (College Football), basketball/nba (NBA), basketball/mens-college-basketball (Men's College Basketball), baseball/mlb (MLB), hockey/nhl (NHL), soccer/usa.1 (MLS), soccer/usa.open (U.S. Open Cup), soccer/eng.1 (Premier League), soccer/uefa.champions (Champions League), soccer/uefa.europa (Europa League), soccer/eng.fa (FA Cup), soccer/esp.1 (LaLiga), soccer/ita.1 (Serie A), soccer/mex.1 (Liga MX), soccer/fifa.world (World Cup), soccer/eng.w.1 (Women's Super League), soccer/uefa.wchampions (Women's Champions League), soccer/uefa.europa.conf (Conference League), soccer/eng.league_cup (League Cup), soccer/ger.1 (Bundesliga), soccer/fra.1 (Ligue 1), soccer/usa.nwsl (NWSL), soccer/eng.2 (Championship), soccer/fifa.worldq.uefa (WC Qualifying UEFA), soccer/fifa.worldq.conmebol (WC Qualifying CONMEBOL), soccer/fifa.worldq.afc (WC Qualifying AFC), soccer/fifa.worldq.caf (WC Qualifying CAF), soccer/fifa.worldq.concacaf (WC Qualifying CONCACAF). Call list_leagues if unsure.
  • limit — integer
  • team_id — string — Team id from list_teams or from an event's homeTeam/awayTeam.

  Hints: read-only yes · destructive not declared · idempotent not declared · open-world yes

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.