Outsite Availability MCP

Un servidor MCP no oficial y de solo lectura para investigar ubicaciones públicas de Outsite, tarifas de estancia cotizadas y calendarios individuales de habitaciones.

Repositorio: kristianeboe/outsite-mcp

Este proyecto utiliza el sitio web público de Outsite y las mismas lecturas anónimas de GraphQL que usa su interfaz de reservas. No reenvía cookies del navegador, no accede a cuentas de Outsite, no reserva habitaciones ni realiza pagos. Outsite no ha respaldado este proyecto, y su contrato privado de GraphQL puede cambiar sin previo aviso.

Herramientas

• find_outsite_locations: resuelve una ciudad, país, vecindario o nombre de casa a un slug de Outsite.

• search_outsite_stays: devuelve combinaciones actuales de habitación/tarifa para fechas exactas.

• get_outsite_room_calendar: inspecciona un tipo de habitación específico en un rango de fechas más amplio e identifica períodos abiertos contiguos.

Todas las herramientas son de solo lectura e incluyen una URL de origen y una marca de tiempo fetchedAt.

Desarrollo local

Requiere Node.js 22.22.2 o superior y pnpm.

pnpm install --ignore-workspace
pnpm dev

El endpoint MCP está disponible en http://localhost:3000/mcp. El Inspector del framework está disponible desde el servidor de desarrollo local.

Comprobaciones

pnpm typecheck
pnpm test
RUN_LIVE=1 pnpm test
pnpm build

La prueba en vivo realiza solicitudes anónimas a Outsite y confirma el descubrimiento de ubicaciones, la búsqueda de tarifas y un calendario de habitaciones.

Configuración

Los valores predeterminados son adecuados para el despliegue. Variables de entorno opcionales:

• OUTSITE_GRAPHQL_URL: por defecto https://api.outsite.co/graphql.

• OUTSITE_CACHE_TTL_MS: duración de la caché anónima ascendente, por defecto 300000.

• OUTSITE_TIMEOUT_MS: tiempo de espera de solicitud ascendente, por defecto 12000.

Despliegue

Manufact Cloud es el host canónico. El endpoint público previsto es:

https://outsite-mcp.kristianeboe.me/mcp

Despliega desde el repositorio de GitHub conectado o ejecuta pnpm deploy. Vuelve a ejecutar la prueba de humo en vivo y el Inspector MCP contra el endpoint de producción después de cada cambio en el contrato de herramientas.

Límites

• Mantén la superficie pública anónima y de solo lectura.

• Nunca aceptes, almacenes ni reenvíes cookies de sesión o tokens de cuenta de Outsite.

• No agregues reservas, pagos, cambios de reserva u otras mutaciones.

• Trata las etiquetas de tarifa de miembro devueltas como descubrimiento público de precios, no como prueba de derecho de membresía.

• Preserva los totales de tarifas brutas y las marcas de tiempo. No prometas disponibilidad.

Documentación utilizada

• OpenAI: Construir un servidor MCP

• OpenAI: Definir herramientas

• Inicio rápido de Manufact TypeScript

Licencia

MIT