Utilice la API de transporte con su asistente de IA

BusMaps MCP conecta Claude, ChatGPT, Codex, Gemini, Cursor y otros clientes de IA con rutas, isócronas, salidas, paradas, vehículos, geocodificación e información GTFS. Inicie sesión en BusMaps con correo y contraseña o con Google. Las solicitudes utilizan la cobertura y los límites actuales de la API de su cuenta.

Compatible con

¿Qué es MCP?

El Model Context Protocol conecta asistentes de IA con herramientas y datos externos. BusMaps ofrece herramientas de transporte invocables, guías de la API, esquemas de respuesta y ejemplos. Su asistente puede leer el contrato de la interfaz y enviar solicitudes en su nombre. Las solicitudes MCP y REST directas utilizan el mismo acceso y la misma cuota de la cuenta.

Qué puede hacer su agente

get_account

Muestra su nombre visible, plan de API, cobertura permitida y fuentes de datos. No devuelve su clave de API.

get_gtfs_feeds_catalog

Enumera registros GTFS de origen, informes de validación, licencias, hashes y enlaces de descarga con versión. Los conjuntos de datos mejorados y las exportaciones personalizadas se solicitan por separado.

plan_transit_route

Planifica un trayecto entre dos puntos en autobús, metro, tren o tranvía. Devuelve opciones con etapas, paradas de subida y bajada, horarios, transbordos y una polilínea codificada. Incluye previsiones cuando hay datos en tiempo real. El filtro barrierMode puede exigir paradas, expediciones o ambas expresamente accesibles en silla de ruedas.

calculate_transit_isochrone

Calcula las zonas accesibles desde un punto en transporte público y a pie, o las zonas desde las que se puede llegar a ese punto antes de una hora de llegada. Devuelve contornos acumulados de tiempo de viaje, su superficie y el número de paradas accesibles. La geometría utiliza por defecto anillos codificados con seis decimales de precisión; GeoJSON está disponible bajo petición.

calculate_transit_isochrone_from_shape

Calcula la misma accesibilidad desde una línea o el límite de una superficie dentro de un área de 1000 por 1000 metros. Admite umbrales de duración, hora de salida o llegada, límites de transbordos y opciones a pie.

get_departures

Devuelve salidas programadas y en tiempo real en paradas cercanas a un punto o en una parada concreta. El retraso es realtimeDepartureTime menos scheduledDepartureTime. El filtro barrierMode aplica las mismas reglas estrictas de accesibilidad en silla de ruedas que el cálculo de rutas.

find_nearby_stops

Devuelve las paradas dentro de un radio alrededor de un punto, con identificador, nombre, coordenadas y líneas que las sirven.

get_route_timetable

Devuelve los horarios completos de una línea: sus sentidos, paradas ordenadas y horarios en una tabla de expediciones por paradas. La ficha de una línea.

get_service_alerts

Devuelve incidencias actuales de una línea o un operador concreto. Es una alternativa ligera a cargar los horarios completos cuando solo se necesitan alertas.

get_trip_schedule

Devuelve una expedición, es decir, un recorrido concreto de un vehículo, como lista ordenada de paradas, con horas de llegada y salida y reglas GTFS de embarque.

get_vehicle_positions_in_area

Devuelve una instantánea de las posiciones actuales de los vehículos en un rectángulo geográfico, con identificador de línea, coordenadas, sentido y marca de tiempo. positionType distingue una posición GPS de una estimada. Los resultados se pueden limitar a una línea o expedición.

plan_car_route

Devuelve rutas en coche del servicio mundial OSRM, con distancia, duración, geometría, alternativas e instrucciones de navegación opcionales.

car_distance_matrix

Devuelve matrices de tiempos de viaje y distancias en coche entre varios puntos de origen y destino.

plan_pedestrian_route

Devuelve una ruta a pie con instrucciones detalladas de OSRM para llegar a la parada y al destino.

pedestrian_distance_matrix

Devuelve una matriz de tiempos y distancias a pie entre varios puntos. El agente puede así comparar las paradas más cercanas a pie.

nominatim_search

Geocodifica texto libre en una dirección postal completa y estructurada en formato JSON.

nominatim_reverse

Convierte coordenadas en una dirección postal completa y estructurada en formato JSON.

Herramientas para respuestas de voz

Estas seis herramientas llaman a los endpoints en directo /compact/v1/* . Sus respuestas JSON más pequeñas y centradas en la respuesta reducen los tokens de las llamadas a herramientas para modelos de voz, conservando los datos de transporte necesarios para las respuestas habladas. Consulte la documentación de endpoints para modelos de voz.

compact_plan_transit_route

Devuelve hasta dos trayectos compactos con estructuras distintas, incluyendo servicios, paradas, valores programados y en tiempo real, accesibilidad y referencias a alertas.

compact_get_departures

Devuelve salidas compactas, programadas y en tiempo real, cerca de un punto o en una parada identificada con precisión.

compact_find_nearby_stops

Devuelve paradas cercanas ordenadas por distancia calculada, con identificadores para realizar solicitudes posteriores precisas.

compact_get_route_timetable

Devuelve los horarios completos de una línea en un formato compacto por columnas.

compact_plan_pedestrian_route

Devuelve un resumen del trayecto a pie y las indicaciones principales para llegar a la parada y después al destino.

compact_nominatim_search

Devuelve resultados compactos y estructurados de búsqueda de lugares a partir de una dirección.

Diseñado para agentes de IA

Al conectarse, el agente lee las instrucciones, los recursos y los esquemas y construye las solicitudes adecuadas.

Instrucciones al conectarse

El servidor devuelve instrucciones para orientar los primeros pasos del agente.

busmaps://start-here, busmaps://recipes, busmaps://compact-api

start-here ofrece una visión general y explica particularidades como el orden de las coordenadas. recipes contiene secuencias completas de herramientas para vistas habituales. compact-api explica el modelo de respuesta compacto, las herramientas correspondientes, las comprobaciones en directo y el uso posterior de la API REST en producción.

busmaps://schema/<tool>, busmaps://example/<tool>

Cada herramienta de transporte ofrece su esquema de respuesta JSON y un ejemplo real abreviado para que el agente conozca el formato antes de llamarla.

build_transit_app, explain_api, explain_compact_api

build_transit_app convierte una petición en un plan de desarrollo de aplicación. explain_api describe la API completa. explain_compact_api lee el contrato compacto y guía llamadas representativas en directo.

Generado a partir del contrato de la interfaz

Las herramientas de transporte se generan a partir del mismo contrato de la API que la documentación, con esquemas de respuesta y ejemplos correspondientes.

Sin copiar documentación

El agente lee por sí mismo las herramientas, los recursos y los prompts. Nadie necesita copiar la documentación en el chat.

Conectar su cuenta de BusMaps

URL del servidor: https://mcp.busmaps.com/mcp

Claude / Claude Desktop

  1. Abre la configuración de conectores en Claude o Claude Desktop.
  2. Añade un conector personalizado con la URL del servidor https://mcp.busmaps.com/mcp.
  3. Conecta el servidor e inicia sesión en BusMaps con correo y contraseña o con Google.

La disponibilidad depende de su plan y de los permisos del espacio de trabajo.

ChatGPT

Abra ChatGPT y elija + > Add custom MCP server. Introduzca la URL del servidor, seleccione OAuth e inicie sesión en BusMaps.

Gemini

En Gemini para la web, abra Settings > Connected Apps > Custom apps, añada la URL del servidor y siga los pasos de inicio de sesión en BusMaps. Se aplican los requisitos de disponibilidad de Google.

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "busmaps-transit": {
      "type": "http",
      "url": "https://mcp.busmaps.com/mcp"
    }
  }
}

VS Code (.vscode/mcp.json)

{
  "servers": {
    "busmaps-transit": {
      "type": "http",
      "url": "https://mcp.busmaps.com/mcp"
    }
  }
}

Claude Code

claude mcp add --transport http busmaps-transit https://mcp.busmaps.com/mcp

En Claude Code, abra /mcp y autentique el servidor de BusMaps en el navegador.

Gemini CLI

gemini mcp add busmaps-transit https://mcp.busmaps.com/mcp --transport http

Después de añadir el servidor, utilice /mcp auth busmaps-transit en Gemini CLI para completar el inicio de sesión en el navegador.

Codex (~/.codex/config.toml)

[mcp_servers.busmaps-transit]
url = "https://mcp.busmaps.com/mcp"

Después, autentíquese en Codex. En Codex CLI, ejecute codex mcp login busmaps-transit e inicie sesión en BusMaps en el navegador.

Utilice la URL del servidor en su cliente de IA. No se necesita ningún contenedor Docker ni una instalación local de MCP.

  1. Añada la URL del servidor en los ajustes de conexión MCP remota de su cliente.
  2. Inicie sesión en BusMaps con correo y contraseña o con Google. Se necesita una cuenta confirmada con acceso activo a la API.
  3. Revise la aplicación y el acceso solicitado y elija Allow access para volver a su cliente.

Su cliente puede solicitar datos de transporte y consultar su nombre visible, plan de API, cobertura permitida y fuentes de datos. No puede cambiar su contraseña, facturación ni suscripción. Su contraseña y su clave de API no se envían al cliente de IA.

Condiciones de uso de la API · Política de privacidad · Subencargados y proveedores de servicios (en inglés)

Haga preguntas en lenguaje natural

Conecte un agente al servidor y pruebe estas peticiones. El agente elegirá la herramienta adecuada.

  • "Planifique un trayecto de Camden Town al London Eye"plan_transit_route devuelve las conexiones disponibles con las paradas de subida, los horarios y la geometría del trayecto.
  • "¿Adónde puedo llegar desde Trafalgar Square en 30 minutos en transporte público y a pie?"calculate_transit_isochrone devuelve los polígonos acumulados de duración y el número de paradas accesibles para la hora de salida elegida.
  • "Busque paradas en un radio de 300 m alrededor de 51.5074,-0.1278"find_nearby_stops devuelve los identificadores, nombres, coordenadas y líneas de las paradas dentro del radio indicado.
  • "¿Cuál es la próxima salida cerca de London Waterloo y tiene retraso?"get_departures devuelve horarios programados y previsiones en tiempo real. El retraso es realtimeDepartureTime menos scheduledDepartureTime.
  • "Muestre los vehículos actuales en el área 51.45,-0.25,51.55,-0.05"get_vehicle_positions_in_area devuelve una instantánea de las posiciones en el rectángulo geográfico, con identificador de línea, coordenadas, sentido y marca de tiempo.
  • "¿Hay incidencias en esta línea?"get_service_alerts devuelve las incidencias actuales sin cargar todos los horarios de la línea.
  • "¿Cómo se calculan los retrasos en tiempo real a partir de los datos de salidas?"El agente responde a partir de la descripción de la herramienta y del esquema. Nadie necesita copiar la documentación en el chat.
  • "Explique los endpoints para modelos de voz y compruébelos con una solicitud de ruta en directo"El agente lee busmaps://compact-api, comprueba los esquemas y ejemplos pertinentes y llama a las herramientas compact_* mediante el explorador público.

¿Todo listo para su proyecto?

Consulte su acceso actual a la API en su perfil. Las cuentas confirmadas que cumplan los requisitos pueden probar los ejemplos London Demo; el acceso de pago o acordado individualmente utiliza la cobertura y los límites asignados.

Solicitar datos / acceso a la API

MCP y REST comparten la cuota de su cuenta. Conectar un cliente de IA no inicia una suscripción de pago. Solicite cobertura o capacidad adicional cuando su proyecto lo necesite.