thesportsdb API for agents (unofficial) — JSON over curl | clify
TheSportsDB: an open, crowd-sourced sports database. This CLI searches teams and players, looks up events, league tables, fixtures, squads and TV schedules through the free public JSON API (key 123) and the server-rendered HTML pages.
Host: thesportsdb.com. Call these verified read commands with plain curl; no install, key, or account. Use the public JSON API with plain curl. No install, key, account, or browser is needed. Example: curl 'https://clify-dev.netlify.app/sites.json'. Start with /search?q=weather, then call /abc/COMMAND. Responses are one JSON object. The hosted MCP and GitHub repo are also available.
Commands
search-teams
Search teams by name via the JSON API (full team record: ids, leagues, stadium, socials, descriptions) Params: team*
curl 'https://clify-dev.netlify.app/thesportsdb/search-teams?team=Arsenal'
search-players
Search players by name via the JSON API (team, nationality, position, birth date) Params: player*
curl 'https://clify-dev.netlify.app/thesportsdb/search-players?player=Messi'
get-event
Get one event/match by its event id (teams, scores, date/time, venue, round, season) Params: id*
curl 'https://clify-dev.netlify.app/thesportsdb/get-event?id=2494069'
get-league-table
Get the league standings table for a league id and season (rank, points, W/D/L, goals, form) Params: league*, season*
curl 'https://clify-dev.netlify.app/thesportsdb/get-league-table?league=4328&season=2025-2026'
list-next-league-events
List the next upcoming events (fixtures) of a league by league id Params: id*
curl 'https://clify-dev.netlify.app/thesportsdb/list-next-league-events?id=4328'
list-team-last-events
List a team's most recent results by team id Params: id*
curl 'https://clify-dev.netlify.app/thesportsdb/list-team-last-events?id=133604'
list-events-by-day
List all events on a given date, optionally filtered by sport Params: date*, sport
curl 'https://clify-dev.netlify.app/thesportsdb/list-events-by-day?date=2026-10-18&sport=Soccer'
list-team-players
List the players and staff of a team by team id Params: id*
curl 'https://clify-dev.netlify.app/thesportsdb/list-team-players?id=133604'
list-leagues
List leagues with their ids and sport Params: none
curl 'https://clify-dev.netlify.app/thesportsdb/list-leagues'
search-site
Keyword search across teams, players, leagues, venues and events on the website, optionally filtered by sport; returns names and links Params: query*, sport
curl 'https://clify-dev.netlify.app/thesportsdb/search-site?query=Arsenal&sport=Soccer'
get-team
Get a team profile page: name, profile info, next event, manager, stadium, leagues, upcoming fixtures and recent results Params: team*
curl 'https://clify-dev.netlify.app/thesportsdb/get-team'
get-player
Get a player profile page: name, bio facts (born, position, team), description, team and league links Params: player*
curl 'https://clify-dev.netlify.app/thesportsdb/get-player'
get-league
Get a league profile page: name, facts, current season and round, upcoming fixtures and recent results Params: league*
curl 'https://clify-dev.netlify.app/thesportsdb/get-league'
list-season-events
List all fixtures/results of a league season (optionally for one team or one round) Params: league*, season*, team, round
curl 'https://clify-dev.netlify.app/thesportsdb/list-season-events'
list-tv-channels
List TV channels for a country, optionally searching channels by name Params: country*, query
curl 'https://clify-dev.netlify.app/thesportsdb/list-tv-channels?country=united_kingdom'
list-tv-events-today
List today's televised sports events for a country, with time (UTC) and channels Params: country*
curl 'https://clify-dev.netlify.app/thesportsdb/list-tv-events-today?country=united_kingdom'
get-channel-schedule
Get a TV channel's sports schedule for the next 7 days (events with UTC times) Params: channel*
curl 'https://clify-dev.netlify.app/thesportsdb/get-channel-schedule'
list-sport-leagues
List the featured leagues of a sport from its overview page Params: sport*
curl 'https://clify-dev.netlify.app/thesportsdb/list-sport-leagues'