# F1 Mcp Server

> Formula-1 MCP server using FastF1 & OpenF1 API

- **Type:** MCP server
- **Install:** `agentstack add mcp-darakhsh1999-f1-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Darakhsh1999](https://agentstack.voostack.com/s/darakhsh1999)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Darakhsh1999](https://github.com/Darakhsh1999)
- **Source:** https://github.com/Darakhsh1999/f1-mcp-server

## Install

```sh
agentstack add mcp-darakhsh1999-f1-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

#  🏁 Formula 1 MCP Server 🏎️

This project defines a MCP server for Formula 1 data, providing fans, analysts, and developers with easy access to a vast range of F1 statistics and information. Built with Python and powered by the Gradio framework, it offers a user-friendly web interface to explore historical and recent F1 data from the [FastF1](https://docs.fastf1.dev/) library and the official [OpenF1 API](https://openf1.org/).

## Video Demo (Claude Desktop)

[](https://www.loom.com/embed/4ef9cf2e691143db8e5d807a1aef9672?sid=6dabbf2e-71ba-406d-ad86-8b480a29e222)

## Architecture

Architectural overview of the MCP server and client. The MCP server is hosted using a `Gradio` back-end and can be either run locally or on a remote server.

### Gradio Key Features
The interface is organized into several `Gradio` tabs, each dedicated to a specific type of F1 data:

*   **Championship Standings:** View final driver and constructor championship standings for any season from 1950 to the present.
*   **Event Information:** Get detailed information for any Grand Prix, including schedules and circuit details.
*   **Season Calendar:** Display the complete race calendar for a given year.
*   **Track Visualizations:** Generate and view plots of the fastest race lap, visualizing speed, gear changes, and cornering G-forces.
*   **Session Results:** Fetch detailed results for any race session (Practice, Qualifying, or Race).
*   **Driver & Constructor Info:** Look up background information and statistics for drivers and teams.
*   **OpenF1 API Tools:** An advanced toolkit for developers to directly query the OpenF1 API, build custom requests, and view raw JSON responses.

### Tech Stack
*   **Backend:** Python
*   **Web Framework:** Gradio
*   **Data Sources:**
    *   `fastf1` Python library for historical data.
    *   `openf1` for live and recent data via their public API.
*   **Key Libraries:** `pandas`, `matplotlib`

## MCP Server
The MCP server is defined inside `app.py`.

## MCP Client
The MCP client and AI agent is defined inside `mcp_client.py` and allows interaction with the MCP server through server side events (SSE) transport.

## MCP configuration file
For MCP clients that support SSE transport (for Claude Desktop, see below), the following configuration can be used:

```json
{
  "mcpServers": {
    "gradio": {
      "url": "https://agents-mcp-hackathon-f1-mcp-server.hf.space/gradio_api/mcp/sse"
    }
  }
}
```

For Claude Desktop, the following configuration can instead be used, but make sure you have Node.js installed:

```json
{
  "mcpServers": {
    "gradio": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://agents-mcp-hackathon-f1-mcp-server.hf.space/gradio_api/mcp/sse",
        "--transport",
        "sse-only"
      ]
    }
  }
}
```

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Darakhsh1999](https://github.com/Darakhsh1999)
- **Source:** [Darakhsh1999/f1-mcp-server](https://github.com/Darakhsh1999/f1-mcp-server)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-darakhsh1999-f1-mcp-server
- Seller: https://agentstack.voostack.com/s/darakhsh1999
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.