OpenF1

Fetch Formula 1 data from openF1.org via MCP tools (drivers, teams, races, sessions, results, laps, stints, pit stops, weather, incidents, car data, positions).

python

0

GitHub Stars

python

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jimmyjoe009-openf1_mcp": {
      "command": "python",
      "args": [
        "-m",
        "src.server"
      ]
    }
  }
}

You run an MCP server that connects to the openF1.org API to fetch Formula 1 data using a stdio transport. This server provides convenient tools to access drivers, teams, races, sessions, results, laps, stints, pit stops, weather, incidents, car data, and live positions, all via a local MCP endpoint.

How to use

Start the MCP server locally and connect your MCP client to it. The server exposes a collection of tools you can call to fetch up-to-date Formula 1 data from openF1.org. Use the tools to retrieve data for a specific season, round, or driver, and to drill into session details, lap data, weather, incidents, and telemetry as needed. You can run the server once and keep it available to answer multiple tool requests from your client.

How to install

Prerequisites: Python must be installed on your machine. You will also need access to the internet to fetch API data from openF1.org.

Clone or download the project to your local machine.
Install dependencies.

pip install -r requirements.txt

Running the server

Run the MCP server using the stdio transport. This starts a local process that your MCP client can connect to.

python -m src.server

Connecting to the server from your MCP client

Add the server as an MCP connection by configuring your client to use the stdio-based command that starts the server. The example configuration shows how to launch the MCP server from your environment.

{
  "mcpServers": {
    "openf1": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "/path/to/openf1_mcp"
    }
  }
}

Available tools by capability

The server exposes a set of tools you can call to retrieve F1 data. Each tool returns data filtered by optional parameters such as season, round, session, or driver number.

Available tools

list_drivers

Fetch F1 drivers. Optionally filter by season or driver number.

list_teams

Fetch F1 teams. Optionally filter by season.

list_races

Fetch F1 races. Optionally filter by season or round number.

list_sessions

Fetch F1 sessions (practice, qualifying, race).

list_results

Fetch race results. Optionally filter by session or driver.

list_laps

Fetch lap data from a session.

list_stints

Fetch stint data (tire stints).

list_pit_stops

Fetch pit stop data from a session.

get_weather

Fetch weather data for a session.

list_incidents

Fetch incident data (collisions, penalties, etc.).

get_car_data

Fetch car telemetry data (throttle, brake, DRS, etc.).

list_positions

Fetch position data (live positions during session).