F1 MCP Server

A Model Context Protocol (MCP) server that provides comprehensive Formula 1 data and analytics for Claude Desktop integration.

Features

This server exposes 36+ tools for accessing F1 data:

Race Data

Race results and classifications
Sprint race results
Qualifying progression (Q1, Q2, Q3)
Grid vs finish comparisons
DNF lists and retirement reasons

Telemetry & Analysis

Speed trace comparisons between drivers
Gear shift visualizations
Brake and throttle analysis
RPM and engine data
DRS usage patterns

Timing & Laps

Fastest lap data with sector times
Lap-by-lap timing
Deleted laps (track limits)
Lap consistency statistics
Personal best laps

Strategy

Tire compound analysis
Stint breakdowns
Pit stop data and fastest stops
Starting tire choices
Strategy comparisons

Standings & History

Driver championship standings
Constructor standings
Historical race winners
Track records

Live Data

Live session status
Real-time positions
Live lap times
Live telemetry
Current weather conditions

Other

Team radio links
Race control messages
Track status (flags, safety car)
Weather data
Circuit information

Installation

Prerequisites

Python 3.10 or higher
Claude Desktop

Setup

Clone this repository:

git clone https://github.com/drivenrajat/f1.git
cd f1

Create a virtual environment:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

Install dependencies:

pip install -e .

Configure Claude Desktop

Add this server to your Claude Desktop MCP configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "f1": {
      "command": "python",
      "args": ["/path/to/f1/f1_server.py"]
    }
  }
}

Or if using uv:

{
  "mcpServers": {
    "f1": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/f1", "python", "f1_server.py"]
    }
  }
}

Usage

Once configured, you can ask Claude questions like:

"Show me the 2024 F1 calendar"
"Get the race results from Monaco 2024"
"Compare telemetry between Verstappen and Norris at Silverstone qualifying"
"What was Hamilton's tire strategy at Spa?"
"Show me the current driver standings"
"Get the fastest pit stops from the Italian GP"

Data Sources

FastF1: Historical telemetry, lap times, and session data
Ergast API: Championship standings and historical results
OpenF1 API: Team radio recordings

Caching

The server automatically caches FastF1 data in a cache directory to improve performance on repeated queries.

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

f1

Documentation