home / mcp / f1 mcp server

F1 MCP Server

Provides comprehensive F1 data and analytics via an MCP server for Claude Desktop integration.

Installation

Add the following to your MCP client configuration file.

Configuration

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

You have a Formula 1 MCP server that exposes rich data and analytics for Claude Desktop. It provides access to race results, telemetry, timing, strategy, standings, live data, and other track information, enabling you to ask Claude natural questions and receive structured, data-backed answers. This guide shows you how to install, configure, and use the server so you can start querying F1 data efficiently.

How to use

You interact with the F1 MCP server through an MCP client such as Claude Desktop. After configuring the server, you can ask questions like the following to retrieve precise insights:

How to install

Follow these steps to install the F1 MCP server locally and prepare Claude Desktop to connect to it.

# Prerequisites
# Ensure you have Python 3.10 or higher and Claude Desktop installed

# Step 1: Clone the repository
git clone https://github.com/drivenrajat/f1.git
cd f1

# Step 2: Create a virtual environment
python -m venv venv
# On macOS/Linux
source venv/bin/activate
# On Windows
venv\Scripts\activate

# Step 3: Install dependencies in editable mode
pip install -e .

Once installed, configure Claude Desktop to connect to the MCP server. You will add a server entry that points to the local Python process running the server. Two example configurations are shown.

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

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

Additional sections

The server can be connected in multiple ways via Claude Desktop. Choose the method that best fits your setup. In both cases, you enable Claude to issue data queries against the MCP server and receive structured responses that combine race data, telemetry, timing, standings, and live information.

Note: The server uses data sources such as FastF1, Ergast, and OpenF1 to provide historical and current Formula 1 data, which enhances the breadth of responses Claude can generate.

Available tools

race_results

Provides race results and classifications for a given event or season.

qualifying_progression

Returns Q1/Q2/Q3 progression for a specific race or season.

telemetry_speed_trace

Compares speed traces between drivers and visualizes speed deltas.

pit_stop_data

Offers pit stop times, fastest stops, and stint analyses.

driver_standings

Returns current driver championship standings and historical changes.

constructor_standings

Provides constructor standings and historical context.

live_lap_times

Live lap times and positions for ongoing sessions.

weather_track

Current weather conditions and track status during events.