Utilisez l'API de transport avec votre assistant IA

BusMaps MCP connecte Claude, ChatGPT, Codex, Gemini, Cursor et d'autres clients IA aux itinéraires, isochrones, départs, arrêts, véhicules, géocodage et informations GTFS. Connectez-vous à BusMaps avec votre e-mail et mot de passe ou avec Google. Les requêtes utilisent la couverture et les limites API actuelles de votre compte.

Compatible avec

Qu'est-ce que MCP ?

Le Model Context Protocol connecte les assistants IA à des outils et données externes. BusMaps fournit des outils de transport appelables, des guides API, des schémas de réponse et des exemples. Votre assistant peut lire le contrat d'interface et envoyer des requêtes en votre nom. Les requêtes MCP et REST directes utilisent le même accès et le même quota de compte.

Ce que votre agent peut faire

get_account

Affiche votre nom d'affichage, votre forfait API, la couverture autorisée et les sources de données. Ne renvoie pas votre clé API.

get_gtfs_feeds_catalog

Liste les données GTFS sources, les rapports de validation, les licences, les empreintes et les liens de téléchargement versionnés. Les jeux de données enrichis et les exports personnalisés font l’objet de demandes distinctes.

plan_transit_route

Planifie un trajet entre deux points en bus, métro, train ou tramway. Renvoie des options avec les étapes, arrêts de montée et de descente, horaires, correspondances et une polyligne encodée. Les horaires prévus sont inclus lorsque des données en temps réel existent. Le filtre barrierMode peut imposer des arrêts, des courses ou les deux explicitement accessibles en fauteuil roulant.

calculate_transit_isochrone

Calcule les zones accessibles depuis un point en transports en commun et à pied, ou les zones d'où ce point peut être atteint avant une heure d'arrivée. Renvoie des contours cumulatifs de temps de trajet, leur surface et le nombre d'arrêts accessibles. La géométrie utilise par défaut des anneaux encodés avec une précision de six décimales ; GeoJSON est disponible sur demande.

calculate_transit_isochrone_from_shape

Calcule la même accessibilité depuis une ligne ou une limite de surface dans une zone de 1 000 mètres sur 1 000 mètres. Prend en charge les seuils de durée, l'heure de départ ou d'arrivée, les limites de correspondances et les options de marche.

get_departures

Renvoie les départs planifiés et en temps réel aux arrêts proches d'un point ou à un arrêt précis. Le retard correspond à realtimeDepartureTime moins scheduledDepartureTime. Le filtre barrierMode applique les mêmes règles strictes d'accessibilité en fauteuil roulant que le calcul d'itinéraires.

find_nearby_stops

Renvoie les arrêts dans un rayon autour d'un point, avec identifiant, nom, coordonnées et lignes desservies.

get_route_timetable

Renvoie les horaires complets d'une ligne : directions, arrêts ordonnés et grille des courses par arrêt. Une vue d'ensemble des horaires pour une ligne.

get_service_alerts

Renvoie les perturbations en cours pour une ligne ou un opérateur précis. C'est une alternative légère au chargement des horaires complets lorsque seules les alertes sont nécessaires.

get_trip_schedule

Renvoie une course sous forme de liste ordonnée d'arrêts, avec heures d'arrivée et de départ et règles GTFS de montée et de descente.

get_vehicle_positions_in_area

Renvoie un instantané des positions actuelles des véhicules dans un rectangle géographique, avec identifiant de ligne, coordonnées, direction et horodatage. positionType distingue une mesure GPS d'une position estimée. Les résultats peuvent être limités à une ligne ou une course.

plan_car_route

Renvoie des itinéraires routiers depuis le service mondial OSRM, avec distance, durée, géométrie, alternatives et instructions de navigation facultatives.

car_distance_matrix

Renvoie des matrices de temps de trajet et de distances en voiture entre plusieurs points de départ et d'arrivée.

plan_pedestrian_route

Renvoie un itinéraire à pied avec des instructions détaillées OSRM pour rejoindre l'arrêt et la destination.

pedestrian_distance_matrix

Renvoie une matrice des durées et distances à pied entre plusieurs points. L'agent peut ainsi comparer les arrêts les plus proches à pied.

nominatim_search

Géocode un texte libre en adresse postale complète et structurée au format JSON.

nominatim_reverse

Transforme des coordonnées en adresse postale complète et structurée au format JSON.

Outils pour les réponses vocales

Ces six outils appellent les points d'accès en direct sous /compact/v1/* . Leurs réponses JSON plus petites, adaptées aux réponses vocales, réduisent le nombre de tokens des appels d'outils pour les modèles de langage tout en conservant les informations de transport nécessaires. Consultez la documentation des points d'accès pour modèles vocaux.

compact_plan_transit_route

Renvoie jusqu'à deux itinéraires compacts de structure différente, avec modes, arrêts, horaires planifiés et temps réel, accessibilité et références aux alertes.

compact_get_departures

Renvoie des départs compacts, planifiés et en temps réel, près d'un point ou à un arrêt précisément identifié.

compact_find_nearby_stops

Renvoie les arrêts proches, triés par distance calculée, avec des identifiants pour les requêtes suivantes.

compact_get_route_timetable

Renvoie les horaires complets d'une ligne dans un format compact par colonnes.

compact_plan_pedestrian_route

Renvoie un résumé du trajet à pied et les principales instructions pour rejoindre l'arrêt puis la destination.

compact_nominatim_search

Renvoie des résultats compacts et structurés de recherche de lieux à partir d'une adresse.

Conçu pour les agents IA

À la connexion, l'agent lit les instructions, ressources et schémas, puis construit lui-même les requêtes adaptées.

Instructions à la connexion

Le serveur renvoie des instructions pour guider les premiers pas de l'agent.

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

start-here présente une vue d'ensemble et les particularités, comme l'ordre des coordonnées. recipes contient des séquences complètes d'outils pour les vues courantes. compact-api explique le modèle de réponse compact, les outils correspondants, les vérifications en direct et l'utilisation ultérieure de l'API REST en production.

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

Chaque outil de transport fournit son schéma de réponse JSON et un exemple réel abrégé, afin que l'agent connaisse le format avant l'appel.

build_transit_app, explain_api, explain_compact_api

build_transit_app transforme une demande en plan de développement d'application. explain_api décrit l'API complète. explain_compact_api lit le contrat compact et guide des appels représentatifs en direct.

Généré à partir du contrat d'interface

Les outils de transport sont générés à partir du même contrat API que la documentation, avec des schémas de réponse et des exemples correspondants.

Aucune documentation à copier

L'agent lit lui-même les outils, ressources et prompts. Personne n'a besoin de copier la documentation dans le chat.

Connecter votre compte BusMaps

URL du serveur : https://mcp.busmaps.com/mcp

Claude / Claude Desktop

  1. Ouvrez les paramètres des connecteurs dans Claude ou Claude Desktop.
  2. Ajoutez un connecteur personnalisé avec l’adresse du serveur https://mcp.busmaps.com/mcp.
  3. Connectez le serveur et identifiez-vous sur BusMaps avec votre e-mail et votre mot de passe ou avec Google.

La disponibilité dépend de votre forfait et des autorisations de l'espace de travail.

ChatGPT

Ouvrez ChatGPT et choisissez + > Add custom MCP server. Saisissez l'URL du serveur, sélectionnez OAuth et connectez-vous à BusMaps.

Gemini

Dans Gemini sur le Web, ouvrez Settings > Connected Apps > Custom apps, ajoutez l'URL du serveur et suivez la connexion à BusMaps. Les conditions de disponibilité de Google s'appliquent.

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

Dans Claude Code, ouvrez /mcp et authentifiez le serveur BusMaps dans votre navigateur.

Gemini CLI

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

Après l'ajout du serveur, utilisez /mcp auth busmaps-transit dans Gemini CLI pour terminer la connexion dans le navigateur.

Codex (~/.codex/config.toml)

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

Authentifiez-vous ensuite dans Codex. Pour Codex CLI, exécutez codex mcp login busmaps-transit et connectez-vous à BusMaps dans le navigateur.

Utilisez l'URL du serveur dans votre client IA. Aucun conteneur Docker ni installation MCP locale n'est nécessaire.

  1. Ajoutez l'URL du serveur dans les paramètres de connexion MCP distante de votre client.
  2. Connectez-vous à BusMaps avec votre e-mail et mot de passe ou avec Google. Un compte confirmé avec un accès API actif est requis.
  3. Vérifiez l'application et l'accès demandé, puis choisissez Allow access pour revenir à votre client.

Votre client peut demander des données de transport et lire votre nom d'affichage, votre forfait API, la couverture autorisée et les sources de données. Il ne peut pas modifier votre mot de passe, votre facturation ou votre abonnement. Votre mot de passe et votre clé API ne sont pas transmis au client IA.

Conditions d'utilisation de l'API · Politique de confidentialité · Sous-traitants et prestataires (en anglais)

Posez vos questions en langage naturel

Connectez un agent au serveur et essayez ces demandes. L'agent choisit lui-même l'outil adapté.

  • "Planifie un trajet de Camden Town au London Eye"plan_transit_route renvoie les liaisons disponibles avec les arrêts de montée, les horaires et la géométrie du trajet.
  • "Où puis-je aller depuis Trafalgar Square en 30 minutes en transports en commun et à pied ?"calculate_transit_isochrone renvoie les polygones cumulatifs de durée et le nombre d'arrêts accessibles pour l'heure de départ choisie.
  • "Trouve les arrêts dans un rayon de 300 m autour de 51.5074,-0.1278"find_nearby_stops renvoie les identifiants, noms, coordonnées et lignes des arrêts dans le rayon indiqué.
  • "Quel est le prochain départ à London Waterloo et y a-t-il du retard ?"get_departures renvoie les horaires planifiés et les prévisions en temps réel. Le retard correspond à realtimeDepartureTime moins scheduledDepartureTime.
  • "Affiche les véhicules actuels dans la zone 51.45,-0.25,51.55,-0.05"get_vehicle_positions_in_area renvoie un instantané des positions dans le rectangle géographique, avec identifiant de ligne, coordonnées, direction et horodatage.
  • "Y a-t-il des perturbations sur cette ligne ?"get_service_alerts renvoie les perturbations en cours sans charger tous les horaires de la ligne.
  • "Comment calculer les retards en temps réel à partir des données de départ ?"L'agent répond à partir de la description de l'outil et du schéma. Personne n'a besoin de copier la documentation dans le chat.
  • "Explique les points d'accès pour modèles vocaux et vérifie-les avec une requête d'itinéraire en direct"L'agent lit busmaps://compact-api, vérifie les schémas et exemples pertinents puis appelle les outils compact_* via l'explorateur public.

Prêt pour votre projet ?

Consultez votre accès API actuel dans votre profil. Les comptes confirmés éligibles peuvent tester les exemples London Demo ; un accès payant ou convenu individuellement utilise la couverture et les limites qui lui sont attribuées.

Demander des données / un accès API

MCP et REST partagent le quota de votre compte. Connecter un client IA ne démarre pas d'abonnement payant. Demandez une couverture ou une capacité supplémentaire lorsque votre projet en a besoin.