openf1_meetings
List Formula 1 meetings (Grand Prix and testing weekends) for a season, returning meeting keys, names, country, circuit keys and start/end dates. Use year 2023 or later, or other filters; this is the discovery step that yields the meeting_key the session-scoped OpenF1 tools take. A valid empty filter match returns count 0 with an empty list, and an anonymous call during a live session returns 503. For finer queries, add repeatable filter= (operators >=, <=, =, >, <) to narrow by year or country_name, e.g. filter=year=2026; repeated filters on one attribute are OR'ed and ranges are inclusive.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "openf1_meetings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Optional four-digit season year; the source currently serves 2023 onwards. | |
| filter | No | Repeatable upstream filter expression written as <attribute><operator><value> with operators >=, <=, =, > and <. Repeated filters on the same attribute are OR'ed, ranges are inclusive, and unknown attributes or values are rejected before the upstream call. | |
| date_to | No | Optional meeting end upper bound; RFC3339 or YYYY-MM-DD. | |
| location | No | Optional city or geographical location of the meeting. | |
| date_from | No | Optional meeting start lower bound; RFC3339 or YYYY-MM-DD. | |
| circuit_key | No | Optional circuit key from the meetings list. | |
| circuit_type | No | Optional circuit type. Values: Permanent, Temporary - Road, Temporary - Street. | |
| country_code | No | Optional three-letter country code such as BRN. | |
| country_name | No | Optional country name exactly as the meetings list reports it. | |
| is_cancelled | No | Optional cancelled flag filter. | |
| meeting_name | No | Optional meeting name such as Singapore Grand Prix. | |
| circuit_short_name | No | Optional circuit short name such as Interlagos. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | The tool result payload (shape varies per tool; see each tool's docs resource). |