Un serveur MCP de réservation de voyages
pour les agents IA.

Adrasis exploite un serveur Model Context Protocol (MCP) qui s’appuie sur sa Distribution Partner API. Les agents IA recherchent et réservent hébergements, transferts, excursions, vols charter et forfaits selon les règles de l’API, dans le cadre d’un compte partenaire.

Un serveur MCP distant adossé à l’API partenaire.

Le serveur encapsule le contrat REST de la Distribution Partner API d’Adrasis. Votre agent appelle des outils plutôt que des points de terminaison, et chaque outil se comporte comme l’appel REST correspondant.

Pour comparer des serveurs MCP dédiés au voyage, trois questions font l’essentiel de la différence : d’où vient l’offre, qui contrôle ce qu’un agent a le droit de faire, et si une réservation est réelle. Ici, l’offre est celle qu’une agence ou un tour-opérateur gère dans Adrasis Console, et c’est lui qui en contrôle l’accès via un compte partenaire et ses autorisations. Un appel book réussi crée la réservation et réduit les quantités en vente, comme une réservation REST.

Rien n’est réinterprété pour les agents. Les outils utilisent les mêmes schémas de requête et de réponse, la même logique métier, la même tarification et les mêmes règles d’utilisation que le contrat REST : un agent et une intégration classique travaillent avec un seul jeu de règles.

# Serveur MCP distant, transport Streamable HTTP
https://ari.console.adrasis.com/mcp

# Jeton d’accès OAuth 2.0
Authorization: Bearer <access token>

Un agent peut aussi se passer de MCP et appeler directement le contrat REST. Le contrat complet, lisible par machine, est publié dans la référence de l’API (en anglais).

MCP et opérateur IA d’Adrasis.

Le serveur MCP s’adresse à un agent IA qui réserve dans l’offre d’une autre entreprise via un compte partenaire. L’opérateur IA, lui, travaille au sein de votre propre organisation.

Deux parties interviennent. Le détenteur de l’offre est une agence ou un tour-opérateur qui gère ses contrats et ses prix dans Adrasis Console. Le partenaire conçoit l’agent : une OTA (agence de voyages en ligne), une application de voyage, une autre agence ou un partenaire technologique. Le détenteur crée un compte partenaire, ouvre les établissements que le partenaire peut réserver et délivre les identifiants ; l’agent travaille uniquement dans ce compte.

L’opérateur IA travaille sur vos propres données

Votre équipe envoie ses instructions via le panneau de discussion de la Console, par e-mail ou par WhatsApp. L’opérateur IA d’Adrasis prépare le travail sur votre catalogue, vos prix, vos contrats et votre distribution. Les SMS servent aux alertes et aux validations d’opérations. Les demandes en lecture seule reçoivent une réponse immédiate. Toute modification de données fait l’objet d’un aperçu et ne s’exécute qu’après votre confirmation, et l’opérateur IA ne lit jamais les données d’une autre organisation. Découvrez le fonctionnement de l’opérateur IA.

Quels outils un agent peut-il appeler ?

Chaque outil correspond à une opération REST et en utilise les schémas de requête et de réponse. Les outils sont regroupés par produit, et chacun nécessite l’une des deux autorisations.

Hébergement

Données de référence, contenu des établissements, recherche de disponibilité et cycle de vie complet des réservations pour les hôtels, les locations de vacances, les villas et les appartements. « Établissements ouverts » est la liste des établissements ouverts à un profil partenaire.

Outil Fonction Autorisation
search_property_availability Trouver l’offre au prix le plus bas pour chaque établissement, jusqu’à 200 établissements. distribution:read
search_place_availability Trouver les offres aux prix les plus bas dans une destination, jusqu’à 100 établissements par page. distribution:read
list_countries Lister les pays avec leurs ID, codes ISO et noms localisés. distribution:read
list_place_types Lister les huit types de lieux et, pour chaque pays, ceux sur lesquels une recherche est possible. distribution:read
list_places Trouver des destinations par pays, type, lieu parent ou nom. distribution:read
list_properties Lister le contenu des établissements de la liste « Établissements ouverts », sans les prix. distribution:read
get_property Lire le contenu complet d’un établissement. distribution:read
prebook Recalculer le prix de l’offre choisie ; renvoyer un jeton de préréservation, le statut de concordance et les conditions d’annulation. distribution:booking
book Confirmer la réservation, avec une clé d’idempotence pour des relances sans risque. distribution:booking
get_booking Lire une réservation, ou interroger régulièrement une réservation en attente. distribution:booking
list_bookings Rapprocher les réservations par votre propre référence, une période ou les modifications récentes. distribution:booking
cancellation_quote Prévisualiser les frais d’annulation sans rien modifier. distribution:booking
cancel Annuler la réservation et appliquer les frais correspondants. Peut être relancé sans risque. distribution:booking

La recherche d’offres sur un seul établissement n’est disponible qu’en REST. Elle renvoie la meilleure offre pour l’ensemble du groupe, puis toutes les options de chambre et de plan tarifaire disponibles pour chaque chambre demandée, de la moins chère à la plus chère, avec des quantités sélectionnables.

Transfert, circuit et vol

Chaque produit suit le même enchaînement que l’hébergement : recherche, préréservation et réservation. Les vols sont des vols charters, et un aller-retour se recherche en deux trajets distincts.

Outil Fonction Autorisation
search_transfers Trouver des offres de transfert entre deux zones pour une date de prestation et un groupe. distribution:booking
prebook_transfer Recalculer le prix d’une offre de transfert et renvoyer un jeton de préréservation avec ses conditions d’annulation. distribution:booking
book_transfer Confirmer le transfert, avec une clé d’idempotence. distribution:booking
search_tours Trouver des offres pour un circuit à une date de départ, pour un groupe. distribution:booking
prebook_tour Recalculer le prix d’une offre de circuit et renvoyer un jeton de préréservation avec ses conditions d’annulation. distribution:booking
book_tour Confirmer le circuit, avec une clé d’idempotence. distribution:booking
search_flights Trouver des offres de vols charters pour une date de départ et une composition de passagers. distribution:booking
prebook_flight Recalculer le prix d’une offre de vol et renvoyer un jeton de préréservation avec ses conditions d’annulation. distribution:booking
book_flight Confirmer la réservation du vol, avec une clé d’idempotence. distribution:booking

Forfaits

Un forfait regroupe de 2 à 8 prestations déjà sélectionnées par l’agent, couvrant au moins deux types de produits, vendues à un prix global unique. Soit toutes les prestations sont confirmées, soit aucune ne l’est. Une fois réservé, un forfait se consulte et s’annule avec get_booking, cancellation_quote et cancel, et les deux derniers peuvent aussi cibler séparément certaines prestations du forfait.

Outil Fonction Autorisation
search_packages Combiner de 2 à 8 prestations sélectionnées en une seule offre à un prix global unique. distribution:booking
prebook_package Revérifier chaque prestation et renvoyer le statut de concordance, les informations de conformité et un jeton de préréservation. distribution:booking
book_package Réserver tout le forfait en une fois : toutes les prestations sont confirmées, ou aucune. distribution:booking

Regroupement en voyage

Un voyage regroupe des réservations déjà confirmées en un seul itinéraire. Chaque réservation conserve son propre total, ses conditions d’annulation et son cycle de vie : un voyage n’est donc jamais un forfait à prix global.

Outil Fonction Autorisation
create_trip Regrouper des réservations confirmées en un seul voyage. Leurs prix restent distincts. distribution:booking
get_trip Consulter un voyage avec ses réservations et ses totaux par devise. distribution:booking
add_trip_member Ajouter une réservation existante à un voyage. distribution:booking
remove_trip_member Retirer une réservation d’un voyage sans modifier la réservation. distribution:booking
cancel_trip Annuler toutes les réservations du voyage et indiquer le résultat de chacune. distribution:booking

Comment un agent réserve-t-il un séjour ?

Le parcours documenté compte huit étapes, de l’identification de la destination à l’annulation. L’agent s’arrête deux fois pour obtenir la confirmation de son utilisateur : avant de réserver et avant d’annuler.

  1. Identifier la destination. Appelez list_countries, list_place_types et list_places pour trouver le pays, les types de lieux qui peuvent y être recherchés et la destination elle-même, par exemple Antalya.
  2. Construire le contexte sans les prix. Lisez le contenu des « Établissements ouverts » avec list_properties et get_property. Aucun des deux ne prend de point de vente en paramètre.
  3. Rechercher. Appelez search_property_availability pour des établissements connus, ou search_place_availability pour parcourir les établissements d’une destination. Indiquez le mode de répartition : strict conserve chaque chambre exactement telle que demandée, flexible permet de répartir le groupe sur neuf chambres au maximum. Conservez côté serveur le selection_token de l’offre choisie.
  4. Préréserver. Transmettez ce jeton à prebook, qui recalcule le prix de l’offre. Lisez le statut de concordance et les conditions d’annulation, puis faites confirmer les deux par l’utilisateur.
  5. Réserver. Appelez book avec les informations sur les clients et les coordonnées du contact ainsi qu’une idempotency_key unique. Une nouvelle tentative avec la même clé et un corps de requête inchangé, dans les 24 heures suivant la première requête, renvoie la réservation d’origine au lieu d’en créer une seconde.
  6. Interroger. Si la réservation revient en attente, par exemple sur un plan tarifaire qui attend l’acceptation de l’établissement, appelez get_booking jusqu’à ce que le statut soit définitif.
  7. Rapprocher. Rapprochez les réservations de l’ensemble du compte avec list_bookings, à l’aide de votre propre agency_reference ou d’une période définie, sur les dates ou sur les dates de modification. Les résultats ne contiennent aucune donnée personnelle des clients.
  8. Annuler sur demande. Affichez les frais avec cancellation_quote et n’appelez cancel que lorsque l’utilisateur confirme.

La préréservation ne bloque aucune chambre. La disponibilité est vérifiée de nouveau à l’exécution de book : la dernière chambre peut donc être réservée par quelqu’un d’autre entre les deux étapes, et l’agent relance alors une recherche. Un jeton de préréservation est valable 30 minutes et ne permet qu’une seule réservation.

Aucun paiement ne transite par le serveur. Le partenaire reste le vendeur responsable de la transaction (merchant of record). Les plans tarifaires qui exigent une étape de paiement ailleurs, comme un débit de carte ou un échéancier d’acomptes, ne peuvent pas être réservés de cette façon.

Comment l’agent s’authentifie-t-il ?

Avec les mêmes identifiants client OAuth 2.0 qu’une intégration REST. Une session d’agent s’authentifie exactement comme un client REST.

Le partenaire échange son identifiant client et son secret client contre un jeton d’accès sur https://ari.console.adrasis.com/api/v1/oauth/token. Le jeton est valable une heure et aucun jeton d’actualisation n’est émis : à son expiration, l’agent en demande un nouveau avec les mêmes identifiants. La documentation recommande de conserver un seul jeton et de le renouveler peu avant son expiration, plutôt que d’en demander un à chaque appel.

Le jeton est transmis dans l’en-tête Authorization de la session MCP. Le compte partenaire et les autorisations du jeton sont transmis tels quels à chaque appel d’outil, et l’appel d’un outil dont le jeton ne possède pas l’autorisation requise est refusé.

Deux autorisations

Autorisation Ce qu’elle couvre
distribution:read Données de référence, contenu des établissements et recherche de disponibilité pour l’hébergement.
distribution:booking Préréservation, réservation, consultation des réservations, estimation des frais d’annulation et annulation pour l’hébergement, ainsi que tous les outils de transfert, de circuit, de vol, de forfait et de voyage, y compris leurs outils de recherche.

N’accordez que ce dont l’agent a besoin. Un agent qui répond à des questions de disponibilité mais ne doit jamais réserver reçoit uniquement distribution:read. Les nouveaux identifiants reçoivent les deux autorisations par défaut : choisissez donc le minimum lorsque vous en créez pour un agent. Un jeton peut aussi être demandé avec moins d’autorisations que ses identifiants n’en possèdent. Les codes d’erreur et les autres détails figurent dans le guide d’authentification (en anglais).

Que peut voir l’agent ?

Uniquement ce que le détenteur de l’offre lui a ouvert. Pour l’hébergement, il s’agit de la liste des établissements ouverts d’un profil partenaire.

Les outils liés aux établissements renvoient uniquement les établissements d’hébergement publiés et explicitement ouverts dans les « Établissements ouverts » du profil sélectionné. Chaque compte partenaire est créé avec un profil par défaut, qui contient un instantané des établissements publiés à la création du compte. Un établissement publié ensuite reste fermé au partenaire jusqu’à ce que le propriétaire de l’offre l’ouvre. Fermer un établissement le retire des résultats de ce profil, sans le supprimer ni le fermer dans les autres profils.

Lorsqu’un même partenaire a besoin de catalogues distincts pour différents publics, le propriétaire ajoute d’autres profils au compte. Les outils liés à un profil acceptent un paramètre facultatif profile_public_id : omettez-le pour utiliser le profil par défaut, ou envoyez-le pour sélectionner un autre profil du même compte. La réponse à chaque appel réussi indique le profil réellement utilisé. Les identifiants appartiennent au compte, si bien qu’un même jeu d’identifiants fonctionne avec tous les profils.

Voir un établissement ne signifie pas pouvoir le vendre

list_properties et get_property montrent ce qui est ouvert au profil et n’acceptent aucun point de vente en paramètre. Les prix, les chambres en vente et les règles de destination n’élargissent ni ne restreignent leurs résultats. Seuls les outils de disponibilité, qui reçoivent le point de vente du voyageur sous forme de code pays, déterminent si un séjour peut être vendu à un voyageur.

list_bookings fait exception à la sélection de profil. Il lit les réservations de tout le compte, et profile_public_id y sert uniquement à limiter le rapport aux réservations créées par un profil donné.

Comment un partenaire obtient-il l’accès ?

Le propriétaire de l’offre configure le partenaire dans Adrasis Console. Développement, certification et trafic réel passent tous par le même hôte.

  1. Compte partenaire

    Le propriétaire ouvre Connexions, puis Canaux de vente, Partenaires API et Comptes partenaires, et crée un compte pour cette relation. Un profil par défaut est créé en même temps que le compte.

  2. Établissements ouverts

    Le propriétaire ouvre les établissements voulus dans chaque profil : un par un, en groupe ou à partir de filtres par pays et par lieu.

  3. Identifiants

    Un jeu d’identifiants nommé séparément pour chaque environnement, avec les autorisations minimales. Le secret ne s’affiche qu’une seule fois : enregistrez-le aussitôt dans un gestionnaire de secrets.

  4. Certification et mise en production

    Les identifiants de la phase pilote donnent accès à un catalogue de démonstration. Lors du passage à l’offre réelle, l’ID client, l’hôte et le flux d’intégration restent les mêmes.

Le catalogue de démonstration contient des prix et des disponibilités générés pour les tests, et les réservations de test n’affectent pas les chambres réellement en vente et ne donnent lieu à aucune facturation. Annulez tout de même chaque réservation de test : une réservation de test non annulée bloque des chambres de démonstration, et des tests répétés peuvent finir par renvoyer SOLD_OUT.

Aucun plafond fixe de requêtes n’est publié. Les limites de requêtes sont convenues pour chaque connexion : confirmez-les auprès de votre contact Adrasis avant d’augmenter le trafic. Ajouter des identifiants ou des profils n’augmente pas le quota. Le propriétaire peut renouveler, désactiver ou révoquer un jeu d’identifiants depuis l’onglet Accès API du compte ; un jeu d’identifiants désactivé ou révoqué cesse de fonctionner, tout comme les jetons émis à partir de celui-ci.

Ce qui relève du propriétaire est décrit dans Partenaires API et identifiants (en anglais). Si votre équipe développe un agent IA de voyage et souhaite devenir partenaire, contactez-nous.

Prêt à connecter un agent ?

Demandez un accès à la Console pour configurer votre offre propre, ou parlez-nous de l’agent que vous développez et des accès dont il a besoin.