Proporciona datos en tiempo real, históricos y noticias de la Fórmula 1 a través de 11 herramientas especializadas para clientes de IA.
También conocido como praneethravuri/pitstop, pitstop-f1
- Stars
- 1
- Herramientas
- 11
- Descargas, 30 días
- 65
- Última versión
- 0.5.0
- Último commit
- 14 nov 2026
- Licencia
- MIT
¿Qué es Pitstop MCP?
Proporciona datos en tiempo real, históricos y noticias de la Fórmula 1 a través de 11 herramientas especializadas para clientes de IA. Expone 11 herramientas, como get_session_data, get_telemetry_data, get_live_data.
Resumen generado a partir del README del proyecto
Acerca del MCP server de Pitstop
Pitstop permite analizar la telemetría de la Fórmula 1, los resultados de las carreras y las noticias directamente desde un cliente de IA. Este MCP server agrega datos de múltiples fuentes autorizadas como FastF1, OpenF1 y Wikidata para ofrecer 11 herramientas especializadas para entusiastas del automovilismo y desarrolladores. Cubre desde intervalos en vivo y paradas en pits en tiempo real hasta clasificaciones históricas de campeonatos que se remontan a 1950.
Los usuarios pueden desplegar este servidor mediante un endpoint HTTP alojado en Hugging Face o instalarlo localmente usando stdio a través de uvx. Es compatible con varios entornos, incluyendo Claude Desktop, Cursor, Windsurf y VS Code. Para quienes necesiten una configuración local completa, puede ejecutarse mediante Docker para incluir la base de datos interna SQLite. El servidor gestiona automáticamente tareas complejas como paginación, reintentos y límites de concurrencia para garantizar una recuperación de datos fiable.
Qué puedes hacer con él
- 1Analizar el rendimiento de los pilotosSolicita un análisis detallado del ritmo de un piloto, la degradación de los neumáticos y la consistencia de sus stints durante un Gran Premio específico.
- 2Monitorear datos de carreras en vivoSigue los intervalos de carrera en tiempo real, las paradas en pits y las actualizaciones de la radio del equipo durante una sesión en vivo.
- 3Recuperar telemetría históricaExamina la telemetría del coche vuelta a vuelta, incluyendo velocidad, aceleración y cambios de marcha para pilotos específicos.
- 4Consultar datos biográficosUtiliza consultas SPARQL para encontrar información biográfica específica o récords de carrera de pilotos de Fórmula 1.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar Pitstop MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar Pitstop MCP en Claude Code
$ claude mcp add --env 'PITSTOP_TRANSPORT=<PITSTOP_TRANSPORT>' pitstop -- uvx pitstop-f1Instalar Pitstop MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"pitstop": {
"command": "uvx",
"args": [
"pitstop-f1"
],
"env": {
"PITSTOP_TRANSPORT": "<PITSTOP_TRANSPORT>"
}
}
}
}Instalar Pitstop MCP en VS Code
.vscode/mcp.json
{
"servers": {
"pitstop": {
"type": "stdio",
"command": "uvx",
"args": [
"pitstop-f1"
],
"env": {
"PITSTOP_TRANSPORT": "<PITSTOP_TRANSPORT>"
}
}
}
}Instalar Pitstop MCP en VS Code CLI
$ code --add-mcp '{"name":"pitstop","type":"stdio","command":"uvx","args":["pitstop-f1"],"env":{"PITSTOP_TRANSPORT":"<PITSTOP_TRANSPORT>"}}'Instalar Pitstop MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"pitstop": {
"command": "uvx",
"args": [
"pitstop-f1"
],
"env": {
"PITSTOP_TRANSPORT": "<PITSTOP_TRANSPORT>"
}
}
}
}Instalar Pitstop MCP en Codex
$ codex mcp add pitstop --env 'PITSTOP_TRANSPORT=<PITSTOP_TRANSPORT>' -- uvx pitstop-f1Instalar Pitstop MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.pitstop] command = "uvx" args = ["pitstop-f1"] [mcp_servers.pitstop.env] PITSTOP_TRANSPORT = "<PITSTOP_TRANSPORT>"
Instalar Pitstop MCP en Gemini CLI
$ gemini mcp add -s user -e 'PITSTOP_TRANSPORT=<PITSTOP_TRANSPORT>' pitstop uvx -- pitstop-f1Instalar Pitstop MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"pitstop": {
"command": "uvx",
"args": [
"pitstop-f1"
],
"env": {
"PITSTOP_TRANSPORT": "<PITSTOP_TRANSPORT>"
}
}
}
}Herramientas de Pitstop MCP 11
Detectado desde el READMEget_session_dataget_telemetry_dataget_live_dataget_standingsget_scheduleget_reference_dataget_f1_newsget_resultsget_race_analysisquery_wikidataquery_f1_database
| get_session_data | — | |
| get_telemetry_data | — | |
| get_live_data | — | |
| get_standings | — | |
| get_schedule | — | |
| get_reference_data | — | |
| get_f1_news | — | |
| get_results | — | |
| get_race_analysis | — | |
| query_wikidata | — | |
| query_f1_database | — |
Configuración
PITSTOP_TRANSPORTObligatorioTransport mode; must be 'stdio' when run via an MCP client.
| Nombre | Descripción | Tipo |
|---|---|---|
| PITSTOP_TRANSPORT | Transport mode; must be 'stdio' when run via an MCP client. | Obligatorio |
Verificaciones automáticas
Ejecutado 12 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleAprobado
- Licencia de código abierto (OSI)Aprobado
- Commit o lanzamiento en el último añoAprobado
- El nombre del paquete no es similar a un paquete popularAprobado
- El endpoint remoto usa HTTPSNo verificado
- Las herramientas destructivas están etiquetadasAprobado
- Sin instrucciones ocultas para el modeloAprobado
- No hay avisos críticos en el paquete ni en sus dependenciasAprobado
README
Ver en GitHubPitstop — F1 MCP Server
An HTTP-first Model Context Protocol (MCP) server for Formula 1 data. Aggregates real-time, historical, and news data from multiple authoritative sources into 11 tools ready for any MCP client.
v0.5.0 | Author: Praneeth Ravuri
Install
Hosted endpoint (nothing to install)
A free public instance runs on Hugging Face Spaces:
https://praneeth1025-pitstop.hf.space/mcp
claude mcp add --transport http pitstop https://praneeth1025-pitstop.hf.space/mcp
Note: the Space sleeps after long inactivity — the first request after a quiet spell takes a cold start.
Local install
stdio, via uvx (no clone needed):
PITSTOP_TRANSPORT=stdio uvx pitstop-f1
claude mcp add pitstop -e PITSTOP_TRANSPORT=stdio -- uvx pitstop-f1
codex mcp add pitstop --env PITSTOP_TRANSPORT=stdio -- uvx pitstop-f1
gemini mcp add pitstop uvx pitstop-f1 --env PITSTOP_TRANSPORT=stdio
VS Code:
code --add-mcp '{"name":"pitstop","command":"uvx","args":["pitstop-f1"],"env":{"PITSTOP_TRANSPORT":"stdio"}}'
Claude Desktop (claude_desktop_config.json), Cursor (~/.cursor/mcp.json), and Windsurf (~/.codeium/windsurf/mcp_config.json) share the same JSON shape:
{
"mcpServers": {
"pitstop": {
"command": "uvx",
"args": ["pitstop-f1"],
"env": { "PITSTOP_TRANSPORT": "stdio" }
}
}
}
Docker (HTTP transport, runs the full server incl. the F1 database):
docker compose up
# → http://localhost:8000/mcp
Overview
Pitstop exposes F1 data as 11 MCP tools over HTTP (default) or stdio. It pulls from FastF1, Jolpica, OpenF1, Wikidata, RSS feeds, and its own seeded F1 database, handling pagination, retries, caching, and concurrency limits transparently.
Data Sources
| Source | Coverage | Type |
|---|---|---|
| FastF1 | 2018–present | Historical / timing / telemetry |
| Jolpica-F1 | 1950–present | Historical (Ergast-compatible) |
| OpenF1 | 2023–present | Real-time |
| Wikidata | All eras | SPARQL queries |
| RSS Feeds (20 sources) | Live | News |
| Pitstop F1 Database | 1950–present | Owned sqlite (seeded from F1DB, self-updated weekly from Jolpica) + per-lap times |
Database refresh: .github/workflows/db-update.yml runs weekly to pull new Jolpica results into the owned F1 database.
Tools
| Tool | Description | Key Parameters |
|---|---|---|
get_session_data |
Race/qualifying results, lap times, weather, driver details (2018–present) | year, gp, session, includes, page, page_size |
get_telemetry_data |
Lap-by-lap car telemetry (speed, throttle, brake, gears) (2018–present) | year, gp, session, drivers, lap_numbers, max_points, page, page_size |
get_live_data |
Live intervals, pit stops, team radio, stints, race control, weather, position, laps, overtakes (2023–present) | data_types, year, country, session_name, driver_number, compound, flag, category, page, page_size |
get_standings |
Driver and constructor championship standings (1950–present) | year, round, type, driver_name, team_name, page, page_size |
get_schedule |
Race calendar and session schedule | year, include_testing, round, event_name, only_remaining, page, page_size |
get_reference_data |
Circuits, drivers, constructors encyclopedia (1950–present) | reference_type, year, name, page, page_size |
get_f1_news |
F1 headlines from 20 RSS sources | source, limit, keywords, driver, team, circuit, year, date_from, date_to, page, page_size |
get_results |
Race/qualifying/sprint results, lap times, pit stops (1950–present) | year, round, result_type, driver, page |
get_race_analysis |
Pace, tire degradation, stint summaries, consistency (2018–present) | year, gp, session, drivers, analysis_type, page |
query_wikidata |
SPARQL queries to Wikidata for F1 biography, career records, history | sparql, page, page_size |
query_f1_database |
Read-only SQL over pitstop's owned F1 database (1950–present): results, standings, driver family trees, team lineage | sql, page, page_size |
Transport
HTTP (default)
uv sync
uv run pitstop
# → http://localhost:8000
MCP client config:
{
"mcpServers": {
"pitstop": {
"type": "http",
"url": "http://localhost:8000/mcp"
}
}
}
stdio (opt-in)
PITSTOP_TRANSPORT=stdio uv run pitstop
MCP client config:
{
"mcpServers": {
"pitstop": {
"command": "uv",
"args": ["run", "--directory", "/path/to/pitstop", "pitstop"],
"env": { "PITSTOP_TRANSPORT": "stdio" }
}
}
}
Health API
| Endpoint | Purpose |
|---|---|
GET /health |
Per-source status (FastF1, f1db, Jolpica, OpenF1, RSS) |
GET /live |
Liveness probe |
GET /ready |
Readiness probe |
Example /health response:
{
"version": "0.5.0",
"overall": "ok",
"sources": [
{ "name": "fastf1", "status": "ok", "latency_ms": 2, "detail": "cache writable" },
{ "name": "f1db", "status": "ok", "latency_ms": 1, "detail": "" },
{ "name": "jolpica", "status": "ok", "latency_ms": 134, "detail": "" },
{ "name": "openf1", "status": "ok", "latency_ms": 98, "detail": "" },
{ "name": "rss", "status": "ok", "latency_ms": 210, "detail": "" }
]
}
overall is "ok" / "degraded" / "down". HTTP 200 / 207 / 503.
Wikidata SPARQL
query_wikidata runs SPARQL queries against Wikidata for biographical and historical F1 facts not covered by race APIs.
Only SELECT and ASK queries are accepted (read-only). Always include LIMIT in your query.
Example — find F1 drivers with their birthdate:
SELECT ?driver ?driverLabel ?birthDate WHERE {
?driver wdt:P31 wd:Q5 ;
wdt:P641 wd:Q1968 ;
wdt:P569 ?birthDate .
SERVICE wikibase:label { bd:serviceParam wikibase:language "en" }
} ORDER BY DESC(?birthDate) LIMIT 10
Pagination
All list-returning tools accept page (1-based, default 1) and page_size (defaults vary per tool: 10–50). Responses include a pagination block:
{
"data": [...],
"pagination": {
"page": 1,
"page_size": 20,
"total_items": 47,
"total_pages": 3,
"has_next": true,
"has_prev": false
}
}
Configuration
| Variable | Default | Description |
|---|---|---|
PITSTOP_TRANSPORT |
http |
http or stdio |
PITSTOP_HOST |
0.0.0.0 |
Bind address (HTTP only) |
PITSTOP_PORT |
8000 |
Listen port (HTTP only) |
PITSTOP_ENV |
development |
development or production |
PITSTOP_LOG_LEVEL |
Depends on PITSTOP_ENV |
DEBUG if development, else INFO |
PITSTOP_LOG_FORMAT |
Depends on PITSTOP_ENV |
text if development, else json |
PITSTOP_ENABLE_CACHING |
true |
Enable HTTP response and FastF1 disk caching |
PITSTOP_CACHE_TTL_SECONDS |
300 |
HTTP response cache time-to-live (seconds) |
PITSTOP_RATE_LIMIT_ENABLED |
false |
Enable concurrent-call limiting |
PITSTOP_RATE_LIMIT_PER_HOUR |
3600 |
Max concurrent calls (derived from per-hour quota) |
FASTF1_CACHE |
cache |
FastF1 cache directory path |
Caching
Pitstop uses in-memory HTTP response caching (via Hishel) for GET requests with 200 responses. This keeps tool calls inside upstream rate limits:
- Jolpica: 4 req/s, 500/hr
- OpenF1: 3 req/s, 30/min
- Wikidata: Query complexity limits
- RSS: Per-feed redirects cached
FastF1 maintains its own disk cache in FASTF1_CACHE directory. Control caching via:
PITSTOP_ENABLE_CACHING=true(default)PITSTOP_CACHE_TTL_SECONDS=300(default)
Development
uv sync --dev
uv run pytest
uv run ruff check src/
Contributing
See CONTRIBUTING.md.
Credits & attribution
| Source | Description | License |
|---|---|---|
| F1DB | Database seeded from F1DB and subsequently modified & extended by pitstop | CC BY 4.0 |
| FastF1 | Python library for F1 timing, telemetry, and session data | MIT |
| Jolpica-F1 | Ergast-compatible F1 data API, 1950–present; also used to self-update the F1DB-seeded database weekly | — |
| OpenF1 | Free open-source API for real-time F1 data | MIT |
| Wikidata | Open knowledge graph with SPARQL query service | CC0 |
| Ergast Motor Racing API | Historical F1 data 1950–2024 (now served via Jolpica) | — |
| RSS Feeds (20 sources) | News headlines, credited collectively; see each feed's link field in get_f1_news results |
Respective publishers |
Not affiliated with Formula 1 or the FIA. Data provided by third-party sources under their respective terms.
Preguntas sobre Pitstop MCP
¿Cómo agrego Pitstop MCP a Claude Code?
Ejecuta claude mcp add --env 'PITSTOP_TRANSPORT=<PITSTOP_TRANSPORT>' pitstop -- uvx pitstop-f1 en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego Pitstop MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona Pitstop MCP?
Expone 11 herramientas, incluidas get_session_data, get_telemetry_data, get_live_data, get_standings, get_schedule.
¿Cómo puedo instalar Pitstop localmente?
Puedes instalarlo vía stdio usando uvx ejecutando PITSTOP_TRANSPORT=stdio uvx pitstop-f1.
¿Pitstop ofrece datos en tiempo real?
Sí, incluye intervalos en vivo, paradas en pits, radio de equipo y datos del control de carrera a través de la herramienta get_live_data.
¿Puedo ejecutar consultas SPARQL para la historia de la F1?
Sí, la herramienta query_wikidata te permite ejecutar consultas SPARQL de tipo SELECT y ASK (solo lectura) en Wikidata para obtener datos biográficos e históricos.