HORSERACINGAPI --:--:-- UTC Sign inFree key

Documentation / More

MCP tools

16 tools, one for each endpoint an assistant needs. Each takes the same parameters as its endpoint and answers in the same shape, under your plan. The server is at https://horseracingapi.org/mcp; the MCP guide says how to add it.

latest_resultsResults plan

The newest results, as they are declared, each with its full finishing order.

Calls GET /v1/results/latest

ParameterTypeRequiredWhat it is
countrystringNoOnly this nation: USA, GB, IRE, FR or RSA.
per_pageintegerNoHow many to a page, 1 to 50. Default 25.
yesterdays_resultsFree key

Every result from yesterday, at each course's own day, meeting by meeting.

Calls GET /v1/results/yesterday

ParameterTypeRequiredWhat it is
countrystringNoOnly this nation: USA, GB, IRE, FR or RSA.
per_pageintegerNoHow many to a page, 1 to 25. Default 10.
results_on_dateResults plan

Every result for any day since 1 January 2022, meeting by meeting.

Calls GET /v1/results/{date}

ParameterTypeRequiredWhat it is
datedateYesThe day, YYYY-MM-DD, from 2022-01-01.
countrystringNoOnly this nation: USA, GB, IRE, FR or RSA.
per_pageintegerNoHow many to a page, 1 to 25. Default 10.
search_racesResults plan

Races by date, nation, course, race type, going or surface.

Calls GET /v1/races/search

ParameterTypeRequiredWhat it is
date_fromdateNoFrom this day. The archive starts on 2022-01-01.
date_todateNoUp to this day. Defaults to today.
countrystringNoOnly this nation: USA, GB, IRE, FR or RSA.
course_idstringNoOnly this course.
race_typestringNoFlat, Hurdle, Chase and so on.
goingstringNoThe going, as published.
surfacestringNoTurf, Dirt or All Weather.
handicapbooleanNotrue for handicaps only, false for none.
per_pageintegerNoHow many to a page, 1 to 100. Default 25.
get_raceResults plan

One race in full: the conditions, the time and every runner in finishing order.

Calls GET /v1/races/{race_id}

ParameterTypeRequiredWhat it is
race_idstringYesThe race, as returned by any results or search call.
get_meetingResults plan

A meeting and every race run at it.

Calls GET /v1/meetings/{meeting_id}

ParameterTypeRequiredWhat it is
meeting_idstringYesThe meeting.
find_horseResults plan

Find a horse by name.

Calls GET /v1/horses/search

ParameterTypeRequiredWhat it is
qstringYesPart of the name, two letters or more.
per_pageintegerNoHow many to a page, 1 to 100. Default 25.
get_horseResults plan

A horse's profile, its current trainer and owner, and its record since 2022.

Calls GET /v1/horses/{horse_id}

ParameterTypeRequiredWhat it is
horse_idstringYesThe horse.
horse_formResults plan

The last ten runs, newest first.

Calls GET /v1/horses/{horse_id}/form

ParameterTypeRequiredWhat it is
horse_idstringYesThe horse.
find_jockeyResults plan

Find a jockey by name.

Calls GET /v1/jockeys/search

ParameterTypeRequiredWhat it is
qstringYesPart of the name, two letters or more.
per_pageintegerNoHow many to a page, 1 to 100. Default 25.
get_jockeyResults plan

A jockey's profile and record since 2022.

Calls GET /v1/jockeys/{jockey_id}

ParameterTypeRequiredWhat it is
jockey_idstringYesThe jockey.
jockey_ridesResults plan

The last ten rides, newest first.

Calls GET /v1/jockeys/{jockey_id}/rides

ParameterTypeRequiredWhat it is
jockey_idstringYesThe jockey.
get_trainerResults plan

A trainer's profile and record since 2022.

Calls GET /v1/trainers/{trainer_id}

ParameterTypeRequiredWhat it is
trainer_idstringYesThe trainer, from any result.
get_ownerResults plan

An owner's record since 2022.

Calls GET /v1/owners/{owner_id}

ParameterTypeRequiredWhat it is
owner_idstringYesThe owner, from any result.
list_coursesFree key

Every course in the five nations, with its latest meeting.

Calls GET /v1/courses

ParameterTypeRequiredWhat it is
countrystringNoOnly this nation: USA, GB, IRE, FR or RSA.
my_usageFree key

Your calls today and this month, and your limits. Never counted against them.

Calls GET /v1/usage

Takes no parameters.

PreviousMCP serverNextAgent skill