F1 MCP Server

A Model Context Protocol (MCP) server that provides Formula 1 data using the FastF1 Python package.

Features

Get race schedules for any F1 season
Retrieve session results (practice, qualifying, race)
Access lap times and telemetry data
Driver and constructor standings
Circuit information

Quick Start

Prerequisites

Python 3.13
uv package manager

1. Install uv (if not already installed)

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Setup F1 MCP Server

# Quick setup
./quick-start.sh

# Or manually
make install
# or: uv sync && uv pip install -e .

3. Run the server

# MCP mode (for MCP Inspector)
make mcp

# HTTP mode (for OAuth testing)  
make http

# With MCP Inspector
make inspector

MCP Inspector Setup

The MCP Inspector is a powerful tool for testing and debugging MCP servers. Here's how to set it up:

1. Install Node.js (if not already installed)

# macOS with Homebrew
brew install node

# Or download from https://nodejs.org/

2. Install MCP Inspector

# Install globally with npm
npm install -g @modelcontextprotocol/inspector

# Verify installation
mcp-inspector --version

3. Run F1 MCP Server with Inspector

# Using make command (recommended)
make inspector

# Or manually
mcp-inspector uv run python -m f1_mcp_server.server

4. Using MCP Inspector

Once started, the inspector will:

Launch a web interface (usually at http://localhost:5173)
Connect to your F1 MCP server automatically
Provide an interactive UI to test all available tools

Available F1 Tools in Inspector:

get_race_schedule - Browse F1 race calendars
get_session_results - View race/qualifying results
get_driver_standings - Check championship standings
get_constructor_standings - Team championship data
get_lap_times - Detailed lap timing analysis

5. Example Usage in Inspector

Try these sample requests in the MCP Inspector:

Get 2024 Race Schedule:

{
  "year": 2024
}

Get Monaco GP Race Results:

{
  "year": 2024,
  "round_number": 8,
  "session": "R"
}

Get Lap Times for Verstappen:

{
  "year": 2024,
  "round_number": 1,
  "session": "R",
  "driver": "VER"
}

Troubleshooting MCP Inspector

Inspector won't start:

# Check Node.js version (needs 16+)
node --version

# Reinstall inspector
npm uninstall -g @modelcontextprotocol/inspector
npm install -g @modelcontextprotocol/inspector

Server connection issues:

# Test server directly first
make test-startup

# Check if server starts without inspector
make mcp

Port conflicts:

# Inspector uses port 5173 by default
# Kill any processes using the port
lsof -ti:5173 | xargs kill -9

Usage with MCP Inspector

The MCP Inspector provides a web-based interface for testing F1 data tools:

# Install MCP Inspector (requires Node.js)
npm install -g @modelcontextprotocol/inspector

# Run F1 server with inspector
make inspector

# Or manually
mcp-inspector uv run python -m f1_mcp_server.server

Inspector Features:

Interactive web UI at http://localhost:5173
Real-time F1 data testing
JSON schema validation
Tool documentation browser

Available Tools

get_race_schedule: Get the race schedule for a specific season
get_session_results: Get results for a specific session
get_driver_standings: Get driver championship standings
get_constructor_standings: Get constructor championship standings
get_lap_times: Get lap times for a specific session

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Provides comprehensive Formula 1 data access including race schedules, session results, lap times, telemetry data, driver/constructor standings, and circuit information. Enables users to retrieve and analyze F1 racing data through natural language queries using the FastF1 Python package.

Related MCP Servers

Soccer MCP Server
obinopaul
-
security
F
license
-
quality
Provides programmatic access to comprehensive football statistics and live match data via API-Football, enabling applications to retrieve league standings, team fixtures, player statistics, and real-time match events.
Last updated -
4
Formula One MCP Server
rakeshgangwar
A
security
A
license
A
quality
Provides Formula One data and statistics through a Model Context Protocol interface, allowing users to access race calendars, session results, driver statistics, telemetry data, and championship standings.
Last updated -
8
4
MIT License
Formula1 MCP Server
Panth1823
-
security
A
license
-
quality
Provides real-time and historical Formula 1 racing data through the Model Context Protocol, offering access to timing data, driver stats, race results, telemetry, and more.
Last updated -
11
MIT License
Formula One MCP Server (Python)
Machine-To-Machine
A
security
A
license
A
quality
This project implements a Model Context Protocol (MCP) server providing Formula One racing data using the Python FastF1 library. Inspired by an existing TypeScript server, it offers similar F1 data functionalities natively in Python via FastF1.
Last updated -
8
1
MIT License

View all related MCP servers

F1 MCP Server

F1 MCP Server

Features

Quick Start

Prerequisites

1. Install uv (if not already installed)

2. Setup F1 MCP Server

3. Run the server

MCP Inspector Setup

1. Install Node.js (if not already installed)

2. Install MCP Inspector

3. Run F1 MCP Server with Inspector

4. Using MCP Inspector

5. Example Usage in Inspector

Troubleshooting MCP Inspector

Usage with MCP Inspector

Available Tools

Related MCP Servers

Soccer MCP Server

Formula One MCP Server

Formula1 MCP Server

Formula One MCP Server (Python)

New MCP Servers

MCP directory API