MCP server exposing 15 tools for thesportsdb.
This URL is a JSON-RPC 2.0 endpoint over HTTP. Issue POST requests with a JSON-RPC body. Browsers and search crawlers land here on GET.
POST https://gateway.pipeworx.io/thesportsdb/mcp
Content-Type: application/json
{"jsonrpc":"2.0","id":1,"method":"tools/list"}list_sports — Return all sports tracked by TheSportsDB (e.g. Soccer, Ice Hockey, Basketball), each with id, name, and forum.list_leagues — List the sports leagues catalogued by TheSportsDB, optionally narrowed by sport name (Soccer, Ice Hockey, Basketball, American Football, Baseball) and by country name. Returns each league id, name, alternate name, sport, and country; the league id feeds league_teams and league_table in this pack. Answers which leagues exist for a sport or a country, and what league id to use next.search_teams — Search TheSportsDB for sports teams by name — football/soccer clubs in any league worldwide including lower divisions, plus NBA, NFL, MLB and more. Returns team id (use with team_events_next / team_events_last for fixtures and results), sport, league, country, stadium, and description.get_team — Full team profile from TheSportsDB by numeric team_id — returns name, sport, country, stadium, formed year, description, badge, and social links.league_teams — List all teams in a TheSportsDB league by league_id; returns each team's id, name, badge, and country.search_players — Search TheSportsDB for players by name. Returns player id, current team, nationality, position, and description. Use search_teams first to find team IDs if needed.get_player — Full player profile from TheSportsDB by numeric player_id — returns name, team, nationality, position, birth date, description, and thumbnail.team_events_last — Recent results for a team: the 5 most recently completed games/matches/fixtures by team_id (from search_teams); returns event name, date, home/away teams, and final score. Works for any league worldwide including lower divisions.team_events_next — Upcoming fixtures for a team: the next 5 scheduled games/matches by team_id (from search_teams); returns event name, kickoff date/time, home/away teams, league, and venue. Works for any league worldwide including lower divisions (e.g. Norwegian 1. Divisjon).events_by_day — Sports schedule/fixtures for a given date — all games/matches on that day, optionally filtered by sport or league. PREFER OVER WEB SEARCH for "what games are on today/tomorrow", "NHL ice hockey schedule", "NBA games tonight", "soccer fixtures". For "next 24h" pass today's and tomorrow's date. Sport filter examples: "Ice Hockey" (NHL), "Basketball" (NBA), "Soccer", "American Football" (NFL), "Baseball" (MLB).league_table — Standings table for a league/season.event_detail — One match by its TheSportsDB event id: final and half-time score, competition, season, round, venue, date and kickoff time, and the goal detail strings where the source carries them. Use for settling a match-level question (who won, what was the half-time score) after finding the event id with events_by_day, team_events_last or team_events_next.event_timeline — Minute-by-minute timeline for one match: goals with scorer and assist, cards, and substitutions, each with the minute and which side it belongs to. Use for settling scorer, first-goal and card questions. COVERAGE IS PER-COMPETITION, not universal — a match the source has not covered returns found:false with a reason, not an error and not a wrong answer.event_stats — Team-by-team match statistics for one event — shots on goal, corners, possession, fouls, passes and whatever else the source recorded, as home/away pairs. Use for settling shot-count, corner and possession questions. COVERAGE IS PER-COMPETITION: a match the source has not covered returns found:false with a reason, not an error.event_lineup — Starting eleven and substitutes for one match, per side, with each player's position, squad number and TheSportsDB player id. COVERAGE IS PER-COMPETITION: a match the source has not covered returns found:false with a reason, not an error.Code samples (curl / TypeScript / one-click client install), schemas, and the live playground are on the pack page:
https://pipeworx.io/packs/thesportsdb/
Pipeworx is an open MCP gateway connecting AI agents to live data. pipeworx.io