Un servidor MCP de reservas de viajes
para agentes de IA.

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.

Un servidor MCP remoto sobre la API de partners.

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).

MCP y el operador de IA de Adrasis.

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.

El operador de IA trabaja con tus propios datos

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.

¿Qué herramientas puede invocar un agente?

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.

Alojamiento

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.

Traslado, excursión y vuelo

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

Paquetes

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

Agrupación en viajes

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

¿Cómo puede un agente reservar una estancia?

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.

  1. Identificar el destino. Llama a 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.
  2. Reunir contexto sin precios. Lee el contenido de los alojamientos de Open properties con list_properties y get_property. Ninguna de las dos recibe un punto de venta.
  3. Buscar. Llama a 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.
  4. Prerreservar. Pasa ese token a 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.
  5. Reservar. Llama a 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.
  6. Consultar. Si la reserva queda pendiente, por ejemplo con una tarifa que espera la aceptación del alojamiento, llama a get_booking hasta que el estado se resuelva.
  7. Conciliar. Cruza las reservas de la cuenta con 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.
  8. Cancelar a petición. Muestra la penalización con 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í.

¿Cómo se autentica el agente?

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.

Dos permisos

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).

¿Qué puede ver el agente?

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.

Ver un alojamiento no es lo mismo que venderlo

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.

¿Cómo obtiene acceso un partner?

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.

  1. Cuenta de partner

    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.

  2. Dar acceso a los alojamientos

    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.

  3. Credenciales

    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.

  4. Certificación y puesta en producción

    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.

¿Todo listo para conectar un agente?

Solicita acceso a la Consola para configurar tu propia oferta, o háblanos del agente que estás creando y del acceso que necesita.