Ein MCP-Server für Reisebuchungen
durch KI-Agenten.

Adrasis betreibt einen Server für das Model Context Protocol (MCP) auf Basis seiner Distribution Partner API. KI-Agenten suchen und buchen Unterkünfte, Transfers, Touren, Charterflüge und Pakete nach den Regeln der API, innerhalb eines Partnerkontos.

Ein Remote-MCP-Server auf Basis der Partner API.

Der Server kapselt die REST-Spezifikation der Adrasis Distribution Partner API. Ihr Agent ruft Tools statt Endpunkte auf, und jedes Tool verhält sich wie der REST-Aufruf dahinter.

Beim Vergleich von MCP-Servern für Reisen kommt es vor allem auf drei Fragen an: woher das Angebot stammt, wer festlegt, was ein Agent darf, und ob tatsächlich eine Buchung entsteht. Hier stammt das Angebot von einem Reisebüro oder Reiseveranstalter, der es in der Adrasis Console verwaltet und den Zugriff über ein Partnerkonto und dessen Berechtigungen steuert. Ein erfolgreicher book-Aufruf legt die Buchung an und verringert die Zahl der Zimmer im Verkauf, wie eine REST-Buchung.

Für Agenten wird nichts umgedeutet. Tools nutzen dieselben Request- und Response-Schemas, dieselbe Geschäftslogik, dieselbe Preisbildung und dieselben Nutzungsregeln wie die REST-Spezifikation, sodass ein Agent und eine klassische Integration nach denselben Regeln arbeiten.

# Remote-MCP-Server, Streamable HTTP
https://ari.console.adrasis.com/mcp

# OAuth-2.0-Zugriffstoken
Authorization: Bearer <Zugriffstoken>

Ein Agent kann MCP auch umgehen und die REST-API direkt aufrufen. Die vollständige maschinenlesbare Spezifikation steht in der API-Referenz (auf Englisch).

MCP und KI-Operator von Adrasis.

Der MCP-Server ist für einen KI-Agenten gedacht, der über ein Partnerkonto aus dem Angebot eines anderen Unternehmens bucht. Der KI-Operator erledigt die Arbeit in Ihrer eigenen Organisation.

Beteiligt sind zwei Seiten. Der Inhaber des Angebots ist ein Reisebüro oder Reiseveranstalter, der seine Verträge und Preise in der Adrasis Console führt. Der Partner entwickelt den Agenten. Das kann eine OTA (Online-Reisebüro), eine Reise-App, ein anderes Reisebüro oder ein Technologiepartner sein. Der Inhaber legt ein Partnerkonto an, gibt die Unterkünfte frei, die der Partner buchen darf, und stellt Zugangsdaten aus; der Agent arbeitet nur innerhalb dieses Kontos.

Der KI-Operator arbeitet mit Ihren eigenen Daten

Ihr Team schickt Anweisungen über den Chat in der Console, per E-Mail oder WhatsApp. Der KI-Operator bereitet Arbeiten an Ihrem eigenen Katalog, Ihren Preisen, Verträgen und Ihrem Vertrieb vor. SMS dient für Benachrichtigungen und die Freigabe von Vorgängen. Anfragen, die nur Daten lesen, werden sofort beantwortet. Alles, was Daten ändert, erscheint als Vorschau und wird erst nach Ihrer Bestätigung ausgeführt; Daten anderer Organisationen liest der KI-Operator nie. So funktioniert der KI-Operator.

Welche Tools kann ein Agent aufrufen?

Jedes Tool entspricht genau einer REST-Operation und nutzt deren Request- und Response-Schemas. Die Tools sind nach Produkt gruppiert, und jedes erfordert eine von zwei Berechtigungen.

Unterkünfte

Referenzdaten, Inhalte der Unterkünfte, Verfügbarkeitssuche und der vollständige Buchungsablauf für Hotels, Ferienunterkünfte, Villen und Apartments. „Freigegebene Unterkünfte“ ist die Liste der Unterkünfte, die für ein Partnerprofil freigegeben sind.

Tool Funktion Berechtigung
search_property_availability Findet das günstigste Angebot für jede von bis zu 200 Unterkünften. distribution:read
search_place_availability Findet die günstigsten Angebote an einem Reiseziel, bis zu 100 Unterkünfte pro Seite. distribution:read
list_countries Listet Länder mit IDs, ISO-Codes und lokalisierten Namen. distribution:read
list_place_types Listet die acht Ortstypen auf und zeigt, welche davon je Land für die Suche verfügbar sind. distribution:read
list_places Findet Reiseziele nach Land, Typ, übergeordnetem Ort oder Namen. distribution:read
list_properties Listet Inhalte der Unterkünfte aus der Liste „Freigegebene Unterkünfte“, ohne Preise. distribution:read
get_property Liest den vollständigen Inhalt einer Unterkunft. distribution:read
prebook Berechnet den Preis des gewählten Angebots neu; liefert ein Prebook-Token, den Übereinstimmungsstatus und die Stornierungsbedingungen. distribution:booking
book Bestätigt die Buchung, mit einem Idempotenzschlüssel für sichere Wiederholungen. distribution:booking
get_booking Liest eine Buchung oder fragt eine ausstehende ab. distribution:booking
list_bookings Gleicht Buchungen nach Ihrer eigenen Buchungsnummer, einem Zeitraum oder letzten Änderungen ab. distribution:booking
cancellation_quote Stornierungsgebühr vorab anzeigen, ohne etwas zu ändern. distribution:booking
cancel Buchung stornieren und die Gebühr berechnen. Kann gefahrlos wiederholt werden. distribution:booking

Die Angebotssuche für eine einzelne Unterkunft gibt es nur über REST. Sie liefert das beste Angebot für die gesamte Reisegruppe und danach alle verfügbaren Kombinationen aus Zimmer und Preisplan für jedes angefragte Zimmer, aufsteigend nach Preis und mit wählbarer Zimmeranzahl.

Transfer, Tour und Flug

Jedes Produkt folgt demselben Ablauf aus Suche, Prebook und Buchung wie Unterkünfte. Flüge sind Charterflüge, Hin- und Rückflug werden als zwei getrennte Strecken gesucht.

Tool Funktion Berechtigung
search_transfers Transferangebote zwischen zwei Zonen für ein Leistungsdatum und eine Reisegruppe finden. distribution:booking
prebook_transfer Preis eines Transferangebots neu ermitteln und ein Prebook-Token mit den Stornierungsbedingungen zurückgeben. distribution:booking
book_transfer Transfer mit einem Idempotenzschlüssel bestätigen. distribution:booking
search_tours Angebote für eine Tour zu einem Abfahrtstermin für eine Reisegruppe finden. distribution:booking
prebook_tour Preis eines Tourangebots neu ermitteln und ein Prebook-Token mit den Stornierungsbedingungen zurückgeben. distribution:booking
book_tour Tour mit einem Idempotenzschlüssel bestätigen. distribution:booking
search_flights Charterflugangebote für ein Abflugdatum und eine bestimmte Passagierzusammensetzung finden. distribution:booking
prebook_flight Preis eines Flugangebots neu ermitteln und ein Prebook-Token mit den Stornierungsbedingungen zurückgeben. distribution:booking
book_flight Flugbuchung mit einem Idempotenzschlüssel bestätigen. distribution:booking

Pakete

Ein Paket bündelt 2 bis 8 bereits vom Agenten ausgewählte Leistungen aus mindestens zwei Produktarten zu einem Inklusivpreis. Entweder werden alle Leistungen bestätigt oder keine. Nach der Buchung wird ein Paket mit get_booking, cancellation_quote und cancel abgerufen und storniert; die letzten beiden lassen sich auch auf einzelne Leistungen darin anwenden.

Tool Funktion Berechtigung
search_packages 2 bis 8 ausgewählte Leistungen zu einem Angebot mit einem Inklusivpreis kombinieren. distribution:booking
prebook_package Jede Leistung erneut prüfen und Übereinstimmungsstatus, Pflichtinformationen und ein Prebook-Token zurückgeben. distribution:booking
book_package Das gesamte Paket in einem Schritt buchen: Alle Leistungen werden bestätigt oder keine. distribution:booking

Gruppierung nach Reisen

Eine Reise fasst bereits bestätigte Buchungen zu einem Reiseverlauf zusammen. Jede Buchung behält ihren eigenen Gesamtbetrag, ihre Stornierungsbedingungen und ihren Lebenszyklus; eine Reise ist daher nie ein Paket mit eigenem Preis.

Tool Funktion Berechtigung
create_trip Bestätigte Buchungen zu einer Reise zusammenfassen. Ihre Preise bleiben getrennt. distribution:booking
get_trip Reise mit ihren Buchungen und den Summen je Währung abrufen. distribution:booking
add_trip_member Bestehende Buchung zu einer Reise hinzufügen. distribution:booking
remove_trip_member Buchung aus einer Reise entfernen, ohne die Buchung zu ändern. distribution:booking
cancel_trip Alle Buchungen der Reise stornieren und das Ergebnis jeweils melden. distribution:booking

Wie bucht ein Agent einen Aufenthalt?

Der dokumentierte Ablauf hat acht Schritte, vom Reiseziel bis zur Stornierung. Zweimal wartet der Agent auf die Bestätigung seines Benutzers: vor der Buchung und vor der Stornierung.

  1. Reiseziel ermitteln. Rufen Sie list_countries, list_place_types und list_places auf, um das Land, die Ortstypen, nach denen dort gesucht werden kann, und das Reiseziel selbst zu finden, etwa Antalya.
  2. Kontext ohne Preise aufbauen. Lesen Sie Unterkunftsinhalte aus der Liste „Freigegebene Unterkünfte“ mit list_properties und get_property. Keiner der beiden Aufrufe erwartet einen Point of Sale.
  3. Suchen. Rufen Sie search_property_availability für bekannte Unterkünfte auf oder search_place_availability, um ein Reiseziel zu durchsuchen. Geben Sie die gewünschte Zimmeraufteilung an: strict übernimmt jedes Zimmer genau wie angefragt, flexible erlaubt, die Reisegruppe auf bis zu neun Zimmer zu verteilen. Bewahren Sie das selection_token des gewählten Angebots serverseitig auf.
  4. Prebook. Übergeben Sie dieses Token an prebook; dabei wird der Preis des Angebots neu ermittelt. Prüfen Sie Übereinstimmungsstatus und Stornierungsbedingungen und lassen Sie beides vom Benutzer bestätigen.
  5. Buchen. Rufen Sie book mit Gast- und Kontaktdaten und einem eindeutigen idempotency_key auf. Ein erneuter Versuch mit demselben Schlüssel und unverändertem Request-Body innerhalb von 24 Stunden nach der ersten Anfrage liefert die ursprüngliche Buchung, statt eine zweite anzulegen.
  6. Status abfragen. Wird die Buchung mit dem Status „ausstehend“ zurückgegeben, etwa bei einem Preisplan, bei dem die Unterkunft erst zustimmen muss, rufen Sie get_booking auf, bis der Status feststeht.
  7. Abgleichen. Gleichen Sie Buchungen im gesamten Partnerkonto mit list_bookings ab, anhand Ihrer eigenen agency_reference oder eines begrenzten Zeitfensters nach Datum oder Änderungszeitpunkt. Die Ergebnisse enthalten keine personenbezogenen Daten der Gäste.
  8. Auf Wunsch stornieren. Zeigen Sie die Gebühr mit cancellation_quote an und rufen Sie cancel erst auf, wenn der Benutzer bestätigt.

Prebook hält keine Zimmer zurück. Die Verfügbarkeit wird beim Ausführen von book erneut geprüft; das letzte Zimmer kann also zwischen den beiden Schritten an jemand anderen gehen, und der Agent sucht dann erneut. Ein Prebook-Token ist 30 Minuten gültig und ermöglicht nur eine einzige Buchung.

Über den Server laufen keine Zahlungen. Der Partner bleibt Merchant of Record. Preispläne, die anderswo einen Zahlungsschritt erfordern, etwa eine Kartenbelastung oder einen Anzahlungsplan, lassen sich auf diesem Weg nicht buchen.

Wie authentifiziert sich der Agent?

Mit denselben OAuth-2.0-Client-Credentials wie bei einer REST-Integration. Eine Agentensitzung authentifiziert sich genau wie ein REST-Client.

Der Partner tauscht seine Client-ID und sein Client-Secret unter https://ari.console.adrasis.com/api/v1/oauth/token gegen ein Access-Token. Das Token ist eine Stunde gültig, ein Refresh-Token wird nicht ausgegeben: Läuft es ab, fordert der Agent mit denselben Zugangsdaten ein neues an. Die Dokumentation empfiehlt, ein Token zu behalten und es kurz vor Ablauf zu erneuern, statt für jeden Aufruf ein neues anzufordern.

Das Token wird im Authorization-Header der MCP-Sitzung übertragen. Partnerkonto und Berechtigungen des Tokens werden bei jedem Tool-Aufruf unverändert weitergegeben; der Aufruf eines Tools, dessen erforderliche Berechtigung dem Token fehlt, wird abgelehnt.

Zwei Berechtigungen

Berechtigung Umfang
distribution:read Referenzdaten, Unterkunftsinhalte und Verfügbarkeitssuche für Unterkünfte.
distribution:booking Prebook und Buchung von Unterkünften, Abruf von Buchungen, Abfrage der Stornierungsgebühr und Stornierung sowie alle Tools für Transfers, Touren, Flüge, Pakete und Reisen einschließlich ihrer Suchtools.

Erteilen Sie nur, was der Agent braucht. Ein Agent, der Fragen zur Verfügbarkeit beantwortet, aber nie buchen darf, erhält nur distribution:read. Neue Zugangsdaten erhalten standardmäßig beide Berechtigungen; wählen Sie daher nur die nötigen Berechtigungen, wenn Sie Zugangsdaten für einen Agenten anlegen. Ein Token lässt sich auch mit weniger Berechtigungen anfordern, als seine Zugangsdaten umfassen. Fehlercodes und weitere Details finden Sie im Leitfaden zur Authentifizierung (auf Englisch).

Was sieht der Agent?

Nur, was der Inhaber des Angebots für ihn freigegeben hat. Bei Unterkünften ist das die Liste „Freigegebene Unterkünfte“ eines Partnerprofils.

Die Tools für Unterkünfte liefern ausschließlich veröffentlichte Unterkünfte, die im Bereich „Freigegebene Unterkünfte“ des gewählten Profils ausdrücklich freigegeben sind. Jedes Partnerkonto startet mit einem Standardprofil, das den Stand der veröffentlichten Unterkünfte zum Zeitpunkt der Kontoerstellung enthält. Eine später veröffentlichte Unterkunft bleibt für den Partner gesperrt, bis der Inhaber sie freigibt. Nimmt der Inhaber die Freigabe einer Unterkunft zurück, verschwindet sie aus den Ergebnissen dieses Profils. Sie wird dabei weder gelöscht noch in anderen Profilen gesperrt.

Braucht derselbe Partner getrennte Kataloge für unterschiedliche Zielgruppen, legt der Inhaber weitere Profile im Konto an. Profilbezogene Tools akzeptieren den optionalen Parameter profile_public_id: Ohne ihn gilt das Standardprofil, mit ihm wählen Sie ein anderes Profil desselben Kontos. Jedes erfolgreiche Ergebnis nennt das tatsächlich verwendete Profil. Zugangsdaten gehören zum Konto, daher funktionieren dieselben Zugangsdaten mit jedem Profil.

Eine Unterkunft zu sehen heißt nicht, sie verkaufen zu können

list_properties und get_property zeigen, was für das Profil freigegeben ist, und nehmen keinen Point of Sale entgegen. Preise, Zimmer im Verkauf und Zielgebietsregeln erweitern das Ergebnis weder, noch schränken sie es ein. Ob ein Aufenthalt an einen Reisenden verkauft werden kann, entscheiden allein die Verfügbarkeits-Tools, die den Point of Sale des Reisenden als Ländercode erhalten.

list_bookings ist die Ausnahme bei der Profilauswahl. Das Tool liest Buchungen des gesamten Kontos, und profile_public_id beschränkt den Bericht dort nur auf die Buchungen, die über ein bestimmtes Profil angelegt wurden.

Wie erhält ein Partner Zugang?

Der Inhaber des Angebots richtet den Partner in der Adrasis Console ein. Entwicklung, Zertifizierung und Live-Betrieb laufen über denselben Host.

  1. Partnerkonto

    Der Inhaber öffnet Verbindungen, dann Vertriebskanäle, API-Partner und Partnerkonten, und legt ein Konto für die Geschäftsbeziehung an. Ein Standardprofil wird dabei automatisch angelegt.

  2. Unterkünfte freigeben

    Der Inhaber gibt in jedem Profil die gewünschten Unterkünfte frei: einzeln, als Gruppe oder über Filter nach Land und Ort.

  3. Zugangsdaten

    Gesondert benannte Zugangsdaten für jede Umgebung, mit minimalen Berechtigungen. Das Secret wird nur einmal angezeigt und gehört deshalb sofort in einen Secret-Manager.

  4. Zertifizierung und Livegang

    Mit Pilot-Zugangsdaten ist ein Demokatalog sichtbar. Beim Wechsel auf das echte Angebot bleiben Client-ID, Host und Integrationsablauf unverändert.

Preise und Verfügbarkeit im Demokatalog sind für Tests erzeugt, und Testbuchungen wirken sich weder auf echte Zimmer im Verkauf aus noch verursachen sie Kosten. Stornieren Sie trotzdem jede Testbuchung: Eine offene Testbuchung blockiert Zimmer im Demokatalog, und wiederholte Tests können dann SOLD_OUT zurückgeben.

Ein festes Anfragelimit wird nicht veröffentlicht. Limits werden für jede Verbindung vereinbart. Stimmen Sie diese deshalb mit Ihrem Ansprechpartner bei Adrasis ab, bevor Sie den Traffic erhöhen. Zusätzliche Zugangsdaten oder Profile erhöhen das Limit nicht. Der Inhaber kann Zugangsdaten im Tab „API-Zugriff“ des Kontos rotieren, deaktivieren oder widerrufen. Deaktivierte oder widerrufene Zugangsdaten funktionieren dann nicht mehr, ebenso wenig die damit ausgestellten Tokens.

Wie der Inhaber vorgeht, beschreibt die Anleitung „API-Partner und Zugangsdaten (auf Englisch)“. Wenn Ihr Team einen KI-Agenten für Reisen entwickelt und Partner werden möchte, kontaktieren Sie uns.

Bereit, einen Agenten anzubinden?

Beantragen Sie Zugang zur Console, um Ihr eigenes Angebot einzurichten, oder beschreiben Sie uns den Agenten, den Sie entwickeln, und den Zugang, den er braucht.