Skip to main content
Glama

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:

  1. Launch a web interface (usually at http://localhost:5173)

  2. Connect to your F1 MCP server automatically

  3. 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

-
security - not tested
F
license - not found
-
quality - not tested

Related MCP Servers

  • -
    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
  • 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
    5
    MIT License
  • -
    security
    -
    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 -
    12
    MIT License
    • Apple
    • Linux
  • 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
    • Linux
    • Apple

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Josh-Mantel/MCP-F1'

If you have feedback or need assistance with the MCP directory API, please join our Discord server