Get the full F1 race calendar for a season.

Use this when the user asks about the schedule, which races happened, or wants to know race names to load a session.

Args: year: Season year (e.g. 2024, 2025, 2026)

Load an F1 session for analysis. Must be called before other tools.

Use this when the user mentions a specific race, GP, or session they want to analyze. Race and session names are fuzzy-matched:

• Race: "Bahrain", "Monza", "silverstone", "Monaco GP" all work

• Session: "race", "qualifying", "quali", "FP1", "sprint" all work

Args: year: Season year (e.g. 2024) race: Grand Prix name — fuzzy matched (e.g. "Bahrain", "Monza", "silverstone") session: Session type — fuzzy matched (default "race"). Options: race, qualifying, sprint, FP1, FP2, FP3

Check if a session is currently loaded and get its details.

Use this when you need to confirm what session is active before answering a question.

List all drivers in the current session with codes, names, and teams.

Use this when the user asks who was in the session, or when you need to find a driver's 3-letter code.

Resolve a driver name, nickname, or number to their full identity.

Use this when the user refers to a driver ambiguously and you need to confirm who they mean. Handles nicknames ("Checo"), first names ("Charles"), car numbers ("44"), and partial matches ("lec").

Args: name: Any driver reference — name, nickname, abbreviation, or car number

Get the full race classification — who finished where.

Use this when the user asks about race results, who won, podium positions, DNFs, points scored, or finishing order.

Get qualifying results with Q1/Q2/Q3 times.

Use this when the user asks about qualifying positions, Q1/Q2/Q3 times, pole position, or qualifying performance.

Get lap-by-lap timing data for a specific driver.

Use this when the user asks about a driver's pace, consistency, lap time progression, or when they were fast/slow. Includes tyre compound and stint info per lap.

Driver names are fuzzy-matched: "Leclerc", "charles", "LEC" all work.

Args: driver: Driver name, code, or number (e.g. "Leclerc", "LEC", "16")

Get the fastest lap set by each driver, ranked.

Use this when the user asks about fastest laps, who set the quickest time, or lap time comparisons across the field.

Args: top_n: Number of drivers to include (default 10)

Get pit stop details — when each driver pitted and on which tyre.

Use this when the user asks about pit strategy, when someone pitted, how many stops a driver made, or undercut/overcut timing.

Args: driver: Driver name/code, or "all" for every driver (default: all)

Get tyre stint breakdown — compound, start/end lap, stint length.

Use this when the user asks about tyre strategy, which compounds were used, how long stints were, or compound choices.

Args: driver: Driver name/code, or "all" for top 10 drivers (default: all)

Get summarized telemetry stats for a driver's lap.

Returns top speed, average speed, throttle application percentage, braking intensity, and other derived metrics. Defaults to the driver's fastest lap if no lap number is specified.

Use this when the user asks about speed, braking, throttle traces, or driving style analysis.

Args: driver: Driver name, code, or number (e.g. "Verstappen", "VER", "1") lap_number: Specific lap number, or -1 for the driver's fastest lap (default: -1)

Compare two drivers across all key metrics.

Use this when the user asks to compare drivers, wants a head-to-head analysis, or asks who was better between two specific drivers.

Args: driver_a: First driver — name, code, or number driver_b: Second driver — name, code, or number

Get weather conditions during the session.

Use this when the user asks about weather, track temperature, rain, or conditions that may have affected the race.

Get a quick overview of the loaded session with key facts.

Use this as a starting point when the user asks a general question about the session, or when you need context before answering. Includes: winner, DNFs, pit stops, fastest lap, weather.

Get how track conditions changed during the session.

Use this when the user asks about track rubbering in, grip changes, whether the track got faster, or temperature effects on pace.

Get position changes and pace comparisons between consecutive drivers.

Use this when the user asks about overtakes, who was faster than the car ahead, position gains/losses, or race dynamics.