openf1_meetings
Retrieve Formula 1 Grand Prix and testing weekends for a season, filtered by country, circuit, location, or dates, to discover the meeting and circuit values other F1 resources filter on.
Instructions
OpenF1 Formula 1 meetings by season and filters. Returns Formula 1 Grand Prix and testing weekends from OpenF1's anonymous public API: meeting and official name, country, circuit key and type, circuit info/image URLs, GMT offset and start/end timestamps. A season query is the discovery surface for the country, circuit and meeting values the other OpenF1 resources filter on.
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 | Four-digit season year; the source serves 2023 onwards example(2024) | |
| filter | No | Repeatable upstream filter written as <attribute><operator><value>, with operators >=, <=, =, > and <. Repeated filters on the same attribute are OR'ed, a lower and upper bound form an inclusive range, and different attributes are AND'ed. Filterable attributes on this route: meeting_key, meeting_name, meeting_official_name, location, country_key, country_code, country_name, country_flag, circuit_key, circuit_short_name, circuit_type, circuit_info_url, circuit_image, gmt_offset, date_start, date_end, year, is_cancelled. | |
| date_to | No | Inclusive upper bound; RFC3339 timestamp or YYYY-MM-DD example(2026-11-08) | |
| location | No | City or geographical location of the meeting example(São Paulo) | |
| date_from | No | Inclusive lower bound; RFC3339 timestamp or YYYY-MM-DD example(2026-11-07) | |
| circuit_key | No | Circuit key from openf1-meetings example(14) | |
| circuit_type | No | Circuit type, one of Permanent, Temporary - Road, Temporary - Street | |
| country_code | No | Three-letter country code example(BRA) | |
| country_name | No | Country name exactly as the source reports it example(Brazil) | |
| is_cancelled | No | Cancelled flag filter | |
| meeting_name | No | Meeting name exactly as the source reports it example(Singapore Grand Prix) | |
| circuit_short_name | No | Circuit short name example(Interlagos) |