races_search
Search finished races by name on a timing platform, optionally filtered by year, to get event or race IDs for results and event lookups.
Instructions
races: Find a race. GET /v1/races/search. Searches finished races by name on one timing platform. Each hit carries the ids /v1/races/events and /v1/races/results take: athlinks hits list their recent editions (event_id), runsignup hits give a race_id, raceroster hits give a numeric event_id. An empty list costs 0 credits. Costs 1 credit when it succeeds. Costs 0 credits when events is empty. Errors, blocked or timed-out requests, invalid requests and cache hits cost nothing. A not-found or empty result is charged only where that operation's published cost says so.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"platform": "<platform>",
"query": "<query>"
},
"name": "races_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Only races held in this four-digit year. | |
| query | Yes | Race name to search for. | |
| platform | Yes | Timing platform: runsignup, athlinks (also carries ChronoTrack events) or raceroster. | |
| cache_max_age | No | Serve a cached response when it is newer than this. A cache hit costs 0 credits. |