Formula1 MCP Server

The Formula1 MCP Server ! 🏎️💨

A TypeScript-based Formula 1 MCP server, bringing the thrill of real-time and historical F1 racing data straight to your fingertips via the Model Context Protocol. Faster than Verstappen on a hot lap! (Okay, maybe not that fast, but it's trying!)

Resources

Access F1 session data via standardized URIs
Real-time telemetry data
Historical race information
Driver and constructor standings
Weather data
Circuit information

Getting Started

Quick Install via Smithery

To install the Formula 1 MCP Server automatically via Smithery:

npx -y @smithery/cli install @Panth1823/formula1-mcp --client claude

Manual Installation

Clone the repo:

git clone https://github.com/Panth1823/formula1-mcp
cd formula1-mcp

Install:

npm install

Build:

npm run build

Setup

Add to your MCP client config:

{
  "mcpServers": {
    "formula1": {
      "command": "node",
      "args": ["<path-to-your-cloned-repo>/build/index.js"],
      "cwd": "<path-to-your-cloned-repo>",
      "enabled": true
    }
  }
}

Config locations:

Windows: %APPDATA%\.cursor\mcp.json
MacOS: ~/.cursor/mcp.json
Linux: ~/.config/.cursor/mcp.json

Available Tools

1. `getLiveTimingData`

Get real-time timing data for the current session.

Parameters:

None required

2. `getCurrentSessionStatus`

Get status information about the current session.

Parameters:

None required

3. `getDriverInfo`

Get information about a specific driver.

Parameters:

driverId (string): Driver identifier (e.g., "max_verstappen", "lewis_hamilton")

4. `getHistoricalSessions`

Find session keys for historical events.

Parameters:

year (number, optional): Season year (e.g., 2023)
circuit_short_name (string, optional): Circuit name (e.g., "monza", "spa")
country_name (string, optional): Country name (e.g., "Italy", "Belgium")
session_name (string, optional): Session type (e.g., "Race", "Qualifying")

5. `getHistoricRaceResults`

Get race results for a specific historical race.

Parameters:

year (number): Season year (e.g., 2023)
round (number): Race number (e.g., 1, 2, 3)

6. `getDriverStandings`

Get driver championship standings.

Parameters:

year (number): Season year (e.g., 2023)

7. `getConstructorStandings`

Get constructor championship standings.

Parameters:

year (number): Season year (e.g., 2023)

8. `getLapTimes`

Get lap times for a specific driver.

Parameters:

year (number): Season year (e.g., 2023)
round (number): Race number (e.g., 1, 2, 3)
driverId (string): Driver identifier (e.g., "max_verstappen", "lewis_hamilton")

9. `getWeatherData`

Get weather data for a session.

Parameters:

sessionKey (string, optional): Session identifier

10. `getCarData`

Get detailed car telemetry data.

Parameters:

driverNumber (string): Driver's car number (e.g., "44", "33")
sessionKey (string, optional): Session identifier
filters (string, optional): Data filters

11. `getPitStopData`

Get pit stop information.

Parameters:

driverNumber (string, optional): Driver's car number
sessionKey (string, optional): Session identifier

12. `getTeamRadio`

Get team radio communications.

Parameters:

driverNumber (string, optional): Driver's car number
sessionKey (string, optional): Session identifier

13. `getRaceControlMessages`

Get race control messages.

Parameters:

sessionKey (string, optional): Session identifier

14. `getRaceCalendar`

Get the F1 race calendar.

Parameters:

year (number): Season year (e.g., 2023)

15. `getCircuitInfo`

Get detailed circuit information.

Parameters:

circuitId (string): Circuit identifier (e.g., "monza", "spa")

16. `getSeasonList`

Get a list of available F1 seasons.

Parameters:

limit (number, optional): Number of seasons to return

17. `getQualifyingResults`

Get qualifying session results.

Parameters:

year (number): Season year (e.g., 2023)
round (number): Race number (e.g., 1, 2, 3)

18. `getDriverInformation`

Get detailed driver information from Ergast API.

Parameters:

driverId (string): Driver identifier (e.g., "max_verstappen", "lewis_hamilton")

19. `getConstructorInformation`

Get detailed constructor information from Ergast API.

Parameters:

constructorId (string): Constructor identifier (e.g., "red_bull", "mercedes")

20. `clearCache`

Clear the local cache for F1 data.

Parameters:

None required

Data Sources

Live data: F1 Live Timing API (OpenF1)
Historical: Ergast API (FastF1)

Examples

"Show 2023 Monaco GP results"
"Get current standings"
"Weather at Silverstone"
"Hamilton's lap times"
"Show 2024 calendar"
"Verstappen's info"
"Japanese GP qualifying"

Debug

Use MCP Inspector for debugging.

Help

Bugs? Report here
Questions? Open an issue
Want to help? Submit a PR

License

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

This server cannot be installed

security - not tested

license - permissive license

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

Related MCP Servers

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
JavaScript
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
Python
MIT License
MCP Yahoo Finance
leoncuhk
A
security
F
license
A
quality
Provides tools to get financial data (stock prices, company information) and generate financial visualizations through the Model Context Protocol.
Last updated -
10
4
Python
Finance MCP Server
dino65-dev
-
security
A
license
-
quality
Provides real-time financial data from Yahoo Finance to Large Language Models through the Model Context Protocol, enabling AI models to access stock prices, historical data, and company information.
Last updated -
Python
MIT License

View all related MCP servers

Appeared in Searches

An overview or resources related to Big Data

The Formula1 MCP Server ! 🏎️💨

Resources

Getting Started

Quick Install via Smithery

Manual Installation

Setup

Available Tools

1. getLiveTimingData

2. getCurrentSessionStatus

3. getDriverInfo

4. getHistoricalSessions

5. getHistoricRaceResults

6. getDriverStandings

7. getConstructorStandings

8. getLapTimes

9. getWeatherData

10. getCarData

11. getPitStopData

12. getTeamRadio

13. getRaceControlMessages

14. getRaceCalendar

15. getCircuitInfo

16. getSeasonList

17. getQualifyingResults

18. getDriverInformation

19. getConstructorInformation

20. clearCache

Data Sources

Examples

Debug

Help

License

Related MCP Servers

Formula One MCP Server

Formula One MCP Server (Python)

MCP Yahoo Finance

Finance MCP Server

Appeared in Searches

New MCP Servers

MCP directory API

1. `getLiveTimingData`

2. `getCurrentSessionStatus`

3. `getDriverInfo`

4. `getHistoricalSessions`

5. `getHistoricRaceResults`

6. `getDriverStandings`

7. `getConstructorStandings`

8. `getLapTimes`

9. `getWeatherData`

10. `getCarData`

11. `getPitStopData`

12. `getTeamRadio`

13. `getRaceControlMessages`

14. `getRaceCalendar`

15. `getCircuitInfo`

16. `getSeasonList`

17. `getQualifyingResults`

18. `getDriverInformation`

19. `getConstructorInformation`

20. `clearCache`