openf1_race_control
Retrieve Formula 1 race-control messages by session or date range, filtered by category, flag, scope, lap, driver, or sector to track incidents, safety cars, DRS, and session status.
Instructions
OpenF1 Formula 1 race control messages. Returns race-control messages: session status, incidents, flags, safety car and DRS events, with category, flag, scope, sector, lap number, qualifying phase and the message text. Use session_key for one session, or a date window to sweep a range.
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_race_control"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flag | No | Flag type, one of BLACK AND WHITE, BLUE, CHEQUERED, CLEAR, DOUBLE YELLOW, GREEN, RED, YELLOW Enums(BLACK AND WHITE,BLUE,CHEQUERED,CLEAR,DOUBLE YELLOW,GREEN,RED,YELLOW) example(BLACK AND WHITE) | |
| scope | No | Event scope; one of Track, Driver, Sector Enums(Track,Driver,Sector) | |
| 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, session_key, date, driver_number, lap_number, category, flag, scope, sector, qualifying_phase, message. | |
| sector | No | Track sector the message refers to, starting at 1 | |
| date_to | No | Inclusive upper bound; RFC3339 timestamp or YYYY-MM-DD example(2026-11-08) | |
| category | No | Race-control category, one of CarEvent, Drs, Flag, Other, SafetyCar, SessionStatus Enums(CarEvent,Drs,Flag,Other,SafetyCar,SessionStatus) example(Flag) | |
| date_from | No | Inclusive lower bound; RFC3339 timestamp or YYYY-MM-DD example(2026-11-07) | |
| lap_number | No | Lap number within the session, starting at 1 example(8) | |
| meeting_key | No | Positive meeting key from openf1-meetings, or `latest` for the current meeting example(1299) | |
| session_key | No | Positive session key from openf1-sessions, or `latest` for the current session example(11408) | |
| driver_number | No | Positive permanent driver number (see openf1-drivers) example(1) | |
| qualifying_phase | No | Qualifying phase, 1 to 3 |