Adrasis ofrece un servidor Model Context Protocol (MCP) sobre su Distribution Partner API. Los agentes de IA buscan y reservan alojamiento, traslados, excursiones, chárter y paquetes según las reglas de la API, en una cuenta de partner.
El servidor encapsula el contrato REST de la Distribution Partner API de Adrasis. Tu agente llama a herramientas en lugar de endpoints, y cada herramienta se comporta como la llamada REST que hay detrás.
Al comparar servidores MCP de viajes, tres preguntas deciden casi todo: de dónde viene la oferta, quién controla lo que puede hacer un agente y si una reserva es real. Aquí la oferta es la que una agencia o un turoperador gestiona en Adrasis Consola, y ese titular controla el acceso mediante una cuenta de partner y sus permisos. Una llamada a book que se completa con éxito crea la reserva y reduce el inventario, igual que una reserva por REST.
Nada se reinterpreta para los agentes. Las herramientas usan los mismos esquemas de petición y respuesta, la misma lógica de negocio y las mismas reglas de precios y de uso que el contrato REST, de modo que un agente y una integración convencional trabajan con un único conjunto de reglas.
# Remote MCP server, streamable HTTP https://ari.console.adrasis.com/mcp # OAuth 2.0 access token Authorization: Bearer <access token>
Un agente también puede prescindir de MCP y llamar directamente al contrato REST. El contrato completo, legible por máquina, está publicado en la referencia de la API (en inglés).
El servidor MCP es para un agente de IA que hace reservas con la oferta de otra empresa mediante una cuenta de partner. El operador de IA hace el trabajo dentro de tu propia organización.
Intervienen dos partes. El titular del inventario es una agencia o un turoperador que mantiene sus contratos y precios en Adrasis Consola. El partner crea el agente: una OTA (agencia de viajes online), una app de viajes, otra agencia o un partner tecnológico. El titular crea una cuenta de partner, abre los alojamientos que el partner puede reservar y emite credenciales, y el agente solo trabaja dentro de esa cuenta.
Tu equipo envía instrucciones por el panel de chat de la Consola, por correo o por WhatsApp. El operador de IA prepara el trabajo sobre tu catálogo, tus tarifas, tus contratos y tu distribución. El SMS se usa para alertas y aprobaciones de operaciones. Las peticiones que solo leen datos se responden al momento. Lo que cambia datos se muestra en vista previa y solo se ejecuta cuando lo confirmas, y el operador de IA nunca lee datos de otra organización. Mira cómo funciona el operador de IA.
Cada herramienta corresponde a una operación REST y usa sus esquemas de petición y respuesta. Las herramientas se agrupan por producto, y cada una requiere uno de dos permisos.
Datos de referencia, contenido de alojamientos, búsqueda de disponibilidad y el ciclo completo de reserva para hoteles, alquileres vacacionales, villas y apartamentos. Alojamientos abiertos es la lista de alojamientos abiertos a un perfil de partner.
| Herramienta | Qué hace | Permiso |
|---|---|---|
search_property_availability |
Encuentra la oferta de menor precio de cada alojamiento, hasta un máximo de 200 alojamientos. | distribution:read |
search_place_availability |
Encuentra las ofertas de menor precio en un destino, hasta 100 alojamientos por página. | distribution:read |
list_countries |
Lista los países con sus ID, códigos ISO y nombres localizados. | distribution:read |
list_place_types |
Lista los ocho tipos de lugar y cuáles admiten búsqueda en cada país. | distribution:read |
list_places |
Encuentra destinos por país, tipo, lugar superior o nombre. | distribution:read |
list_properties |
Lista el contenido de los alojamientos incluidos en «Alojamientos abiertos», sin precios. | distribution:read |
get_property |
Lee el contenido completo de un alojamiento. | distribution:read |
prebook |
Vuelve a calcular el precio de la oferta elegida; devuelve un token de prerreserva, el estado de coincidencia y la política de cancelación. | distribution:booking |
book |
Confirma la reserva, con una clave de idempotencia para reintentos seguros. | distribution:booking |
get_booking |
Lee una reserva, o consulta periódicamente una pendiente. | distribution:booking |
list_bookings |
Concilia reservas por tu referencia, un intervalo de fechas o cambios recientes. | distribution:booking |
cancellation_quote |
Muestra la penalización por cancelación sin cambiar nada. | distribution:booking |
cancel |
Cancela la reserva y aplica su penalización. Se puede repetir sin riesgo. | distribution:booking |
La búsqueda de ofertas de un solo alojamiento está disponible solo por REST. Devuelve la mejor oferta para todo el grupo, seguida de cada opción de habitación y plan de tarifas disponible para cada habitación pedida, de menor a mayor precio y con cantidades seleccionables.
Cada producto sigue el mismo patrón de búsqueda, prerreserva y reserva que el alojamiento. Los vuelos son chárter, y un viaje de ida y vuelta se busca como dos trayectos separados.
| Herramienta | Qué hace | Permiso |
|---|---|---|
search_transfers |
Encuentra ofertas de traslado entre dos zonas para una fecha de servicio y un grupo. | distribution:booking |
prebook_transfer |
Vuelve a calcular el precio de una oferta de traslado y devuelve un token de prerreserva con sus condiciones de cancelación. | distribution:booking |
book_transfer |
Confirma el traslado, con una clave de idempotencia. | distribution:booking |
search_tours |
Encuentra ofertas de una excursión en una fecha de salida para un grupo. | distribution:booking |
prebook_tour |
Vuelve a calcular el precio de una oferta de excursión y devuelve un token de prerreserva con sus condiciones de cancelación. | distribution:booking |
book_tour |
Confirma la excursión, con una clave de idempotencia. | distribution:booking |
search_flights |
Encuentra ofertas de vuelos chárter para una fecha de salida y una composición de pasajeros. | distribution:booking |
prebook_flight |
Vuelve a calcular el precio de una oferta de vuelo y devuelve un token de prerreserva con sus condiciones de cancelación. | distribution:booking |
book_flight |
Confirma la reserva del vuelo, con una clave de idempotencia. | distribution:booking |
En un paquete se venden de 2 a 8 servicios que el agente ya ha seleccionado, de al menos dos tipos de producto, a un precio único. O se confirman todos los servicios o ninguno. Una vez reservado, un paquete se consulta y se cancela con get_booking, cancellation_quote y cancel, y los dos últimos también pueden dirigirse a un servicio concreto del paquete.
| Herramienta | Qué hace | Permiso |
|---|---|---|
search_packages |
Combina de 2 a 8 servicios seleccionados en una oferta con un precio único. | distribution:booking |
prebook_package |
Vuelve a comprobar cada servicio y devuelve el estado de coincidencia, la información obligatoria de cumplimiento normativo y un token de prerreserva. | distribution:booking |
book_package |
Reserva el paquete completo de una vez: se confirman todos los servicios o ninguno. | distribution:booking |
Un viaje agrupa reservas ya confirmadas en un itinerario. Cada reserva mantiene su total, su política de cancelación y su ciclo de vida, así que un viaje nunca es un paquete con precio.
| Herramienta | Qué hace | Permiso |
|---|---|---|
create_trip |
Agrupa reservas confirmadas en un viaje. Sus precios siguen separados. | distribution:booking |
get_trip |
Consulta un viaje con sus reservas y totales por moneda. | distribution:booking |
add_trip_member |
Añade una reserva existente a un viaje. | distribution:booking |
remove_trip_member |
Retira una reserva de un viaje sin modificarla. | distribution:booking |
cancel_trip |
Cancela todas las reservas del viaje e informa de cada resultado. | distribution:booking |
El flujo documentado tiene ocho pasos, de la geografía a la cancelación. El agente se detiene dos veces a pedir confirmación a su usuario: antes de reservar y antes de cancelar.
list_countries, list_place_types y list_places para encontrar el país, los tipos de lugar que admiten búsqueda allí y el destino, como Antalya.list_properties y get_property. Ninguna de las dos recibe un punto de venta.search_property_availability para alojamientos conocidos, o a search_place_availability para recorrer un destino. Indica la intención de reparto: strict mantiene cada habitación tal como se pidió; flexible permite repartir el grupo en hasta nueve habitaciones. Guarda en el servidor el selection_token de la oferta elegida.prebook, que vuelve a calcular el precio de la oferta. Lee el estado de coincidencia y la política de cancelación, y confirma ambos con el usuario.book con los datos de los huéspedes y de contacto y una idempotency_key única. Un reintento con la misma clave y el mismo cuerpo de petición en las 24 horas siguientes a la primera petición devuelve la reserva original en lugar de crear otra.get_booking hasta que el estado se resuelva.list_bookings, usando tu propia agency_reference o un intervalo acotado de fechas o de fecha de modificación. Los resultados no incluyen datos personales de los huéspedes.cancellation_quote y llama a cancel solo cuando el usuario confirme.La prerreserva no bloquea inventario. La disponibilidad se comprueba de nuevo cuando se ejecuta book, así que otra persona puede reservar la última habitación entre los dos pasos, y entonces el agente vuelve a buscar. Un token de prerreserva es válido 30 minutos y solo permite crear una reserva.
Ningún pago pasa por el servidor. El partner sigue siendo el merchant of record, la entidad que figura como vendedora en el cobro. Las tarifas que requieren un paso de pago fuera del servidor, como un cargo en tarjeta o un calendario de depósitos, no pueden reservarse así.
Con las mismas credenciales de cliente OAuth 2.0 que usa una integración REST. Una sesión de agente se autentica exactamente igual que un cliente REST.
El partner intercambia su ID de cliente y su secreto de cliente por un token de acceso en https://ari.console.adrasis.com/api/v1/oauth/token. El token es válido una hora y no se emite token de renovación: cuando caduca, el agente pide uno nuevo con las mismas credenciales. La documentación recomienda conservar un token y renovarlo poco antes de que caduque, en lugar de pedir uno por llamada.
El token viaja en la cabecera Authorization de la sesión MCP. La cuenta del partner y los permisos del token se reenvían sin cambios en cada llamada a una herramienta, y se rechaza la llamada si el token no tiene el permiso que exige la herramienta.
| Permiso | Qué cubre |
|---|---|
distribution:read |
Datos de referencia, contenido de alojamientos y búsqueda de disponibilidad de alojamiento. |
distribution:booking |
Prerreserva, reserva, consulta de reservas, consulta de gastos de cancelación y cancelación de alojamiento, además de todas las herramientas de traslados, excursiones, vuelos, paquetes y viajes, incluidas sus búsquedas. |
Concede solo lo que el agente necesita. Un agente que responde preguntas de disponibilidad pero nunca debe reservar recibe solo distribution:read. Las credenciales nuevas reciben ambos permisos por defecto, así que elige el mínimo al crear una para un agente. Un token también puede pedirse con menos permisos de los que tiene su credencial. Los códigos de error y el resto de detalles están en la guía de autenticación (en inglés).
Solo lo que el titular del inventario le ha abierto. En alojamiento, es la lista «Alojamientos abiertos» de un perfil de partner.
Las herramientas de alojamientos devuelven los alojamientos publicados que están abiertos de forma explícita en «Alojamientos abiertos» del perfil seleccionado, y nada más. Cada cuenta de partner empieza con un perfil Default, con una instantánea de los alojamientos publicados cuando se creó la cuenta. Un alojamiento publicado después sigue cerrado para el partner hasta que el titular lo abre. Cerrar un alojamiento lo saca de los resultados de ese perfil sin borrarlo ni cerrarlo en otros perfiles.
Cuando el mismo partner necesita catálogos separados para públicos distintos, el titular añade más perfiles a la cuenta. Las herramientas con ámbito de perfil aceptan un profile_public_id opcional: omítelo para usar el perfil Default, o envíalo para elegir otro perfil de la misma cuenta. Cada resultado correcto indica el perfil que se usó realmente. Las credenciales pertenecen a la cuenta, así que una credencial funciona con todos los perfiles.
list_properties y get_property muestran lo que está abierto al perfil y no reciben un punto de venta. Las tarifas, el inventario y las reglas de destino no amplían ni reducen lo que muestran. Si una estancia puede venderse a un viajero lo deciden solo las herramientas de disponibilidad, que reciben el punto de venta del viajero como código de país.
list_bookings es la excepción a la selección de perfil. Lee las reservas de toda la cuenta, y ahí profile_public_id solo limita el informe a las reservas creadas por un perfil.
El titular del inventario da de alta al partner en Adrasis Consola. El desarrollo, la certificación y el tráfico real usan el mismo host.
El titular abre Conectividad, después Canales de venta, Partners de API y Cuentas de partner, y crea una cuenta para la relación. La cuenta incluye un perfil Default.
El titular da acceso en cada perfil a los alojamientos previstos: de uno en uno, en grupo o con filtros de país y lugar.
Una credencial con nombre propio para cada entorno, con los permisos mínimos. El secreto se muestra una sola vez, así que va directo a un gestor de secretos.
Las credenciales piloto ven un catálogo de demostración. Al pasar a oferta real, el ID de cliente, el host y el flujo de integración no cambian.
El catálogo de demostración tiene tarifas y disponibilidad generadas para pruebas, y las reservas de prueba no afectan al inventario real ni generan cargos. Cancela de todos modos cada reserva de prueba: una reserva de prueba abierta ocupa inventario de demostración, y las pruebas repetidas pueden empezar a devolver SOLD_OUT.
No se publica un límite fijo de peticiones. Los límites se acuerdan para cada conexión, así que confírmalos con tu contacto en Adrasis antes de aumentar el tráfico. Añadir credenciales o perfiles no aumenta el límite de peticiones. El titular puede rotar, desactivar o revocar una credencial desde la pestaña Acceso API de la cuenta, y una credencial desactivada o revocada deja de funcionar junto con los tokens emitidos con ella.
Lo que hace el titular se describe en Partners de API y credenciales (en inglés). Si tu equipo está creando un agente de IA para viajes y quiere ser partner, contacta con nosotros.
Solicita acceso a la Consola para configurar tu propia oferta, o háblanos del agente que estás creando y del acceso que necesita.