CONECTOR PARA ASISTENTES DE IA

CartadeViajes publica un conector MCP (Model Context Protocol) que permite a un asistente de inteligencia artificial —ChatGPT, Claude y equivalentes— trabajar con nuestro catálogo de viajes organizados dentro de la propia conversación del usuario: buscar circuitos, ver el itinerario día a día, personalizarlo, calcular el precio del grupo real, buscar vuelos de verdad para sus fechas y terminar con un enlace al presupuesto.

Somos una agencia de viajes española con licencia CICMA2543, y los circuitos son producto propio: el precio que devuelve el conector es el nuestro, no el de un intermediario.

• URL del servidor MCP: https://cartadeviajes.com/api/mcp.php
• Transporte: streamable HTTP (JSON-RPC 2.0 sobre POST). Sin SSE y sin sesiones.
• Versión de protocolo: 2025-11-25
• Autenticación: ninguna. No hay que registrarse, ni crear cuenta, ni copiar ningún token.
• Idiomas: español e inglés. Mercados: España, México, Colombia, Chile e internacional.
• Declaración de capacidades: /.well-known/ai-catalog.json

Por qué no hay autenticación, que es la pregunta razonable. Porque el servicio es público: cualquiera entra hoy en cartadeviajes.com, consulta un circuito y pide precio sin identificarse. El conector no da acceso a nada que la web no dé ya a un visitante anónimo, no expone datos de terceros y no realiza ninguna compra. No autenticación no significa no autorización: significa que no hay nada privado detrás que proteger. Pedir credenciales obligaría al usuario final a abrirse una cuenta con nosotros antes de poder preguntar por un viaje, que es exactamente lo contrario de lo que el conector resuelve.

• buscar_circuito — busca en el catálogo por país, duración, temática o texto libre, y devuelve los circuitos que encajan con su precio por persona. Solo lectura, no sale de nuestros sistemas.
• describir_circuito — cómo es el viaje: itinerario destino a destino, noches, hotel de cada destino, y los tours y traslados incluidos. Solo lectura, no sale de nuestros sistemas.
• personalizar_circuito — qué se puede cambiar: hoteles superiores, excursiones añadibles, traslados, vuelos internos, rango de noches y extensiones a nuevos destinos, cada uno con su precio. Solo lectura, no sale de nuestros sistemas.
• cotizar_circuito — recalcula el precio cada vez que cambia algo: noches, hotel, tours, destinos opcionales, fecha, y el reparto real de viajeros por habitación. Devuelve el precio de cada habitación con sus descuentos o suplementos, su total y su precio por persona, igual que la web. El precio lo calcula siempre el servidor; el asistente nunca suma ni estima. Solo lectura, no sale de nuestros sistemas.
• buscar_vuelo — la única herramienta que consulta a un proveedor externo. Busca en vivo vuelos reales para las fechas y la ciudad de salida del cliente y devuelve horarios, escalas y el precio del grupo entero. Con ella el precio del viaje queda cerrado. Se le envían al proveedor la ruta, las fechas y cuántas personas viajan; nunca datos personales. Tarda unos segundos y tiene cupo limitado.
• filtrar_vuelos — afina los vuelos que ya devolvió la búsqueda anterior: un máximo de escalas para la ida y otro para la vuelta (así se puede pedir directo a la ida y con escala a la vuelta), solo con equipaje facturado, una aerolínea concreta, una espera máxima en la escala, u ordenados por precio o por duración. No consulta al proveedor: relee la búsqueda ya realizada, así que es inmediato, no tiene cupo y si no hay una búsqueda previa lo dice en vez de lanzar una. Solo lectura, no sale de nuestros sistemas.
• crear_presupuesto — guarda el viaje configurado y devuelve un enlace a nuestra web para que el asistente se lo pase al usuario en el chat. Al abrirlo, el usuario ve exactamente el mismo presupuesto que le han contado y decide si reserva. Requiere un vuelo ya elegido. No admite ningún dato personal y no envía ningún correo.

El flujo previsto es el mismo que sigue un cliente en la web: ver circuitos → elegir uno y personalizarlo → buscar el vuelo real de sus fechas → recibir el enlace al presupuesto. No se genera ningún presupuesto sin un vuelo cerrado, para que al usuario no le llegue un precio a medias.

• No reserva ni cobra nada. Ninguna herramienta contrata un viaje, emite un billete ni realiza un pago. La contratación ocurre siempre después, en nuestra web y con el usuario delante.
• No borra ni modifica nada del cliente, porque no hay cuenta de cliente que tocar.
• No pide datos personales en ninguna de las siete herramientas: ni nombre, ni correo, ni teléfono, ni documento de identidad.
• No devuelve contenido patrocinado. El orden de los resultados lo decide nuestro buscador; ningún tercero paga por aparecer ni por aparecer antes.

Todos los precios se expresan por persona, con impuestos y tasas aéreas incluidos, en la divisa del mercado que se solicite, e incluyen el circuito, el vuelo internacional y el seguro de viaje. Antes de buscar vuelos, el precio lleva dentro el vuelo más económico que hemos encontrado de verdad para esa ruta y duración —una tarifa que existió, no un mínimo teórico— y corresponde a la fecha de salida más barata, no a la del cliente. En cuanto se buscan vuelos para sus fechas, el precio pasa a ser el definitivo de esas fechas. Cada respuesta indica explícitamente en qué situación está el precio, para que el asistente no pueda presentárselo al usuario como cerrado cuando todavía no lo es.

El conector no trata datos personales. Lo que recibimos son parámetros de viaje (país, fechas, duración, hoteles, número de viajeros por habitación) y, en la búsqueda de vuelos, la ciudad de salida. Quien nos llama es el servidor del proveedor de IA, no la persona: no recibimos identificador de usuario ni el contenido de la conversación.

De cada búsqueda de vuelos registramos la dirección IP y el User-Agent de quien llama —el servidor del proveedor— con la única finalidad de aplicar los límites de uso y prevenir el abuso. El único tercero que recibe información es nuestro proveedor aéreo, Aramix, y solo ruta, fechas y número de pasajeros.

El detalle completo, con las bases jurídicas, los plazos de conservación y cómo ejercer tus derechos, está en la sección «Conector para asistentes de IA» de nuestra política de privacidad.

Las cuatro herramientas de catálogo son gratuitas e ilimitadas: consultan nuestra propia base de datos. Filtrar vuelos también, porque relee una búsqueda ya hecha en vez de lanzar una nueva. La búsqueda de vuelos y la creación de presupuestos comparten un cupo, porque cada búsqueda de vuelos tiene un coste real para nosotros:

• Conectores publicados en un directorio oficial (los que se reconocen por su rango de IP o por firma): 6 llamadas por IP y 24 en total cada 10 minutos.
• Resto del tráfico: 2 llamadas por IP y 8 en total cada 10 minutos.

Al agotarse el cupo no se devuelve un error. La búsqueda de vuelos responde con normalidad, devolviendo el precio con el vuelo más económico conocido, marcando que aún no es el precio de las fechas del cliente e indicando al asistente que le describa el viaje y le pase el enlace a la ficha. Es lo mismo que ve un visitante de la web antes de buscar vuelo. Se hace así a propósito: un error haría que el asistente le dijera al usuario que no funcionamos.

Si necesitas un cupo mayor para una integración concreta, escríbenos.

Añade https://cartadeviajes.com/api/mcp.php como conector personalizado (sin autenticación) y pide en español, en este orden:

1. «Búscame viajes a Perú» → devuelve los circuitos de Perú con su duración y su precio.
2. «Cuéntame el segundo con detalle» → itinerario día a día, hoteles y qué se puede cambiar.
3. «¿Cuánto costaría para dos adultos y un niño?» → precio del grupo real por habitaciones.
4. «Añádele dos noches en Cusco y cámbiame el hotel por uno mejor» → el precio se recalcula.
5. «Saldríamos de Madrid el 15 de marzo, busca vuelos» → vuelos reales con horarios y escalas (esta es la llamada que tarda unos segundos).
6. «¿Hay alguno directo y con maleta facturada?» → filtra sobre esa misma búsqueda, al instante y sin volver a consultar al proveedor.
7. «Hazme el presupuesto y pásame el enlace» → devuelve una URL de cartadeviajes.com que se puede abrir en el navegador y que muestra ese mismo presupuesto.

No hace falta ninguna cuenta de prueba: todo funciona anónimamente. El presupuesto que se crea es un borrador sin datos personales y caduca solo. Si algo no responde como se describe aquí, escríbenos y lo miramos.

• Correo: comunidad@cartadeviajes.com
• Teléfono y WhatsApp: +34 644 600 031
• Titular: CARTADEVIAJES S.L. · CIF B86173184 · C/ Obanos 4, 28050 Madrid (España) · Licencia de agencia de viajes CICMA2543

Actualizado a 29 de julio de 2026