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.
¿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
Muestra su nombre visible, plan de API, cobertura permitida y fuentes de datos. No devuelve su clave de API.
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.
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.
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.
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.
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.
Devuelve las paradas dentro de un radio alrededor de un punto, con identificador, nombre, coordenadas y líneas que las sirven.
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.
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.
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.
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.
Devuelve rutas en coche del servicio mundial OSRM, con distancia, duración, geometría, alternativas e instrucciones de navegación opcionales.
Devuelve matrices de tiempos de viaje y distancias en coche entre varios puntos de origen y destino.
Devuelve una ruta a pie con instrucciones detalladas de OSRM para llegar a la parada y al destino.
Devuelve una matriz de tiempos y distancias a pie entre varios puntos. El agente puede así comparar las paradas más cercanas a pie.
Geocodifica texto libre en una dirección postal completa y estructurada en formato JSON.
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.
Devuelve hasta dos trayectos compactos con estructuras distintas, incluyendo servicios, paradas, valores programados y en tiempo real, accesibilidad y referencias a alertas.
Devuelve salidas compactas, programadas y en tiempo real, cerca de un punto o en una parada identificada con precisión.
Devuelve paradas cercanas ordenadas por distancia calculada, con identificadores para realizar solicitudes posteriores precisas.
Devuelve los horarios completos de una línea en un formato compacto por columnas.
Devuelve un resumen del trayecto a pie y las indicaciones principales para llegar a la parada y después al destino.
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.
El servidor devuelve instrucciones para orientar los primeros pasos del agente.
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.
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 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.
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.
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
- Abre la configuración de conectores en Claude o Claude Desktop.
- Añade un conector personalizado con la URL del servidor
https://mcp.busmaps.com/mcp. - 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.
- Añada la URL del servidor en los ajustes de conexión MCP remota de su cliente.
- Inicie sesión en BusMaps con correo y contraseña o con Google. Se necesita una cuenta confirmada con acceso activo a la API.
- 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 APIMCP 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.