Documentation / More
Snooker API mcp tools
MCP toolsEvery tool, its purpose, parameters and endpoint.
| Tool | What it does | Calls | Parameters |
|---|---|---|---|
| find_events | Events: every tournament and championship, newest first. | GET /v1/events | season, year, tour, competition_id, q |
| get_event | One event: its dates, venue, champion, final, prize fund and its own figures (frames played, deciding frames, whitewashes, centuries). | GET /v1/events/{event_id} | none |
| event_ranking_points | The world ranking points each player earned at a ranking event, as the season's rankings publish them, and whether our own results for the event give the same points. | GET /v1/events/{event_id}/points | paging only |
| find_matches | Matches: results and draws, newest first, by event, player, season or dates. | GET /v1/matches | event_id, player_id, season, stage, round, from, to, status |
| get_match | One match, with its status, its frames where they are known (points and breaks of 50 and over), and every change to it since it entered our record. | GET /v1/matches/{match_id} | none |
| yesterdays_results | Every match finished yesterday (UTC): those our live tracker saw finish yesterday, and those whose own day is yesterday. | GET /v1/results/yesterday | paging only |
| find_players | Players: everyone who has played in an event we hold, from 1927 on. | GET /v1/players | q, country |
| get_player | One player: nationality, birth date and place, the year they turned professional, their ranking, minor-ranking and world titles, the first season they were ranked, their highest world ranking, matches played and won, titles, and the seasons they span. | GET /v1/players/{player_id} | none |
| head_to_head | Two players' meetings: how many, who won, frames won by each, their finals, and every match between them, newest first. | GET /v1/head-to-head | player_a, player_b |
| world_rankings | World rankings: a season's list, position by position, with ranking points where they are known. | GET /v1/rankings | season, list, player_id |
| century_breaks | Century breaks: every break of 100 or more in the events we hold, by event, player or season. | GET /v1/centuries | event_id, player_id, season, stage, min_points |
| maximum_breaks | Maximum breaks: every officially recognised 147, newest first, with the player, the opponent and the event. | GET /v1/maximums | player_id, season, year |
| live_match | One match as it stands: whether it is under way, the frames won, every frame known, and its latest change. | GET /v1/matches/{match_id}/live | none |
| yesterdays_stats | Yesterday (UTC) in one answer: matches, walkovers, frames, deciding frames, whitewashes, average match length, centuries and the highest break, in all and by stage. | GET /v1/stats/yesterday | event_id, stage |
| yesterdays_player_stats | Every player who played yesterday: matches won and lost, frames won and lost, frame difference and frame win rate, centuries and their highest. Most wins first. | GET /v1/stats/yesterday/players | event_id, stage |
| yesterdays_deciders | Yesterday's matches settled in the deciding frame (won by one frame at full length), as the matches list gives them. | GET /v1/stats/yesterday/deciders | event_id, stage |
| yesterdays_whitewashes | Yesterday's matches won without losing a frame, as the matches list gives them. | GET /v1/stats/yesterday/whitewashes | event_id, stage |
| yesterdays_upsets | Yesterday's wins over a higher-ranked player, on the newest world ranking list, biggest ranking gap first. An unranked winner counts as one place below the list. | GET /v1/stats/yesterday/upsets | event_id, stage |
| yesterdays_top16 | How the world's top 16 on the newest ranking list fared yesterday: each one who played, their matches, wins, losses and frames, and every result. | GET /v1/stats/yesterday/top16 | event_id, stage |
| yesterdays_nations | Yesterday by nation, as the draws flag each player (ENG, CHN, WAL ...): players in action, matches won and lost, frames won and lost, centuries. Most wins first. | GET /v1/stats/yesterday/nations | event_id, stage |
| yesterdays_events | Yesterday by event, and within each event by round: matches, frames, deciding frames, whitewashes and average match length; centuries and the highest by event. | GET /v1/stats/yesterday/events | event_id, stage |
| yesterdays_scorelines | How often each scoreline came up yesterday, by match length: 4-0, 4-1, 4-2, 4-3 in best of 7, and so on, with each one's share. | GET /v1/stats/yesterday/scorelines | event_id, stage |
| yesterdays_centuries | Every century break we had yesterday, highest first, with the player, the event and the stage. | GET /v1/stats/yesterday/centuries | event_id, stage |