Integration

TheSportsDB integration

TheSportsDB is a crowd-sourced sports database. Search teams, players, events and venues by name, look up a league, team, player, event or venue by its numeric id (league table, lineup, timeline, statistics, TV broadcasts, honours, contracts, former teams), list sports, countries, leagues, seasons, teams and players, and read schedules (next and previous events of a team or league, a day, a season, TV listings, YouTube highlights). This is the v1 API: the free key 123 works on every route with small result caps (for example one team per name search), and a premium key raises them. Per TheSportsDB's terms the free key is for development projects (publishing an app to an app store needs a paid subscription), paid use must name TheSportsDB as the data source, and artwork follows its own per-image licence. The documented rate limit is 30 requests per minute on the free key and 100 on premium. The v2 API (premium only, key in a header, livescores) is not part of this integration. Authentication is the API key placed in the URL path.

Connect TheSportsDB How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

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

What you can do with TheSportsDB

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.

Event, 8 operations

get_eventGet eventGETReturns one event by idEvent: teams, date and time, score, venue, league, season and artwork.
list_events_by_dayList events by dayGETLists the events on one day (past, present or future), optionally filtered by sport or league. Free key: 3 events, premium: 1500.
list_league_next_eventsList league next eventsGETLists a league's next upcoming events by idLeague. Free key: 1 event, premium: 20.
list_league_past_eventsList league past eventsGETLists a league's most recent past events by idLeague, with scores. Free key: 1 event, premium: 20.
list_season_eventsList season eventsGETLists the events of one league season by idLeague and, optionally, season name (for example 2014-2015, as listed by list_league_seasons); without a season name it lists the league's current season. Free key: 15 events, premium: 3000.
list_team_last_eventsList team last eventsGETLists a team's most recent past events by idTeam, with scores. Free key: 1 event and home events only, premium: 10.
list_team_next_eventsList team next eventsGETLists a team's next upcoming events by idTeam. Free key: 1 event and home events only, premium: 10.
search_eventsSearch eventsGETSearches events by title (Home_vs_Away), optionally narrowed by season or date, or by filename (f). Free key: 1 result, premium: 10. The list comes back in a field named event.

League, 3 operations

get_leagueGet leagueGETReturns one league by idLeague: sport, country, current season, formation year, description, website and artwork.
list_country_leaguesList country leaguesGETLists leagues by country (c), by sport (s), or both, with full league details. Free key: 10 results, premium: 100. The list comes back in a field named countries.
list_leaguesList leaguesGETLists leagues with their idLeague, name, sport and alternate name. Free key: 10 results, premium: 3000. Pass an idLeague to get_league, list_league_next_events or list_league_seasons.

Player, 3 operations

get_playerGet playerGETReturns one player by idPlayer: team, nationality, position, birth date, height, description and artwork.
list_team_playersList team playersGETLists the players of a team by idTeam. Free key: 10 players, premium: 3000.
search_playersSearch playersGETSearches players by main or alternate name. Free key: 1 result, premium: 10. The list comes back in a field named player; pass its idPlayer to get_player.

Team, 3 operations

get_teamGet teamGETReturns one team by idTeam: sport, leagues, stadium, formation year, colours, description, social links and artwork.
list_league_teamsList league teamsGETLists the teams of a league by league name (l), or of a sport in a country (s and c). Free key: 10 teams, premium: 3000.
search_teamsSearch teamsGETSearches teams by main or alternate name and returns full team details with idTeam. The free key only answers the name Arsenal (1 result); a premium key searches every team, up to 100.

Venue, 2 operations

get_venueGet venueGETReturns one venue by idVenue: location, capacity, opening year, description and artwork.
search_venuesSearch venuesGETSearches venues by name or alternate name and returns idVenue and full details. Free key: 1 result, premium: 10.

Country, 1 operation

list_countriesList countriesGETLists the countries TheSportsDB knows, each with its English name and flag image URL. Free key: 50 results, premium: 500. Use a name as the c filter of list_country_leagues or list_league_teams.

Event highlight, 1 operation

list_event_highlightsList event highlightsGETLists YouTube highlight videos of events on one day, optionally filtered by league id or sport. Some videos may be geo-blocked. Free key: 2 results, premium: 50.

Event lineup, 1 operation

get_event_lineupGet event lineupGETReturns the team lineups of one event by idEvent (player, position, squad number, home or away, substitute flag). Free key: 5 results, premium: 100.

Event result, 1 operation

get_event_resultsGet event resultsGETReturns the per-competitor results of one event by idEvent (positions, points, times: used for racing and individual sports). Free key: 5 results, premium: 100.

Event stat, 1 operation

get_event_statsGet event statsGETReturns the match statistics of one event by idEvent (possession, shots and similar, home and away values). Free key: 5 results, premium: 100.

Event timeline, 1 operation

get_event_timelineGet event timelineGETReturns the timeline of one event by idEvent (goals, cards, substitutions with minute and player). Free key: 5 results, premium: 100.

League table, 1 operation

get_league_tableGet league tableGETReturns a league standings table by idLeague, for the current season or a given one. Featured soccer leagues only. Free key: 5 rows, premium: 100.

Player contract, 1 operation

list_player_contractsList player contractsGETLists a player's contracts by idPlayer (team, start and end year, wage). Free key: 1 result, premium: 100.

Player former team, 1 operation

list_player_former_teamsList player former teamsGETLists a player's former teams by idPlayer, with joined and departed years. Free key: 5 results, premium: 100.

Player honour, 1 operation

list_player_honoursList player honoursGETLists the honours (trophies won) of a player by idPlayer. Free key: 5 results, premium: 500.

Player milestone, 1 operation

list_player_milestonesList player milestonesGETLists the career milestones of a player by idPlayer. Free key: 5 results, premium: 100.

Season, 1 operation

list_league_seasonsList league seasonsGETLists the seasons of a league by idLeague, optionally with season posters, badges or descriptions. Free key: 5 results, premium: 500.

Sport, 1 operation

list_sportsList sportsGETLists the sport categories TheSportsDB covers (idSport, name, format, description, images). Free key: 2 results, premium: 50. Sport names are the s filter of other tools.

Team equipment, 1 operation

list_team_equipmentList team equipmentGETLists a team's current and historical kits by idTeam (season, kit type, image). Free key: 2 results, premium: 100.

Tv broadcast, 1 operation

list_event_tv_broadcastsList event tv broadcastsGETLists the TV channels broadcasting one event by idEvent, per country. Free key: 2 results, premium: 100.

Tv event, 1 operation

list_tv_eventsList tv eventsGETLists TV broadcasts: by day (d), optionally with sport (s), or with s and country (a); or one channel by name (c) or id (id). Use one selector per call: other mixes can answer with an empty body. Free key: 1 result, premium: 1500.

Use TheSportsDB from Claude Code, Cursor or Codex

Connect TheSportsDB in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its TheSportsDB 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 TheSportsDB

Create your workspace
Sign up free. Nothing to install.
Connect TheSportsDB once
Add your TheSportsDB 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.