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.
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).
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.
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.
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.
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.
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 |
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 |
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 |
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.
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.list_properties und get_property. Keiner der beiden Aufrufe erwartet einen Point of Sale.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.prebook; dabei wird der Preis des Angebots neu ermittelt. Prüfen Sie Übereinstimmungsstatus und Stornierungsbedingungen und lassen Sie beides vom Benutzer bestätigen.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.get_booking auf, bis der Status feststeht.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.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.
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.
| 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).
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.
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.
Der Inhaber des Angebots richtet den Partner in der Adrasis Console ein. Entwicklung, Zertifizierung und Live-Betrieb laufen über denselben Host.
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.
Der Inhaber gibt in jedem Profil die gewünschten Unterkünfte frei: einzeln, als Gruppe oder über Filter nach Land und Ort.
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.
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.
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.