Content
# Fast-F1 MCP Server
An MCP (Model Context Protocol) server that provides Formula 1 data through the [Fast-F1](https://github.com/theOehrly/Fast-F1) Python library. Query race results, lap times, telemetry, tyre strategies, weather, and more — directly from Claude or any MCP client.
## Tools
| Tool | Description |
|------|-------------|
| `get_schedule` | Event schedule for a season |
| `get_event_info` | Detailed info for a specific race weekend |
| `get_session_results` | Official results (race, qualifying, sprint, practice) |
| `get_championship_standings` | Driver and constructor standings through a given round |
| `get_lap_times` | Lap and sector times with driver/lap/compound filtering |
| `get_tyre_strategy` | Stint breakdown per driver (compound, lap range, avg pace) |
| `compare_drivers` | Head-to-head performance comparison (2-4 drivers) |
| `get_telemetry` | Speed, throttle, brake, gear, RPM traces for a specific lap |
| `get_weather` | Air/track temperature, humidity, wind, rainfall during a session |
| `get_race_control_messages` | Flags, penalties, safety cars, DRS activations |
| `get_circuit_info` | Corner locations, marshal sectors, track layout |
## Data Availability
- **Telemetry** (speed, throttle, brake, etc.): 2018 onwards
- **Lap times and results**: 2018 onwards (full detail)
- **Basic results**: 1950 onwards (via Ergast)
## Setup
Requires [uv](https://docs.astral.sh/uv/) and Python 3.11+.
```bash
git clone https://github.com/warshanks/Fast-F1-mcp.git
cd Fast-F1-mcp
uv sync
```
### Claude Code
Add to `~/.claude/mcp.json` or your project's `.mcp.json`:
```json
{
"mcpServers": {
"fast-f1": {
"command": "uv",
"args": [
"--directory",
"/path/to/Fast-F1-mcp",
"run",
"fast-f1-mcp"
]
}
}
}
```
### Claude Desktop
Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
```json
{
"mcpServers": {
"fast-f1": {
"command": "uv",
"args": [
"--directory",
"/path/to/Fast-F1-mcp",
"run",
"fast-f1-mcp"
]
}
}
}
```
## Configuration
| Environment Variable | Default | Description |
|---------------------|---------|-------------|
| `FASTF1_CACHE_DIR` | `~/.cache/fastf1` | Directory for Fast-F1's HTTP response cache |
| `FASTF1_MAX_SESSIONS` | `5` | Max sessions held in memory (LRU eviction) |
## Example Queries
Once configured, you can ask Claude things like:
- "Who won the 2024 Italian Grand Prix?"
- "Show me Verstappen's lap times from the 2024 Bahrain race"
- "Compare Hamilton and Norris at Silverstone 2024"
- "What tyre strategy did Leclerc use at Monza 2024?"
- "Show me Verstappen's telemetry from his fastest qualifying lap at Spa 2024"
- "What were the race control messages during the 2024 Monaco Grand Prix?"
- "What was the weather like during the 2024 British GP?"
## License
MIT
