Horse racing MCP server

Ask in plain English.

Put every race since 2022 in front of Claude, ChatGPT, Cursor or Claude Code. Ask who won, where a horse finished, or how a jockey has ridden lately, and the assistant calls HorseRacingAPI for the answer, from the official results of five nations.

Addresshttps://horseracingapi.org/mcp

Get a free key See every tool

An example

Who won the Derby at Epsom in 2024, and what has the winner done since?

search_races course Epsom, June 2024 get_race the Derby horse_form the winner

City Of Troy won the Derby at Epsom Downs on 1 June 2024, ridden by R L Moore for A P O'Brien, from Ambiente Friendly and Los Angeles.

Its last ten runs follow, newest first, each with the course, going, finishing position and distance beaten.

Add it to your assistant

Two minutes, once.

Claude and ChatGPT sign you in with your HorseRacingAPI account, with no key to paste. Cursor and Claude Code take your key in a header. Either way your plan applies, as it does to the API.

Claude

Open Settings, then Connectors, and choose Add custom connector.
Paste the address and name it HorseRacingAPI.
Sign in with your account when asked, and allow access.

ChatGPT

Open Settings, then Connectors, and create a connector.
Paste the address, with OAuth as the sign-in.
Sign in with your account when asked, and allow access.

Claude Code

One command, with your key from your account.

claude mcp add --transport http horseracingapi https://horseracingapi.org/mcp --header "X-API-Key: hra_live_…"

Cursor

Add it to your mcp.json, with your key.

{
  "mcpServers": {
    "horseracingapi": {
      "url": "https://horseracingapi.org/mcp",
      "headers": { "X-API-Key": "hra_live_…" }
    }
  }
}

The tools

16 tools, one per job.

Each tool is an endpoint of the API, with the same parameters and the same answer. Every one is read-only.

On the free keyOn the Results plan

latest_resultsThe newest results, as they are declared, each with its full finishing order.yesterdays_resultsEvery result from yesterday, at each course's own day, meeting by meeting.results_on_dateEvery result for any day since 1 January 2022, meeting by meeting.search_racesRaces by date, nation, course, race type, going or surface.get_raceOne race in full: the conditions, the time and every runner in finishing order.get_meetingA meeting and every race run at it.find_horseFind a horse by name.get_horseA horse's profile, its current trainer and owner, and its record since 2022.horse_formThe last ten runs, newest first.find_jockeyFind a jockey by name.get_jockeyA jockey's profile and record since 2022.jockey_ridesThe last ten rides, newest first.get_trainerA trainer's profile and record since 2022.get_ownerAn owner's record since 2022.list_coursesEvery course in the five nations, with its latest meeting.my_usageYour calls today and this month, and your limits. Never counted against them.

For agents

Teach it the whole API.

An agent that writes its own calls reads the skill once and knows every endpoint, limit and error. Save it as ~/.claude/skills/horseracingapi/SKILL.md, or upload it as a skill in Claude's settings.

Agent skill

https://horseracingapi.org/skill.md

One file that teaches an agent the whole API: what it is for, the calls that answer the common questions, the limits and the errors.

The full manual

https://horseracingapi.org/documentation/manual.md

Every endpoint, parameter, sample and guide in one markdown file, to paste into any assistant.

Your plan applies

Free to start.

On the free key, the assistant reads yesterday's results, the courses and your usage, 3 tools and 50 calls a day. The Results plan opens every tool and every race since 2022, 30,000 calls a month. A tool your plan does not open says so, and names the plan that does.

See the plans

Questions people ask

Does a tool call count against my allowance?

Yes, one call each, the same as the API. my_usage never counts.

Can the assistant see odds or tips?

No. The data is official results only: no odds, breeding or predictions, on any plan.

How far back can it look?

To 1 January 2022 on the Results plan, in all five nations. The free key reads yesterday.

How do I stop it?

Remove the connector in your assistant, or remove its connection under Keys in your account. It stops at once.