get_lap_telemetry
Retrieve sampled telemetry data for a specific F1 lap, including speed, throttle, brake, gear, and DRS. Optionally export to CSV for analysis.
Instructions
Get telemetry data for a specific lap.
Data source: FastF1 Live Timing Coverage: 2018-present
Set export_path=True when the user mentions data analysis, notebooks,
pandas, ML, "plot the telemetry", "save the trace", or downstream
processing — the sampled per-distance trace is written to CSV.
Telemetry responses with the default 200 sample points also auto-export
so the user always gets a real file path in the project.
Args:
year: Season year (2018+)
event: Race name or round number
session: Session type (R, Q, S, FP1, FP2, FP3)
driver: Driver code (e.g., "VER")
lap: Lap number or "fastest" (default)
sample_size: Number of telemetry points to return (default 200, max 500)
export_path: If True, write the sampled data array to a CSV in
the configured export directory (default
./fastf1-exports/, override via FASTF1_MCP_EXPORT_DIR)
and omit data from the response. Pass a string for a
custom directory or .csv file path. The server also
auto-exports when data would exceed
FASTF1_MCP_AUTO_EXPORT_ROWS rows (default 50). Use a
larger sample_size if you want more detail in the
exported file.
Returns: { "driver": "VER", "lapNumber": 42, "lapTime": "0:01:23.456", "summary": { "samplePoints": 200, "maxSpeedKph": 327.5, "minSpeedKph": 80.2, "avgSpeedKph": 218.1, "maxGear": 8, "brakingZones": 7, "fullThrottlePct": 64.5 }, "data": [ {"distance": 0.0, "speed": 280.0, "throttle": 95.0, "brake": false, "gear": 7, "drs": 0}, ... ] }
Example: get_lap_telemetry(2024, "Monaco", "Q", "VER") → fastest Q lap telemetry get_lap_telemetry(2024, "Monaco", "R", "VER", lap=45) → lap 45 telemetry
Note:
Raw telemetry has 5000+ points per lap. Response is sampled to
sample_size evenly-spaced distance points (capped at 500).
summary lets a caller answer top-speed / braking-zone questions
without parsing the full per-distance array.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | ||
| event | Yes | ||
| session | Yes | ||
| driver | Yes | ||
| lap | No | fastest | |
| sample_size | No | ||
| export_path | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||