Formula One MCP Server

A Model Context Protocol (MCP) server that provides Formula One racing data. This package exposes various tools for querying F1 data including event schedules, driver information, telemetry data, and race results.

Features

Event Schedule: Access the complete F1 race calendar for any season
Event Information: Detailed data about specific Grand Prix events
Session Results: Comprehensive results from races, qualifying sessions, sprints, and practice sessions
Driver Information: Access driver details for specific sessions
Performance Analysis: Analyze a driver's performance with lap time statistics
Driver Comparison: Compare multiple drivers' performances in the same session
Telemetry Data: Access detailed telemetry for specific laps
Championship Standings: View driver and constructor standings for any season

Installation

Installing via Smithery

To install f1-mcp-server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @Machine-To-Machine/f1-mcp-server --client claude

Manual Installation

In a uv managed python project, add to dependencies by:

uv add f1-mcp-server

Alternatively, for projects using pip for dependencies:

pip install f1-mcp-server

To run the server inside your project:

uv run f1-mcp-server

Or to run it globally in isolated environment:

uvx f1-mcp-server

To install directly from the source:

git clone https://github.com/Machine-To-Machine/f1-mcp-server.git
cd f1-mcp-server
pip install -e .

Usage

Command Line

The server can be run in two modes:

Standard I/O mode (default):

uvx run f1-mcp-server

SSE transport mode (for web applications):

uvx f1-mcp-server --transport sse --port 8000

Python API

from f1_mcp_server import main

# Run the server with default settings
main()

# Or with SSE transport settings
main(port=9000, transport="sse")

API Documentation

The server exposes the following tools via MCP:

Tool Name	Description
`get_event_schedule`	Get Formula One race calendar for a specific season
`get_event_info`	Get detailed information about a specific Formula One Grand Prix
`get_session_results`	Get results for a specific Formula One session
`get_driver_info`	Get information about a specific Formula One driver
`analyze_driver_performance`	Analyze a driver's performance in a Formula One session
`compare_drivers`	Compare performance between multiple Formula One drivers
`get_telemetry`	Get telemetry data for a specific Formula One lap
`get_championship_standings`	Get Formula One championship standings

See the FastF1 documentation for detailed information about the underlying data: FastF1 Documentation

Dependencies

anyio (>=4.9.0)
click (>=8.1.8)
fastf1 (>=3.5.3)
mcp (>=1.6.0)
numpy (>=2.2.4)
pandas (>=2.2.3)
uvicorn (>=0.34.0)

Development

Setup Development Environment

git clone https://github.com/Machine-To-Machine/f1-mcp-server.git
cd f1-mcp-server
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e ".[dev]"

Code Quality

# Run linting
uv run ruff check .

# Run formatting check
uv run ruff format --check .

# Run security checks
uv run bandit -r src/

Contribution Guidelines

Fork the repository
Create a feature branch: git checkout -b feature-name
Commit your changes: git commit -am 'Add some feature'
Push to the branch: git push origin feature-name
Submit a pull request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Authors

Machine To Machine

Acknowledgements

This project leverages FastF1, an excellent Python package for accessing Formula 1 data. We are grateful to its maintainers and contributors.

This project was inspired by rakeshgangwar/f1-mcp-server which was written in TypeScript. The f1_data.py module was mostly adapted from their source code.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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.

Tools

A Model Context Protocol server that provides comprehensive Formula One racing data, enabling access to event schedules, driver information, telemetry data, race results, and performance analytics through natural language queries.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Strava MCP Server
tomekkorbak
A
security
A
license
A
quality
A Model Context Protocol server that provides language models with access to Strava API data, allowing them to query and analyze athlete activities from Strava.
Last updated -
4
13
Python
MIT License
Strava MCP Server
ctvidic
-
security
A
license
-
quality
A Model Context Protocol server that enables language models to interact with Strava data, including activities, athlete statistics, routes, achievements, and social features.
Last updated -
2
Python
MIT License
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
3
JavaScript
MIT License
Juhe News MCP Serverofficial
juhemcp
A
security
F
license
A
quality
A Model Context Protocol server that enables large language models to access the latest trending news headlines and detailed content across various categories including recommended, domestic, technology, and sports news.
Last updated -
2
Python

View all related MCP servers

Formula One MCP Server