MCP server

Thesportsdb

io.github.pipeworx-io/thesportsdb

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

TheSportsDB MCP — sports catalog (teams, players, events)

Website Source

At a glance

Type

MCP server

Publisher

pipeworx.io (verified by the MCP Registry)

Status

Working at last check

Tools

57

Token cost

About 28,446 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http thesportsdb https://gateway.pipeworx.io/thesportsdb/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.thesportsdb]
url = "https://gateway.pipeworx.io/thesportsdb/mcp"

Gemini CLI

{"mcpServers":{"thesportsdb":{"httpUrl":"https://gateway.pipeworx.io/thesportsdb/mcp"}}}

Cursor

{"mcpServers":{"thesportsdb":{"url":"https://gateway.pipeworx.io/thesportsdb/mcp"}}}

VS Code

{"servers":{"thesportsdb":{"type":"http","url":"https://gateway.pipeworx.io/thesportsdb/mcp"}}}

Antigravity

agy mcp add thesportsdb https://gateway.pipeworx.io/thesportsdb/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"thesportsdb","server_url":"https://gateway.pipeworx.io/thesportsdb/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"thesportsdb","server_url":"https://gateway.pipeworx.io/thesportsdb/mcp"}

Tools

• event_detail ~206 tokens
  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 event
• event_lineup ~175 tokens
  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.
• event_stats ~201 tokens
  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
• event_timeline ~209 tokens
  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:fa
• events_by_day ~233 tokens
  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
• get_player ~91 tokens
  Full player profile from TheSportsDB by numeric player_id — returns name, team, nationality, position, birth date, description, and thumbnail.
• get_team ~100 tokens
  Full team profile from TheSportsDB by numeric team_id — returns name, sport, country, stadium, formed year, description, badge, and social links.
• league_table ~102 tokens
  Standings table for a league/season.
• league_teams ~81 tokens
  List all teams in a TheSportsDB league by league_id; returns each team's id, name, badge, and country.
• list_leagues ~198 tokens
  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. An
• list_sports ~62 tokens
  Return all sports tracked by TheSportsDB (e.g. Soccer, Ice Hockey, Basketball), each with id, name, and forum.
• search_players ~106 tokens
  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.
• search_teams ~138 tokens
  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.
• team_events_last ~116 tokens
  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 ~125 tokens
  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).

Browse

• GitHub tools
• Web search
• GitHub and code hosting
• Sports
• Government and public data

Related MCP servers

• SiteCheck Agent Intel & Dev
  135 pay-per-call agent tools: agent intelligence, token risk, developer and AI data tools. x402
• PropLine — Sports Betting Odds & Prop Resolution
  Live odds, cross-book +EV and graded player-prop results across 37 books. Hosted endpoint included.
• ParlayAPI
  Sports odds, player props and source coverage for AI assistants. Connect with your own API key.
• SportStatsAPI
  Fixtures, live scores, results, tables and match facts for 1,881 competitions in 8 sports.
• Espn
  ESPN MCP — keyless multi-sport live scores, teams, and news via ESPN's public site API.
• betrend sports data
  Live scores, fixtures, results, standings, teams and head-to-head for football and more sports.
• Stratalize Crypto & DeFi
  Retired. Use com.stratalize/stratalize.
• 0to100
  Schedules, injury reports and fan-hub links for all 32 NFL and 30 NBA teams.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.pipeworx-io/thesportsdb.svg)](https://aptlynx.net/servers/io.github.pipeworx-io/thesportsdb)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents