Documentation / More
MCP tools
Every MCP tool: what it does, its inputs, the endpoint it calls and the plan it needs.
The tools the MCP server offers. Each calls one endpoint with your key; pagination is handled for you.
| Tool | What it does | Inputs | Calls | Plans |
|---|---|---|---|---|
list_courses | Every British and Northern Irish course, with where it is and which way round it runs. | none | GET /v1/courses | Every plan, free key included |
course_details | One course in full: what is raced there and over which distances. | course_id | GET /v1/courses/{course_id} | Every plan, free key included |
todays_racecards | Today's UK cards, every meeting and race in the order they are due off. | course | GET /v1/racecards/today | Live, Archive and Complete |
racecards_for_date | The full UK card for one day, with results where the races are settled. | date course | GET /v1/racecards/{date} | Every plan, free key included |
results_for_date | Every settled UK race on a day: finishing order, starting prices and the rest. | date | GET /v1/results/{date} | Every plan, free key included |
race_details | One race: its conditions, the market and every runner. | race_id | GET /v1/races/{race_id} | Every plan, free key included |
race_market | A race's market: the book, every price and what moved. | race_id | GET /v1/races/{race_id}/market | Live, Archive and Complete |
search_races | Find UK races by date, course, type, going, class and field size. | date_from date_to course_id run_type class going surface handicap min_runners max_runners result_available limit | GET /v1/races/search | Live, Archive and Complete |
search_racing | Look up a horse, trainer, jockey or course by name and get its id. | q type limit | GET /v1/search | Live, Archive and Complete |
horse_form | A horse's UK runs, newest first. | horse_id limit | GET /v1/horses/{horse_id}/form | Live, Archive and Complete |
trainer_stats | A trainer's strike rate, A/E and level stakes, split any way. | trainer_id by min_runs | GET /v1/trainers/{trainer_id}/stats | Complete |
jockey_stats | A jockey's strike rate, A/E and level stakes, split any way. | jockey_id by min_runs | GET /v1/jockeys/{jockey_id}/stats | Complete |
race_report | The written account of one race, with a line for every runner. | race_id | GET /v1/reports/{race_id} | Complete |
days_upsets | The day's UK shocks, each scored 0 to 100 with the reasons. | date | GET /v1/upsets | Every plan, free key included |