openf1_sessions
Read-only
List Formula 1 sessions for a season or meeting, returning session_key, session type and name, start and end timestamps, meeting and circuit keys. Use a session_key from this list as the input to every session-scoped OpenF1 tool, and prefer session_type Race or Qualifying to narrow it. A valid empty filter match returns count 0 with an empty list, and a call during a live session returns 503. For finer queries, add repeatable filter= (operators >=, <=, =, >, <) to narrow by session_type or year, e.g. filter=session_type=Race; 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_sessions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | No | Optional four-digit season year. | |
| 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 session end upper bound; RFC3339 or YYYY-MM-DD. | |
| date_from | No | Optional session start lower bound; RFC3339 or YYYY-MM-DD. | |
| circuit_key | No | Optional circuit key from the meetings list. | |
| meeting_key | No | Optional positive meeting key, or latest for the current meeting. | |
| country_code | No | Optional three-letter country code such as BRA. | |
| country_name | No | Optional country name exactly as the sessions list reports it. | |
| is_cancelled | No | Optional cancelled flag filter. | |
| session_name | No | Optional session name as the source reports it, for example Qualifying or Sprint. | |
| session_type | No | Optional session type. Values: Practice, Qualifying, Race. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | The tool result payload (shape varies per tool; see each tool's docs resource). |