Servidor MCP para OpenStreetMap, tiempo, aire y ríos

Conecta un asistente de IA a la API y pregunta con palabras normales: qué tiempo hará mañana donde voy a rodar, dónde puedo rellenar agua en esta ruta, qué ríos cerca de Colonia están subiendo. El asistente elige la herramienta, la API responde, y cada llamada cuenta para tu plan igual que la petición que hace.

Conectar

El servidor está en https://geo.runningcat.dev/mcp y habla Streamable HTTP. Usa la misma clave que la API.

Claude Code

claude mcp add --transport http running-cat-geo https://geo.runningcat.dev/mcp \
  --header "Authorization: Bearer YOUR_KEY"

Cursor

En .cursor/mcp.json dentro de tu proyecto, o en ~/.cursor/mcp.json para todos los proyectos:

{
  "mcpServers": {
    "running-cat-geo": {
      "url": "https://geo.runningcat.dev/mcp",
      "headers": { "Authorization": "Bearer ${env:RUNNING_CAT_KEY}" }
    }
  }
}

Otros clientes

Cualquier cliente que se conecte a servidores MCP remotos por HTTP funciona con la dirección y una cabecera Authorization: Bearer YOUR_KEY o x-api-key. Un cliente que solo admite una dirección puede usar https://geo.runningcat.dev/mcp?key=YOUR_KEY; mantén esa dirección en privado, porque lleva la clave.

Herramientas

point_report
Todo sobre un lugar: nombre y áreas, zona horaria, altitud, tiempo, calidad del aire, estaciones de aire cercanas y estaciones de aforo de ríos
area_report
Tiempo, calidad del aire, altitudes, estaciones de aire y estaciones de aforo de ríos sobre un recuadro, en una cuadrícula
plan_route
Una ruta en bici, gravel, a pie o en coche a través de puntos intermedios, con su perfil, el tiempo a las horas de llegada, zonas horarias y lo que atraviesa
plan_loop
Una ruta circular de la longitud que pidas desde un punto de salida, con desnivel y tipo de firme, y si quieres el mismo informe
route_report
El mismo informe para una ruta que ya tienes en GeoJSON, incluido el tipo de firme a lo largo de ella
stops_along_route
Agua, comida, tiendas, aseos, tiendas de bicicletas y gasolina a lo largo de una ruta, con kilómetros y los tramos largos sin ninguno
overpass_query
Una consulta Overpass QL sobre datos de OpenStreetMap (qué se admite)
weather_forecast
Previsión horaria de hasta 14 días
air_quality
Previsión de calidad del aire y polen, y lo que miden ahora las estaciones cercanas
river_gauges
Niveles de ríos cerca de un punto o en un recuadro, o el historial de una estación de aforo
elevation
Altitudes de hasta 1000 puntos
where_is
País, región, localidad y zona horaria de un punto
outdoor_layers
Senderos señalizados, áreas protegidas, pistas de esquí, remontes y límites en un recuadro

Las respuestas largas, como dos semanas de tiempo horario, se recortan para que quepan en el contexto del asistente, y la respuesta indica qué se recortó. Para los datos completos, llama directamente a la API.

Cosas que puedes preguntar

  • "Planifica una ruta de gravel de Múnich a Salzburgo para el sábado a 20 km/h. ¿Dónde empieza a llover y dónde puedo rellenar agua?"
  • "¿Está el Rin en Colonia más alto que ayer, y cuánto?"
  • "¿Está el aire de Praga mejor o peor de lo que decía la previsión? Compara las estaciones con la previsión."
  • "Busca panaderías dentro del límite de Viena que abran antes de las 7."

Cómo cuentan las llamadas

El servidor no añade ningún cargo propio. Una llamada a una herramienta cuenta como las peticiones a la API que hace: point_report y air_quality una cada una, un informe de área o de ruta una por parte, una ruta una por cada 100 km empezados (50 km en MTB). Los límites de los planes están en la sección de precios; el plan gratuito da 500 peticiones al día.

El plan gratuito incluye 500 solicitudes al día, también para apps comerciales. Crea una cuenta con Google o con tu correo y genera tus claves al instante.