BookingTruth

npx add-mcp 'https://api.bookingtruth.com/mcp'

BookingTruth

¿Esa reserva es realmente real? BookingTruth es una API de verificación de reservas y un servidor MCP para agentes de IA. Envíale correos de confirmación de reservas y recibos; concilia contradicciones entre los registros de los proveedores y devuelve un veredicto: confirmed, held, pending, cancelled o un honesto unknown, cada uno con un paquete de pruebas citable.

La regla principal: CONFIRMED se devuelve solo con evidencia autoritativa del proveedor (nivel 5-6: una consulta autenticada al proveedor, o un recibo emitido por el proveedor que contenga un artefacto de emisión como un número de eTicket). Todo lo que esté por debajo de ese umbral devuelve un seguro UNKNOWN con un indicated_state — nunca una suposición del LLM. Un correo de la OTA que diga "¡todo listo!" no es un boleto emitido. "Estamos procesando tu solicitud" no es un boleto emitido. Un número de eTicket de 13 dígitos emitido sí lo es.

Endpoint en vivo: https://api.bookingtruth.com — el sandbox es gratuito, sin registro.

Herramientas MCP

Herramienta	Qué hace
booking_check	Analiza documentos de reserva/confirmación (correos, recibos) y devuelve veredictos reconciliados del estado de la reserva con paquetes de pruebas citables.
supplier_coverage	Lista los proveedores que BookingTruth puede analizar o consultar actualmente, con el estado por proveedor (inicializado/planificado).

Instalación

Servidor remoto streamable-HTTP — sin instalación, sin clave para el sandbox.

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "bookingtruth": {
      "type": "url",
      "url": "https://api.bookingtruth.com/mcp"
    }
  }
}

Cursor / otros clientes MCP: añade un servidor MCP remoto con la URL https://api.bookingtruth.com/mcp.

Uso

Pregunta a tu agente cosas como:

• "Aquí está el correo de confirmación que envió United — ¿mi vuelo está realmente emitido?"
• "Expedia dice que mi coche de alquiler está confirmado. Verifícalo."
• "Cambié mi vuelo y recibí tres correos diferentes. ¿Cuál es el estado real de mi reserva?"

O llama a la herramienta directamente con el texto del documento en bruto:

{
  "documents": [
    {"filename": "united_eticket.txt", "content": "<raw email text>"}
  ]
}

API REST

# free sample documents to try (synthetic demo fixtures)
curl https://api.bookingtruth.com/v1/demo/fixtures
curl https://api.bookingtruth.com/v1/demo/fixtures/united_eticket_QA7X2K.txt

# run a check (sandbox: any Bearer key starting with sb_)
curl -X POST https://api.bookingtruth.com/v1/check \
  -H "Authorization: Bearer sb_demo" \
  -H "Content-Type: application/json" \
  -d '{"documents": [{"filename": "doc.txt", "content": "<raw email text>"}]}'

• Descubrimiento: https://api.bookingtruth.com/.well-known/booking-assurance.json
• OpenAPI 3.0: https://api.bookingtruth.com/v1/openapi.yaml
• Documentación orientada a agentes: https://api.bookingtruth.com/llms.txt
• Los veredictos persisten: GET /v1/bookings/{id} y GET /v1/bookings/{id}/proof

Precios

Sandbox: gratuito, recorrido completo, con fixtures de demostración incluidos. De pago: $0.05 por verificación, paquetes prepagados ($10 / $25 / $50 = 200 / 500 / 1,000 verificaciones) a través de POST /v1/buy. Las claves de pago comienzan con pk_; consulta el crédito restante en GET /v1/balance.

Cobertura de proveedores

Inicializados hoy: United (análisis de confirmación + recibo de eTicket), Expedia (itinerario OTA), Disney (correos de reserva agregados). Más proveedores planificados — llama a supplier_coverage para ver la matriz en vivo.

Cómo funciona

1. Analizar — los analizadores específicos de cada proveedor extraen afirmaciones tipadas (identidad, estado, parte, dinero) de cada documento, cada afirmación con un nivel de evidencia (0-6).
2. Conciliar — las afirmaciones se resuelven en identidades de reserva; las contradicciones (por ejemplo, texto de "procesando" frente a un eTicket emitido) se registran como registros de conflicto de primera clase; las reglas R0-R5 deciden el veredicto.
3. Probar — cada veredicto incluye un paquete de pruebas: las afirmaciones, los niveles, el rastro de reglas y los hashes de las fuentes detrás de la decisión. La salida del LLM es de nivel 0 y nunca puede decidir un veredicto.

Consulta docs/ para ARCHITECTURE, API-SPEC, PARSER-FRAMEWORK y PROOF-PACKET.

Estructura del repositorio

• booking_assurance/ — el paquete de Python (solo stdlib, Python 3.10+): analizadores, motor de reconciliación, paquetes de pruebas, servidores REST + MCP
• fixtures/ — fixtures de demostración sintéticos (sin datos reales)
• tests/run_tests.py — 16 verificaciones sobre los casos de contradicción
• server.json — metadatos del registro MCP (com.bookingtruth/bookingtruth)

Ejecutar las pruebas

python3 tests/run_tests.py

Licencia

MIT