# F1verse

> F1verse is an open-source MCP server for games and play. Formula 1 race data MCP server with stints, tyre wear and a publish-safety check. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Website:** https://jinsim.github.io/f1verse/
- **Repository:** https://github.com/jinsim/f1verse
- **MCP Registry name:** io.github.jinsim/f1verse
- **Categories:** games and play, analytics and data
- **Listing updated:** 2026-11-14

## About

What sets f1verse apart is that it judges the data as well as serving it. A quality report gives a result a lifecycle state of provisional, settled, final or corrected, so a pipeline knows whether a race can be published yet, and a cross-check recomputes values from a second independent feed.

The MCP server has 26 read-only tools covering race stories and briefs, turning points, pace changes, retirement risk, tyre wear, deleted laps, battles, standings, driver careers and circuit history. Coverage runs from full live timing in 2023, lap-by-lap racing back to 1996, pit stops to 2011 and results to 1950, and each answer states which era it came from.

The Python library and MCP server use only the standard library, so `uvx --from f1verse f1verse-mcp` needs no install step or API key. An agent skill and prompt templates for race briefs and strategy reviews are also included.

## Features

- **Race story:** One call returns results, lead changes, laps led, timeline, stints and pace.
- **Publish-safety report:** Marks data provisional, settled, final or corrected.
- **Tyre and stints:** Measures tyre degradation and undercut outcomes.
- **Deleted laps:** Lists lap times deleted by race control.
- **Title projections:** Simulates remaining rounds for championship odds.
- **Historical depth:** Results back to 1950 with era-specific limits stated.
- **Zero dependencies:** Runs on the Python standard library alone.

## Good for

- Draft a race summary with checked numbers
- Find out who led and for how many laps
- Check whether results are final before posting
- Review pit-stop strategy and tyre wear

## Install

### Claude Code (Terminal)

```sh
claude mcp add f1verse -- uvx f1verse
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "f1verse": {
      "command": "uvx",
      "args": [
        "f1verse"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "f1verse": {
      "command": "uvx",
      "args": [
        "f1verse"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "f1verse": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "f1verse"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "f1verse": {
      "command": "uvx",
      "args": [
        "f1verse"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "f1verse": {
      "command": "uvx",
      "args": [
        "f1verse"
      ]
    }
  }
}
```

## Tools

- `f1_source_status`: Check data source status
- `f1_race_events`: Race event timeline
- `f1_turning_points`: Ranked turning points
- `f1_pace_changes`: Pace changes
- `f1_retirement_risk`: Retirement risk
- `f1_race_story`: Whole-race story as JSON
- `f1_race_brief`: Race brief
- `f1_session_results`: Session results
- `f1_weekend_sessions`: Weekend sessions
- `f1_season_status`: Season status
- `f1_standings`: Standings
- `f1_driver_career`: Driver career
- `f1_data_quality`: Data quality report
- `f1_tyre_wear`: Tyre wear
- `f1_deleted_laps`: Deleted laps
- `f1_running_order`: Running order
- `f1_battles`: On-track battles
- `f1_archive_race`: Archive race data
- `f1_closest_titles`: Closest title fights
- `f1_season_shape`: Season shape
- `f1_highlights`: Highlights
- `f1_title_race`: Title race
- `f1_circuit_profile`: Circuit profile
- `f1_circuit_survey`: Circuit survey
- `f1_circuit_directory`: Circuit directory
- `f1_circuit_history`: Circuit history

## FAQ

### Is an API key needed?

No. The site says it needs no API key, client object or configuration.

### How far back does data go?

Results, qualifying and standings to 1950, with fuller coverage from 1996 and live timing from 2023.

### How many tools are there?

26, listed on the project's site.

### How do I start it?

Add a client entry that runs `uvx --from f1verse f1verse-mcp`.

### Is F1verse free?

Yes. F1verse is open source, so you can use and self-host it for free.

### How do I add F1verse to Claude Code?

Run this command in your terminal: claude mcp add f1verse -- uvx f1verse

### What are the best alternatives to F1verse?

The closest alternatives to F1verse are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Tapetide - Indian Stock Market MCP, World Monitor and CompanyData.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/f1verse
