Servidor MCP de Booking.com

Un servidor alojado del Model Context Protocol (MCP) que ofrece a Claude, Cursor, Windsurf y cualquier otro cliente MCP dos herramientas de solo lectura de Booking.com. Busca estancias por destino y fechas con filtros avanzados, y lee una propiedad concreta completa, todo como JSON estructurado, sin cuenta de Booking.com y sin nada que alojar.

Lee las páginas públicas de propiedades en Booking.com que puede ver un visitante sin sesión iniciada.

https://mcp.hasdata.com/api/mcp?apis=booking

Contenido

• Qué necesitas

• Inicio rápido

• Ejemplos de prompts

• Herramientas

• Errores y casos de fallo

• Precios, plan gratuito y límites

• Selección de herramientas

• Cómo se compara

• Preguntas frecuentes

• Enlaces de HasData

• Desarrollo

• Contribución

• Licencia

Related MCP server: mydatavalue-mcp

Qué necesitas

Un cliente MCP y una clave de API de HasData del panel de control, que puedes crear gratis sin tarjeta; la prueba incluye 100 llamadas a la tarifa de 10 créditos. Este es un servidor remoto, por lo que la vía más sencilla es una URL y una cabecera x-api-key, sin contenedor que ejecutar y sin cuenta de Booking.com en ninguna parte del proceso. Un cliente que solo hable stdio llega a él mediante un lanzador ligero, publicado como @hasdata/booking-mcp en npm y hasdata-booking-mcp en PyPI, que se muestra abajo.

Inicio rápido

La URL del servidor es la misma para todos los clientes. Lo hemos probado en la práctica en Claude Code y Claude Desktop. Los demás bloques siguen el formato que cada cliente documenta para un servidor remoto.

Los clientes con soporte de OAuth pueden añadir la misma URL como conector e iniciar sesión sin poner una clave en un archivo de configuración.

claude mcp add --transport http booking "https://mcp.hasdata.com/api/mcp?apis=booking" \
  --header "x-api-key: HASDATA_API_KEY"

Ajustes, luego Conectores, luego Añadir conector personalizado, y pega https://mcp.hasdata.com/api/mcp?apis=booking e inicia sesión.

Para la vía del archivo de configuración, Claude Desktop solo carga servidores locales (stdio), por lo que accede a un servidor remoto mediante un lanzador stdio. El paquete @hasdata/booking-mcp es ese lanzador, y lee la clave desde el entorno. Añade esto a claude_desktop_config.json:

{
  "mcpServers": {
    "booking": {
      "command": "npx",
      "args": ["-y", "@hasdata/booking-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

Para Python en lugar de Node, sustituye el lanzador por el paquete de PyPI, que uvx ejecuta sin instalación manual:

{
  "mcpServers": {
    "booking": {
      "command": "uvx",
      "args": ["hasdata-booking-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

~/.cursor/mcp.json para cada proyecto, o .cursor/mcp.json para uno solo:

{
  "mcpServers": {
    "booking": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=booking",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codeium/windsurf/mcp_config.json. Windsurf llama al campo serverUrl, no url:

{
  "mcpServers": {
    "booking": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=booking",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

.vscode/mcp.json en el espacio de trabajo:

{
  "servers": {
    "booking": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=booking",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

Ejemplos de prompts

Son prompts, no código. Pega uno y el agente elige la herramienta por sí mismo. Cada uno indica las llamadas que requiere, porque cada llamada correcta cuesta 10 créditos.

Busca en Booking.com hoteles en París del 15 al 18 de septiembre para dos adultos y dame los diez mejor valorados por menos de $700 para la estancia.

Una llamada, 10 créditos. El precio, la puntuación de las reseñas y la ubicación se devuelven en el resultado de la búsqueda.

Toma el primer resultado y obtén todos sus detalles: instalaciones, normas de la casa, las opciones de habitación y las valoraciones por categoría.

Una llamada, 10 créditos. Esos datos están en la página de la propiedad, que la herramienta de detalles lee mediante URL y fechas.

Encuentra hoteles de cuatro estrellas en París con cancelación gratuita cerca del centro, y lista el precio y la puntuación de las reseñas.

Una llamada, 10 créditos. La categoría por estrellas, la política de cancelación y la distancia son filtros en una única solicitud.

Compara la estancia más barata en París con la de Roma para las mismas fechas.

Dos llamadas, 20 créditos, una búsqueda por ciudad.

La herramienta de propiedades necesita las mismas fechas y el mismo número de huéspedes que la búsqueda, porque la disponibilidad y el precio dependen del período. Una búsqueda para preseleccionar y una llamada de detalles sobre tres propiedades son una búsqueda y tres llamadas de propiedad.

Herramientas

Dos herramientas, de solo lectura. Los ejemplos siguientes están abreviados a partir de llamadas reales, y los precios cambian constantemente. Léelos como esquemas. Cada nombre de herramienta enlaza con su referencia de endpoint, que incluye la lista completa de campos.

Los ejemplos son el payload, no la respuesta completa. Un resultado de tools/call lleva un bloque de texto, y ese texto es en sí mismo JSON que contiene url, status, text y json, con los datos extraídos en json. Desde una respuesta JSON-RPC sin procesar, la ruta es result.content[0].text, que se parsea y luego .json. Un cliente de chat te lo desempaqueta, y el código que habla directamente con el endpoint no lo hace.

Obtener resultados de búsqueda de Booking.com

hasdata_booking_search_getBookingSearchResults

Una página de estancias por destino y fechas.

La referencia documenta el conjunto completo de filtros, incluidos distancia, comidas, accesibilidad, preferencia de cama y grupo de viaje.

Devuelve searchInformation, un array results y pagination con page, totalResults y totalPages. Cada resultado incluye hotelId, title, url, la room ofrecida y bedTypes, un objeto location, un objeto policies, un objeto price, el rating de estrellas, un objeto reviews con score, count y una etiqueta de texto, y una photo.

El campo de descuento en price se escribe dicsount (dicsountRaw y dicsountParsed), que refleja la clave del origen. Lee esa grafía, no discount. Ten en cuenta también que rating es la categoría oficial por estrellas, mientras que reviews.score es la puntuación de los huéspedes sobre 10, dos números distintos.

{
  "hotelId": 50724,
  "title": "Hôtel du Jardin des Plantes",
  "url": "https://www.booking.com/hotel/fr/timjardindesplantes.html",
  "room": "Comfort Double Room",
  "location": { "city": "Paris", "address": "5 rue Linné", "mainDistance": "0.9 miles from downtown", "centrallyLocated": true },
  "policies": { "freeCancellation": true, "noPrepayment": true },
  "price": { "pricePerStayParsed": 451.36, "priceBeforeDiscountParsed": 885.03, "dicsountParsed": 433.66, "currency": "USD" },
  "rating": 3,
  "reviews": { "score": 7.5, "count": 1721, "text": "Good" }
}

Obtener detalles de la propiedad de Booking.com

hasdata_booking_place_getBookingPlaceDetails

Una propiedad completa, a partir de su URL y el período de la estancia.

Devuelve la página en secciones, no como un único objeto plano: overview (id, title, propertyType, una address estructurada, una description, highlights, mostPopularFacilities y photos), bookingDetails (el período y la moneda que reflejan los precios), un array rooms de las habitaciones disponibles, cada una con name, beds, facilities y variants con precio, una lista facilities, houseRules, un array ratings de puntuaciones por categoría, reviews y questionsAndAnswers.

{
  "overview": {
    "id": "50724",
    "title": "Hôtel du Jardin des Plantes",
    "propertyType": "HOTEL",
    "address": { "country": "France", "zipcode": "75005" },
    "mostPopularFacilities": ["Non-smoking rooms", "Free Wifi", "24-hour front desk"]
  },
  "bookingDetails": { "checkIn": "2026-09-15", "checkOut": "2026-09-18", "adults": 2, "rooms": 1, "currency": "USD" },
  "ratings": [
    { "label": "Average", "value": 7.5, "votes": 1721 },
    { "label": "Cleanliness", "value": 7.8 }
  ]
}

Errores y casos de fallo

Tu cliente casi nunca ve un código de error HTTP en una llamada de herramienta. La capa MCP responde con 200 y coloca el fallo dentro del resultado, con isError establecido en true y el motivo como texto. El agente lee un mensaje cuando cabría esperar una línea de estado.

Una clave incorrecta aparece como salida de la herramienta, no como una conexión fallida. tools/list acepta cualquier clave no vacía y devuelve ambas herramientas, por lo que el cliente completa su handshake y se muestra en verde. La primera llamada a una herramienta devuelve entonces isError: true y el texto HasData API error: 401 Unauthorized. Busca esa cadena, porque nada anterior en el flujo notifica el problema.

La ausencia de clave es el único error HTTP real. La autorización se ejecuta antes que cualquier herramienta, y la conexión en sí falla con 401. Las cabeceras CORS están presentes, y un cliente de navegador lee el estado y no un fallo de red opaco.

Un argumento que rompe el esquema de una herramienta se rechaza antes de convertirse en un raspado. El servidor responde con isError: true y el texto MCP error -32602: Input validation error, indicando el campo infractor. Un recuento de children sin los childrenAges correspondientes, o una fecha de salida igual o anterior a la de entrada, se detecta aquí.

Una búsqueda sin disponibilidad devuelve un resultado correcto con un array results vacío, no un error. Un destino y un período sin disponibilidad se devuelven igualmente con requestMetadata.status establecido en ok. Comprueba la longitud del array antes de iterar.

Una URL de propiedad que ya no resuelve devuelve 400 con requestMetadata.status establecido en error.

Los resultados que contienen datos también incluyen un requestMetadata.id que merece la pena citar en el soporte.

Precios, plan gratuito y límites

Cada herramienta de Booking.com cuesta 10 créditos por llamada correcta. El tamaño de la respuesta no cambia el precio. Una página de búsqueda con 25 alojamientos cuesta lo mismo que una con dos.

La prueba gratuita incluye 1.000 créditos durante 30 días sin tarjeta, es decir, 100 llamadas a Booking.com. Después, una cuenta activa sigue recibiendo una recarga de 100 créditos al día siempre que su saldo baje de 100, por lo que un agente de bajo volumen funciona en el plan gratuito indefinidamente.

Los planes de pago empiezan en 49 $ al mes por 200.000 créditos, lo que equivale a 20.000 llamadas. El precio unitario baja con el volumen, desde 2,45 $ por cada 1.000 llamadas en el plan inicial hasta 0,99 $ en Business, 0,83 $ en Growth y 0,75 $ en los planes de alto volumen más grandes.

Tu plan también establece la concurrencia. La prueba gratuita permite 1 solicitud a la vez, Startup 15, Business 30, Growth 50, y los planes de alto volumen van de 200 a 1.500. Gestiona el caso de desbordamiento de forma defensiva en cualquier proceso desatendido.

Una solicitud que devuelve un código distinto de 200 no se factura. Una llamada correcta que no encuentra nada sigue siendo una llamada.

Selección de herramientas

El parámetro de consulta apis determina qué herramientas ve tu agente. Cuantas menos herramientas, menos contexto se gasta en las definiciones de las herramientas y menos probabilidades hay de que el modelo elija la equivocada.

?apis=booking                    the two tools in this repo
?apis=booking,airbnb             add Airbnb stays
?apis=booking,google_travel      add Google Hotels and Flights

El parámetro acepta nombres de proveedor como booking y nombres de API individuales como booking_search. Los nombres mal escritos se ignoran. Si todos los nombres son incorrectos, la solicitud falla con 400, y el cuerpo indica tanto lo que no reconoció como todos los valores válidos. Si omites el parámetro, el mismo endpoint expone las 57 herramientas de HasData.

Comparativa

Los programas propios de Booking.com (la Demand API y la red de socios afiliados) son para socios aprobados que envían reservas y ganan comisiones, no una forma autoservicio de leer el mercado público. Para buscar alojamientos y consultar propiedades concretas, la vía es extraer las páginas públicas, y este servidor lo hace con un esquema estable.

Lo que este servidor no hace. Nada de reservas, pagos, comisiones de socios ni datos de cuenta. Lee lo que un visitante sin sesión puede ver en Booking.com.

Preguntas frecuentes

¿Existe un servidor MCP oficial de Booking.com?

Booking.com no publica ninguno. Este está mantenido por HasData y lee páginas públicas, por eso no necesita ninguna cuenta de Booking.com.

¿Qué es un servidor MCP de Booking.com?

Un servidor que expone los datos de Booking.com como herramientas que un cliente de IA puede llamar. El cliente envía una llamada a herramienta a través del Model Context Protocol, el servidor obtiene los datos y devuelve JSON estructurado, y el modelo trabaja con el resultado. Este expone dos herramientas y se ejecuta de forma remota.

¿Necesito una cuenta de Booking.com o la aprobación de socio?

No. La única credencial es tu clave de HasData. No hay ningún proceso de incorporación de socios, porque las herramientas leen páginas públicas de Booking.com.

¿Por qué la herramienta de alojamientos necesita fechas?

Porque la disponibilidad, las opciones de habitación y el precio dependen de la ventana de estancia. Pasa las mismas checkInDate, checkOutDate y los mismos números de huéspedes que usaste en la búsqueda, y el detalle reflejará esa ventana.

¿Cuál es la diferencia entre la calificación y la puntuación de las reseñas?

rating es la calificación oficial por estrellas del alojamiento. reviews.score es la puntuación de las reseñas de los huéspedes sobre 10. Un hotel de tres estrellas puede tener una puntuación de huéspedes de 9,0, así que consulta la que quieras indicar.

¿Puedo usar esto junto con otras APIs de HasData?

Sí. El parámetro apis acepta una lista, y ?apis=booking,airbnb le da a tu agente Booking.com y Airbnb. Omite el parámetro y lo tendrás todo.

¿Está HasData afiliada a Booking.com?

No. HasData es un servicio independiente y no está afiliado a Booking.com, ni cuenta con su respaldo o patrocinio. Booking.com es una marca comercial de su respectivo propietario.

Cumplimiento y datos personales

HasData solo accede a datos disponibles públicamente. Los términos de una plataforma pueden restringir el acceso automatizado, y tú eres responsable de tu propio cumplimiento. Cuando los datos que recopiles incluyan información personal, asegúrate de tener una base legal para ello en virtud del GDPR, la CCPA o las normas equivalentes de tu jurisdicción.

Enlaces de HasData

Desarrollo

Este repositorio es configuración y documentación para un servidor remoto. No hay paso de compilación ni nada que contenerizar.

Las pruebas en test/ verifican el contrato de las herramientas, la parte que puede romperse sin un commit aquí. Comprueban que ?apis=booking devuelve exactamente dos herramientas, que cada herramienta sigue declarando sus parámetros obligatorios, que ningún nombre ha cambiado y que la clave en uso es realmente aceptada. Esa última comprobación llama a una herramienta de verdad y cuesta 10 créditos, que es el precio de un canario que puede fallar por el motivo correcto.

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

La misma suite se ejecuta en CI en cada push y una vez por semana de forma programada, porque la lista de herramientas upstream puede cambiar sin que nadie toque este repositorio. Un fallo significa que la lista de herramientas se ha movido, que la clave ha dejado de funcionar o que el endpoint no era accesible, y el mensaje de aserción indica cuál de ellos.

Contribuciones

Las correcciones de las tablas de herramientas y de las muestras de respuesta son la contribución más útil, porque son las partes que más se desactualizan. Incluye la llamada que hiciste y la respuesta que obtuviste. Las pull requests de forks ejecutan la suite sin clave, y las comprobaciones en vivo se omiten en lugar de ponerse en rojo.

Licencia

MIT. Ver LICENSE.