World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 97 tools.
Remote MCP server for intervals.icu run data and analysis
Elige la app de IA que usas y copia la configuración.
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Intervals MCP (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Intervals MCP para Claude en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "intervals": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "INTERVALS_API_KEY", "-e", "ORS_API_KEY", "-e", "HOME_START", "-e", "MCP_AUTH_TOKEN", "ghcr.io/ljcl/intervals-mcp:2.19.0" ], "env": { "INTERVALS_API_KEY": "your-value", "ORS_API_KEY": "your-value", "HOME_START": "your-value", "MCP_AUTH_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En INTERVALS_API_KEY, ORS_API_KEY, HOME_START, MCP_AUTH_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Intervals MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
SettingsDeveloperEdit Config
{
"mcpServers": {
"intervals": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"INTERVALS_API_KEY",
"-e",
"ORS_API_KEY",
"-e",
"HOME_START",
"-e",
"MCP_AUTH_TOKEN",
"ghcr.io/ljcl/intervals-mcp:2.19.0"
],
"env": {
"INTERVALS_API_KEY": "your-value",
"ORS_API_KEY": "your-value",
"HOME_START": "your-value",
"MCP_AUTH_TOKEN": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Intervals MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Intervals MCP o muestra una herramienta de Intervals MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
INTERVALS_ATHLETE_ID Athlete id: 0 (default, the API key's own athlete) or e.g. i12345TZ IANA time zone for local dates, e.g. Australia/Sydney; unset or UTC follows the athlete's intervals.icu time zone (Etc/UTC pins UTC)OSM_EXTRACT_URL URL of an .osm.pbf (e.g. a BBBike city or Geofabrik region) for the local OpenStreetMap index that counts road crossings in route suggestions; needs HOME_STARTPORT Server port, 1-65535 (default 3000)DATA_DIR Directory for stored routes (stitch-route, amend-route); the image uses /data, a volume in docker-compose.yml. Default ./dataROUTE_RETENTION_DAYS Days a stored route not read or changed is kept, 1-3650 (default 30)PUBLIC_URL Public URL, used only to warn when /mcp is exposed without MCP_AUTH_TOKENLas descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Intervals MCP
Intervals MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Intervals MCP
B · Otros en Otros que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Intervals MCP (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Intervals MCP para Claude Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user intervals --env INTERVALS_API_KEY=your-value --env ORS_API_KEY=your-value --env HOME_START=your-value --env MCP_AUTH_TOKEN=your-value -- docker run -i --rm -e INTERVALS_API_KEY -e ORS_API_KEY -e HOME_START -e MCP_AUTH_TOKEN ghcr.io/ljcl/intervals-mcp:2.19.0 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En INTERVALS_API_KEY, ORS_API_KEY, HOME_START, MCP_AUTH_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Intervals MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user intervals --env INTERVALS_API_KEY=your-value --env ORS_API_KEY=your-value --env HOME_START=your-value --env MCP_AUTH_TOKEN=your-value -- docker run -i --rm -e INTERVALS_API_KEY -e ORS_API_KEY -e HOME_START -e MCP_AUTH_TOKEN ghcr.io/ljcl/intervals-mcp:2.19.0Cambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver Intervals MCP en la lista como conectado
Usa Intervals MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Intervals MCP o muestra una herramienta de Intervals MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
INTERVALS_ATHLETE_ID Athlete id: 0 (default, the API key's own athlete) or e.g. i12345TZ IANA time zone for local dates, e.g. Australia/Sydney; unset or UTC follows the athlete's intervals.icu time zone (Etc/UTC pins UTC)OSM_EXTRACT_URL URL of an .osm.pbf (e.g. a BBBike city or Geofabrik region) for the local OpenStreetMap index that counts road crossings in route suggestions; needs HOME_STARTPORT Server port, 1-65535 (default 3000)DATA_DIR Directory for stored routes (stitch-route, amend-route); the image uses /data, a volume in docker-compose.yml. Default ./dataROUTE_RETENTION_DAYS Days a stored route not read or changed is kept, 1-3650 (default 30)PUBLIC_URL Public URL, used only to warn when /mcp is exposed without MCP_AUTH_TOKENLas descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Intervals MCP (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Intervals MCP para Cursor en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "intervals": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "INTERVALS_API_KEY", "-e", "ORS_API_KEY", "-e", "HOME_START", "-e", "MCP_AUTH_TOKEN", "ghcr.io/ljcl/intervals-mcp:2.19.0" ], "env": { "INTERVALS_API_KEY": "your-value", "ORS_API_KEY": "your-value", "HOME_START": "your-value", "MCP_AUTH_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En INTERVALS_API_KEY, ORS_API_KEY, HOME_START, MCP_AUTH_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Intervals MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
En la configuración de Intervals MCP, INTERVALS_API_KEY, ORS_API_KEY, HOME_START, MCP_AUTH_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Intervals MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Intervals MCP o muestra una herramienta de Intervals MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
INTERVALS_ATHLETE_ID Athlete id: 0 (default, the API key's own athlete) or e.g. i12345TZ IANA time zone for local dates, e.g. Australia/Sydney; unset or UTC follows the athlete's intervals.icu time zone (Etc/UTC pins UTC)OSM_EXTRACT_URL URL of an .osm.pbf (e.g. a BBBike city or Geofabrik region) for the local OpenStreetMap index that counts road crossings in route suggestions; needs HOME_STARTPORT Server port, 1-65535 (default 3000)DATA_DIR Directory for stored routes (stitch-route, amend-route); the image uses /data, a volume in docker-compose.yml. Default ./dataROUTE_RETENTION_DAYS Days a stored route not read or changed is kept, 1-3650 (default 30)PUBLIC_URL Public URL, used only to warn when /mcp is exposed without MCP_AUTH_TOKENLas descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Intervals MCP (créala en el sitio del autor) · Instala Docker en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Intervals MCP para VS Code en este equipo, en este orden: 1) Comprueba Docker con docker --version. Si falta, dime que lo instale desde https://www.docker.com/products/docker-desktop/; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "intervals": { "type": "stdio", "command": "docker", "args": [ "run", "-i", "--rm", "-e", "INTERVALS_API_KEY", "-e", "ORS_API_KEY", "-e", "HOME_START", "-e", "MCP_AUTH_TOKEN", "ghcr.io/ljcl/intervals-mcp:2.19.0" ], "env": { "INTERVALS_API_KEY": "your-value", "ORS_API_KEY": "your-value", "HOME_START": "your-value", "MCP_AUTH_TOKEN": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En INTERVALS_API_KEY, ORS_API_KEY, HOME_START, MCP_AUTH_TOKEN deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Intervals MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
docker --versionMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Instala Docker Desktop: en Mac abre Docker.dmg y arrastra el icono a Aplicaciones (elige Apple silicon o Intel según tu Mac) · en Windows haz doble clic en Docker Desktop Installer.exe · luego abre la app Docker Desktop y déjala abierta. No necesitas ningún comando curl
Abrir la página de descarga de Docker ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: docker --version
Se instala una vez y sirve para todo lo que usa Docker
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
En la configuración de Intervals MCP, INTERVALS_API_KEY, ORS_API_KEY, HOME_START, MCP_AUTH_TOKEN está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Intervals MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Intervals MCP o muestra una herramienta de Intervals MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
INTERVALS_ATHLETE_ID Athlete id: 0 (default, the API key's own athlete) or e.g. i12345TZ IANA time zone for local dates, e.g. Australia/Sydney; unset or UTC follows the athlete's intervals.icu time zone (Etc/UTC pins UTC)OSM_EXTRACT_URL URL of an .osm.pbf (e.g. a BBBike city or Geofabrik region) for the local OpenStreetMap index that counts road crossings in route suggestions; needs HOME_STARTPORT Server port, 1-65535 (default 3000)DATA_DIR Directory for stored routes (stitch-route, amend-route); the image uses /data, a volume in docker-compose.yml. Default ./dataROUTE_RETENTION_DAYS Days a stored route not read or changed is kept, 1-3650 (default 30)PUBLIC_URL Public URL, used only to warn when /mcp is exposed without MCP_AUTH_TOKENLas descripciones siguen en el inglés original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user intervals --env INTERVALS_API_KEY=your-value --env ORS_API_KEY=your-value --env HOME_START=your-value --env MCP_AUTH_TOKEN=your-value -- docker run -i --rm -e INTERVALS_API_KEY -e ORS_API_KEY -e HOME_START -e MCP_AUTH_TOKEN ghcr.io/ljcl/intervals-mcp:2.19.0Claude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"intervals": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"INTERVALS_API_KEY",
"-e",
"ORS_API_KEY",
"-e",
"HOME_START",
"-e",
"MCP_AUTH_TOKEN",
"ghcr.io/ljcl/intervals-mcp:2.19.0"
],
"env": {
"INTERVALS_API_KEY": "your-value",
"ORS_API_KEY": "your-value",
"HOME_START": "your-value",
"MCP_AUTH_TOKEN": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"intervals": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"INTERVALS_API_KEY",
"-e",
"ORS_API_KEY",
"-e",
"HOME_START",
"-e",
"MCP_AUTH_TOKEN",
"ghcr.io/ljcl/intervals-mcp:2.19.0"
],
"env": {
"INTERVALS_API_KEY": "your-value",
"ORS_API_KEY": "your-value",
"HOME_START": "your-value",
"MCP_AUTH_TOKEN": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"intervals": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"INTERVALS_API_KEY",
"-e",
"ORS_API_KEY",
"-e",
"HOME_START",
"-e",
"MCP_AUTH_TOKEN",
"ghcr.io/ljcl/intervals-mcp:2.19.0"
],
"env": {
"INTERVALS_API_KEY": "your-value",
"ORS_API_KEY": "your-value",
"HOME_START": "your-value",
"MCP_AUTH_TOKEN": "your-value"
}
}
}
}INTERVALS_API_KEY secreto obligatorio envINTERVALS_ATHLETE_ID envTZ envORS_API_KEY secreto obligatorio envHOME_START secreto obligatorio envOSM_EXTRACT_URL envMCP_AUTH_TOKEN secreto obligatorio envPORT envDATA_DIR envROUTE_RETENTION_DAYS envPUBLIC_URL envLas descripciones siguen en el inglés original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
oci: ghcr.io/ljcl/intervals-mcp:2.19.0Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 15 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub ljcl, dueña del repo
Último cambio de código: anteayer
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
No revisado: solo se pueden revisar paquetes npm y PyPI con versión
Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: INTERVALS_API_KEY, ORS_API_KEY, HOME_START, MCP_AUTH_TOKEN
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez anteayer, y la última versión (2.19.0) llegó al registro hace 4 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Docker en tu computadora.
En la misma categoría: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 97 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
A single-user remote MCP server for intervals.icu run data and analysis, with interactive MCP Apps.
All text tools and every MCP App talk to intervals.icu directly and are verified against a real account; see docs/tools.md for the full catalog. Configuration is checked at startup: a bad variable stops the server with a message naming it, and the key's presence is reported on /health.
History. This project began as strava-mcp and was migrated to intervals.icu as its data source; nothing in the server talks to Strava today.
cp .env.example .env
Edit .env with your values:
INTERVALS_API_KEY=your_api_key
All variables are listed in docs/operations.md.
Local development (needs Bun):
bun install
bun run dev
Docker:
docker compose up -d
Prefer the prebuilt image? Pull ghcr.io/ljcl/intervals-mcp:latest, the newest release (also on the MCP registry as io.github.ljcl/intervals-mcp), and point your compose image: at it instead of building; you still supply your own API key. :edge tracks unreleased main. Published images carry SBOM/provenance attestations you can verify; see operations.md.
GET /health reports liveness without spending an intervals.icu API request; with MCP_AUTH_TOKEN it also reports config and rate-limit state. Response shapes and monitoring guidance: operations.md.
Point any client at http://localhost:3000/mcp. Repo layout, task runner, tests, coverage gates, and Storybook workflow: docs/development.md. Agent conventions live in AGENTS.md.
Most AI tools (Claude Desktop, Claude Code, etc.) need an HTTPS URL to reach your MCP server. Since the server runs on your local network, you'll need a tunnel to expose it.
Tailscale Funnel exposes a local port to the internet over HTTPS with no configuration:
tailscale funnel --bg 3000
Set PUBLIC_URL in your .env to the resulting URL.
cloudflared tunnel --url http://localhost:3000
A tunnel makes /mcp reachable by anyone who discovers the URL, so they can use the intervals.icu API key configured on the server (the key itself is never exposed to them). Set MCP_AUTH_TOKEN to a long random secret (openssl rand -hex 32) and every /mcp request requires Authorization: Bearer ; each client snippet below shows where the header goes. The secret also gates the detailed half of /health. Full details: operations.md.
Set it in .env alongside your API key; docker-compose.yml forwards it automatically.
AI Tool (Claude Desktop, Claude Code, etc.)
│ HTTPS HTTPS Tunnel (Tailscale / Cloudflare) │ HTTP (localhost:3000) intervals-mcp Server (Docker / Bun) │ HTTPS intervals.icu API
The server works with any MCP client that supports the Streamable HTTP transport. In every snippet below, replace https://your-public-url with your tunnel URL (or http://localhost:3000 for local development), and include the Authorization header only if you set MCP_AUTH_TOKEN.
Add to your Claude configuration (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": { "intervals-mcp": { "type": "url", "url": "https://your-public-url/mcp", "headers": { "Authorization": "Bearer your-mcp-auth-token" } } } }
Restart Claude Desktop to load the new configuration.
claude mcp add --transport http intervals-mcp https://your-public-url/mcp \
--header "Authorization: Bearer your-mcp-auth-token"
Add to .cursor/mcp.json in your project (or ~/.cursor/mcp.json for all projects):
{
"mcpServers": { "intervals-mcp": { "url": "https://your-public-url/mcp", "headers": { "Authorization": "Bearer your-mcp-auth-token" } } } }
Add to .vscode/mcp.json in your workspace (or run MCP: Add Server from the command palette):
{
"servers": { "intervals-mcp": { "type": "http", "url": "https://your-public-url/mcp", "headers": { "Authorization": "Bearer your-mcp-auth-token" } } } }
Any client that speaks Streamable HTTP can connect to the /mcp endpoint directly. The endpoint serves the 2026-07-28 revision: clients send stateless requests carrying the io.modelcontextprotocol/* envelope keys and the Mcp-Method/Mcp-Name headers (server/discover advertises capabilities). A 2025-era client (one that opens with initialize) is served statelessly too, because claude.ai loads MCP Apps that way, but it gets no write tool: update-activity, update-wellness and update-gear need a 2026-07-28 client. POST JSON-RPC messages with an Accept: application/json, text/event-stream header. Protocol details: docs/architecture.md.
The full tool catalog, prompts, permission behaviour, and example requests live in docs/tools.md. All text tools and every MCP App's data handler talk to intervals.icu directly.
| Doc | Contents |
|---|---|
| docs/tools.md | Full tool catalog, prompts, permission behaviour, example requests |
| docs/operations.md | Environment variables, the API key, health endpoint, rate limits, endpoint security |
| docs/architecture.md | Server architecture: transport, HTTP layer, cache, error taxonomy, analysis math |
| docs/api-notes.md | Calling the intervals.icu API: auth, endpoints, verified behaviour from Phases 1 and 2 |
| docs/mcp-apps.md | MCP App packages: shared shell, mobile, theming, per-app details |
| docs/development.md | Monorepo mechanics: Turborepo, coverage gates, Storybook gates, Docker build |
| docs/releasing.md | Release automation: Conventional Commit PR titles, release-please, publishing |
| docs/project.md | Issue tracking and project board |
| docs/Intervals_MCP_Server.md | Capability reference to upload as project knowledge in a Claude project using this server |
PRs are squash-merged and the PR title becomes the commit on `main`, so write it as a Conventional Commit (fix: patch, feat: minor, any ! or BREAKING CHANGE: footer major; chore:/docs:/refactor:/ci: release nothing). A CI check rejects non-conforming titles; see docs/releasing.md.
Server exits at startup: The message names the variable to fix, one line per bad variable. See operations.md.
AI tool can't reach the server — MCP requires an HTTPS URL. Use a tunnel (Tailscale Funnel or Cloudflare Tunnel) to expose your local server. See Connecting to AI Tools.
API key errors: Check /health first: api_key_configured tells you whether the server has a key set at all. If api_key_configured is true but calls still fail, the key may be wrong or revoked; generate a new one at intervals.icu, Settings, Developer Settings, and update INTERVALS_API_KEY. See operations.md.
Today's run is missing, or dates are a day off: Check time_zone and time_zone_source on /health. With TZ unset (or UTC), the server uses your intervals.icu time zone; set TZ to choose one. See operations.md.
"Cloudflare … answered with a challenge": Cloudflare, in front of intervals.icu, stopped the request before it reached intervals.icu, so this is not an API key problem. Wait a few minutes and retry. See operations.md.
Client can't connect (401 or unsupported protocol version): Each refused /mcp request writes one mcp_rejected line to the server log with its status, JSON-RPC code and, when the client sent it, its name. A 401 means the bearer token is missing or wrong. Code -32022 means the client's envelope names an MCP revision the server does not serve. See operations.md.
Is the server up and reachable? curl https://your-public-url/health. It answers without touching the intervals.icu API, so it works even when your rate limit is exhausted.
Client re-prompts for read tools after I granted them — A release likely renamed a tool or changed its input schema; grants are stored per tool identity, so that drops the grant. Releases say so in the changelog. Otherwise persistence lives in the client — check both connector-level and per-tool settings. See docs/tools.md.
MIT