UK racing, asked in plain English
Add one address to Claude, ChatGPT, Cursor or Claude Code and ask what runs at Cheltenham today, who won yesterday's big handicap or how a yard is going at Musselburgh. The assistant calls the API with your own key and answers from the facts.
Two minutes in the assistant you already use
Claude and ChatGPT sign you in once and ask you to allow it. Cursor and Claude Code take your key in a header. Either way it uses your key and your plan.
- In Claude, open Settings, then Connectors, and choose Add custom connector.
- Name it Horse Racing API UK and paste the address.
- Connect, sign in with Google and press Allow.
https://horseracingapi.co.uk/mcp
- In ChatGPT, open Settings, then Connectors, and add a custom connector.
- Paste the address and save.
- Sign in with Google and press Allow.
https://horseracingapi.co.uk/mcp
- Run this once in your terminal, with your key in place of YOUR_KEY.
- Ask Claude Code about UK racing.
claude mcp add --transport http horseracingapi \
https://horseracingapi.co.uk/mcp \
--header "X-API-Key: YOUR_KEY"- Add a server to your MCP settings with the address below.
- Send your key in the X-API-Key header.
{
"mcpServers": {
"horseracingapi": {
"url": "https://horseracingapi.co.uk/mcp",
"headers": { "X-API-Key": "YOUR_KEY" }
}
}
}Fourteen tools, one for each question people ask
Each tool calls one endpoint with your key, so your plan's days and limits apply. A tool your plan does not reach says which plan has it. Pagination is handled for you.
| Tool | What it does | Inputs | Plans |
|---|---|---|---|
list_courses | Every British and Northern Irish course, with where it is and which way round it runs. | none | Every plan |
course_details | One course in full: what is raced there and over which distances. | course_id | Every plan |
todays_racecards | Today's UK cards, every meeting and race in the order they are due off. | course | Live, Archive, Complete |
racecards_for_date | The full UK card for one day, with results where the races are settled. | date, course | Every plan |
results_for_date | Every settled UK race on a day: finishing order, starting prices and the rest. | date | Every plan |
race_details | One race: its conditions, the market and every runner. | race_id | Every plan |
race_market | A race's market: the book, every price and what moved. | race_id | Live, Archive, 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 | Live, Archive, Complete |
search_racing | Look up a horse, trainer, jockey or course by name and get its id. | q, type, limit | Live, Archive, Complete |
horse_form | A horse's UK runs, newest first. | horse_id, limit | Live, Archive, Complete |
trainer_stats | A trainer's strike rate, A/E and level stakes, split any way. | trainer_id, by, min_runs | Complete |
jockey_stats | A jockey's strike rate, A/E and level stakes, split any way. | jockey_id, by, min_runs | Complete |
race_report | The written account of one race, with a line for every runner. | race_id | Complete |
days_upsets | The day's UK shocks, each scored 0 to 100 with the reasons. | date | Every plan |
Your key, your plan, and you can stop it any time
One address for every assistant, no install.
On Claude and ChatGPT you sign in with Google and allow it once.
The assistant picks the tool and the API answers with your plan's data.
Remove the connection on your account page, or rotate your key.
The agent skill is one file that tells any agent how to use the API well. Save it as ~/.claude/skills/horseracingapi-uk/SKILL.md, or upload it as a skill in Claude.
Download skill.mdThe MCP guide and the tools page sit with the rest of the docs, beside the endpoint each tool calls.
MCP tools page