Documentation / More
MCP tools, sports data API
MCP tools14 tools, each taking the sport, covering every endpoint of every sport. A value marked ? is optional.
Each tool calls the API with your own key, so it reads exactly what your plan reads and counts like any call. A refusal comes back to the assistant in words, with the plan that opens it.
| Tool | What it does | Takes | Calls |
|---|---|---|---|
| list_sports | Every sport, whether it is serving now, its endpoints and its plan price. Call this first when unsure what a sport offers. | none | none |
| live_scores | Every event in play right now in a sport, with the score and the clock. Needs the sport plan. | sport | /live |
| fixtures | Upcoming events in a sport by date: matches, racecards declared ahead, or fights to come. Needs the sport plan. | sport, date?, competition? | /fixtures, /cards/upcoming, /fights/upcoming |
| results | Finished events in a sport for a day, with the final score. Leave out date for yesterday, which the free key also reads. | sport, date?, competition?, page? | /results |
| racecards_today | Today's racecards for horse or greyhound racing: every meeting, race and runner. Needs the sport plan. | sport | /cards/today |
| get_match | One match, game, race or bout in full, by its id. | sport, id | /events/{id}, /matches/{id}, /races/{id}, /bouts/{id} |
| match_detail | More about one match by its id: line-ups, the timeline by period, statistics, the cricket scorecard or every ball, or a bout's judges' cards. | sport, id, part | /events/{id}/lineups, /events/{id}/periods, /matches/{id}/stats, /matches/{id}/scorecard, /matches/{id}/deliveries, /bouts/{id}/cards |
| competitions | Every competition, tournament, course or track a sport holds, with the ids to use in other tools. | sport | /competitions, /tournaments, /courses, /tracks, /races |
| standings | A league table for a competition and season, or a sport's ranking list. | sport, competition?, season?, discipline? | /standings, /rankings |
| team | A team and its record, by its id. | sport, id | /teams/{id} |
| player | A player, fighter or rider and their record, by their id. | sport, id | /players/{id}, /fighters/{id}, /riders/{id} |
| racing_profile | Horse or greyhound racing: a horse's or dog's form, a jockey, a trainer, or a track's statistics, by id. | sport, id, kind | /horses/{id}/form, /dogs/{id}/form, /jockeys/{id}, /trainers/{id}, /tracks/{id}/stats |
| head_to_head | Every meeting between two teams or two players, by their ids. | sport, side, opponent | /head-to-head |
| search | Find teams, players, horses, dogs, fighters or competitions in a sport by name, and get their ids. | sport, q | /search |