ScoutingAPI — conectar el servidor MCP
ScoutingAPI incluye un servidor Model Context Protocol nativo para que un agente pueda consultar datos de alojamiento en Airbnb, Booking.com, Vrbo y Google Hotels como herramientas de primera clase — sin necesidad de pegar una clave API en el agente.
- URL del servidor: https://mcp.scoutingapi.com (transporte HTTP Streamable).
- Autenticación: OAuth 2.1 + PKCE (S256) con registro dinámico de cliente. Autorizas una vez en una ventana emergente del navegador; el conector se vincula a tu cuenta de ScoutingAPI y su saldo de créditos.
- Metadatos de recurso protegido OAuth (RFC 9728): https://mcp.scoutingapi.com/.well-known/oauth-protected-resource
Conectar (Claude.ai / Claude Desktop / Claude Code)
- Abre la configuración de conectores de tu agente y agrega un conector personalizado (servidor MCP).
- Usa la URL
https://mcp.scoutingapi.com. - Completa el mensaje de OAuth en la ventana emergente del navegador — esto vincula el conector a tu cuenta de ScoutingAPI. (Usuarios nuevos: crea una cuenta y verifica el correo electrónico primero; una cuenta sandbox funciona para evaluación. Consulta https://scoutingapi.com/docs/mcp.)
- Las siete herramientas a continuación estarán disponibles para el agente.
Las siete herramientas de solo lectura
search_stays— busca estancias en todas las plataformas por ubicación, fechas, ocupación, filtros.check_availability— disponibilidad día a día para un listado conocido en un período de fechas.get_listing— detalle completo de un listado (servicios, fotos, anfitrión, calificaciones).get_price— una cotización de precio real para un listado en fechas y ocupación específicas.compare_prices— compara una propiedad entre OTAs con mínimo y mediana calculados.get_reviews— reseñas normalizadas y paginadas de un listado en una plataforma.get_job— consulta el estado y obtén los resultados de un trabajo de raspado asíncrono (cuesta 0).
Comportamiento asíncrono
Las herramientas comparten el mismo contrato asíncrono que REST: una llamada en vivo que debe raspar devuelve
un trabajo pendiente; el agente (o la capa de herramientas) consulta get_job con el jobId devuelto
hasta que se complete, y la carga útil del resultado llega bajo data.result. Los aciertos de sandbox y
caché devuelven resultados inmediatamente.
Créditos y límites
Las llamadas MCP se descuentan del mismo saldo único de créditos que tus claves REST, pero tienen límites de tasa en un cubo separado por usuario. Costos y límites de tasa: https://scoutingapi.com/pricing.
MCP vs REST — cuál usar
- MCP — mejor para agentes/asistentes interactivos (ej. Claude) que soportan conectores: OAuth en lugar de gestión de claves, herramientas expuestas de forma nativa al modelo.
- REST (habilidad: scoutingapi-search) — mejor para backends programáticos, servidores, trabajos
cron y cualquier entorno sin soporte MCP: una clave Bearer + el
@scoutingapi/sdk.
Ambos acceden a los mismos datos y al mismo esquema unificado. Documentación: https://scoutingapi.com/docs/mcp.