VeryChic MCP

Servidor MCP de solo lectura y anónimo para ofertas flash de hoteles de VeryChic, buscar y filtrar ofertas, y consultar disponibilidad y precios por fecha. Se ejecuta mediante uvx, sin necesidad de cuenta.

Documentación

VeryChic MCP

VeryChic MCP

Encuentra, filtra y consulta precios de ofertas de hoteles VeryChic desde cualquier cliente MCP

Explora las ofertas flash actuales, fíltralas por destino, país, precio, descuento, estrellas, vuelos, temática o proximidad (y ordena los resultados), luego consulta la disponibilidad y los precios de una oferta por fecha. Solo lectura, anónimo, sin necesidad de cuenta.


PyPI version License: MIT Release Python MCP Smithery Glama score Available on CodeGuilds


Open the live landing page


Install in Cursor Install in VS Code


Solo lectura y anónimo. Este servidor únicamente busca y lee ofertas — nunca reserva, nunca inicia sesión y no utiliza credenciales. El cliente incluye un límite de frecuencia conservador (≥ 1 s entre solicitudes). Consulta el aviso legal para conocer las condiciones de uso.

Demo

Añadir el servidor VeryChic MCP alojado a Claude Desktop como conector personalizado y pedir ofertas en España por menos de 600 €:

Adding VeryChic MCP to Claude Desktop as a custom connector

▶ Verlo como MP4

Inicio rápido

Añade el servidor a la configuración de tu cliente MCP. Con uv instalado, no hay nada que clonar ni instalar:

{
  "mcpServers": {
    "verychic": {
      "command": "uvx",
      "args": ["verychic-mcp"]
    }
  }
}

Esto ejecuta el servidor a través de stdio, que es lo que usan Claude Desktop y Claude Code. También puedes ejecutarlo directamente:

uvx verychic-mcp          # stdio (default)
uvx verychic-mcp --help   # all options

El mismo par command/args funciona en cualquier cliente stdio; solo cambia la configuración de envoltura. Estas configuraciones son para clientes locales (stdio). Para clientes en la nube como claude.ai o Cowork, que se conectan a través de HTTPS, consulta Uso desde Claude.ai o Cowork.

Claude Code (una línea)
claude mcp add verychic -- uvx verychic-mcp
Cursor — ~/.cursor/mcp.json
{
  "mcpServers": {
    "verychic": {
      "command": "uvx",
      "args": ["verychic-mcp"]
    }
  }
}
VS Code — .vscode/mcp.json (nota la clave servers)
{
  "servers": {
    "verychic": {
      "command": "uvx",
      "args": ["verychic-mcp"]
    }
  }
}
Windsurf — ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "verychic": {
      "command": "uvx",
      "args": ["verychic-mcp"]
    }
  }
}

Herramientas

HerramientaQué devuelve
verychic_search_offersOfertas filtradas por destination, country, max_price, min_discount, min_stars, flights_included, theme o proximidad (near_lat/near_lng/radius_km), con sort_by opcional.
verychic_offer_detailsEl contenido de una oferta (ventajas, galería) además de su disponibilidad y precios por fecha.

Cada llamada es de solo lectura y anónima, con un límite de frecuencia conservador integrado en el cliente.

verychic_search_offers

Devuelve las ofertas que coinciden con cada filtro que pases (los filtros se combinan con AND).

ParámetroTipoObligatorioDescripción
destinationstringnoSubcadena que se compara con el destino o el nombre de la oferta, ignorando mayúsculas/minúsculas y acentos (crete encuentra Crète).
countrystringnoCoincidencia exacta de país, ignorando mayúsculas/minúsculas y acentos ("Espagne", "Grece" encuentra Grèce).
max_pricenumbernoConserva solo ofertas con un precio igual o inferior a este valor (EUR).
min_discountnumbernoConserva solo ofertas con al menos este porcentaje de descuento (p. ej. 40).
min_starsintegernoConserva solo ofertas con al menos esta calificación de estrellas del hotel (1–5).
flights_includedbooleannotrue conserva ofertas con vuelos, false conserva ofertas solo de hotel.
themestring (enum)noConserva solo ofertas que coincidan con una temática seleccionada decodificada de las etiquetas temáticas del catálogo. Una de: adults_only, city_break, cruise, island, last_minute, luxury, mountain, nature, pool, romantic, rooftop, spa, sun, villa.
near_lat / near_lngnumbernoLatitud/longitud de un centro de búsqueda (grados decimales), dados juntos, para calcular el distance_km de cada oferta.
radius_kmnumbernoConserva solo ofertas dentro de esta cantidad de km de near_lat/near_lng (requiere ambos).
sort_bystring (enum)noOrdena los resultados: discount, price, rating, stars o distance (los más cercanos primero, requiere un centro).
limitintegernoNúmero máximo de ofertas a devolver. El valor predeterminado es 20.

verychic_offer_details

Devuelve el contenido completo de una oferta y, para hoteles, su disponibilidad y precios día a día.

ParámetroTipoObligatorioDescripción
sourcestringsíORCHESTRA para un hotel, ORCHESTRA_TO para un paquete de operador turístico.
external_idintegersíEl id de la oferta, tal como lo devuelve verychic_search_offers.
monthsarray de stringsnoMeses para consultar la disponibilidad, cada uno escrito MM/YYYY (p. ej. ["01/2027", "02/2027"]). El valor predeterminado son aproximadamente los próximos 5 meses.

Ejemplos

Pídele a tu asistente cosas como:

  • "Explora las ofertas actuales de VeryChic."
  • "Busca ofertas de VeryChic en España por menos de 600 euros."
  • "Encuentra hoteles spa de 5 estrellas con al menos un 40 % de descuento, primero los más baratos."
  • "Muestra ofertas de VeryChic a menos de 300 km de París (48.8566, 2.3522), primero las más cercanas."
  • "Obtén los detalles y precios por fecha de la oferta de hotel ORCHESTRA 44983."
  • "¿Cuánto cuesta ese hotel en febrero y marzo de 2027?" El asistente pasa months: ["02/2027", "03/2027"] para mirar más allá de la ventana predeterminada.
  • "¿Qué mes es el más barato para este hotel?" availabilities_by_month lo responde directamente: una fila por mes con stock, por lo que una ventana amplia de months sigue siendo económica de leer.
  • "Obtén los detalles del paquete ORCHESTRA_TO 301375." Los paquetes de operador turístico incluyen vuelos con el hotel, por lo que no exponen precios día a día como un hotel individual. La herramienta sigue devolviendo el contenido y las ventajas de la oferta, y establece availabilities_supported: false para que un availabilities vacío se lea como "no compatible con este tipo de oferta", no como "no hay fechas disponibles".

Las ofertas llevan un source (ORCHESTRA para un hotel, ORCHESTRA_TO para un paquete) y un external_id. Ambos se devuelven desde verychic_search_offers, por lo que el asistente puede pasarlos a verychic_offer_details por su cuenta.

Un resultado de verychic_search_offers es una lista de objetos de oferta (aquí se muestra uno, recortado):

{
  "source": "ORCHESTRA",
  "external_id": 36509,
  "name": "Sofitel New York ****",
  "destination": "New York, États-Unis",
  "country": "États-Unis",
  "price": 182,
  "currency": "EUR",
  "discount": 57.0,
  "sales_mode": "FLASH",
  "offer_end_date": "2026-06-24T23:55+0200",
  "image": "https://.../sofitel-new-york.jpg",
  "advantages": ["Petit-déjeuner inclus", "VeryFlexible : réservez en toute sérénité !"],
  "offer_url": "https://www.verychic.fr/p/36509/etats-unis-new-york-hotel-sofitel-new-york"
}

verychic_offer_details añade gallery, included_added_values, un cheapest_price, las calificaciones de reseñas de huéspedes, un resumen de precios por mes y el availabilities día a día para un hotel:

{
  "offer": {
    "source": "ORCHESTRA", "external_id": 44983, "name": "Hotel Kaktus Playa *****",
    "rating": 8.5, "opinion_count": 67,
    "rating_location": 8.1, "rating_room": 9.2, "rating_service": 8.9,
    "rating_food": 9.1, "rating_public_area": 9.1,
    "...": "..."
  },
  "cheapest_price": 169,
  "availabilities_supported": true,
  "availabilities_by_month": [
    { "month": "06/2026", "min_price": 169, "currency": "EUR", "dates_available": 5 }
  ],
  "availabilities": [
    { "date": "20/06/2026", "price": 169, "currency": "EUR", "nights": 1, "days": 2 },
    { "date": "21/06/2026", "price": 169, "currency": "EUR", "nights": 1, "days": 2 }
  ]
}

Uso desde Claude.ai o Cowork

A diferencia de los clientes locales en Inicio rápido, los clientes en la nube como claude.ai y Cowork solo se conectan a servidores MCP remotos a través de HTTPS, no a un proceso local. Para usar VeryChic MCP allí, alójalo tú mismo en modo streamable-http (verychic-mcp --transport streamable-http, detrás de HTTPS) y añádelo como conector personalizado, pegando la URL de tu despliegue con la ruta /mcp.

Hay una instancia pública desplegada por conveniencia en https://verychic-mcp.fly.dev/mcp. Añádela como conector personalizado en claude.ai/Cowork, o conéctala a un cliente local que hable MCP remoto:

{
  "mcpServers": {
    "verychic": {
      "url": "https://verychic-mcp.fly.dev/mcp"
    }
  }
}

Es de buena fe y puede pausarse o limitarse en cualquier momento — para algo más que una prueba rápida, ejecuta tu propia instancia con el comando uvx anterior o aloja el modo streamable-http.

El listado en el directorio oficial de conectores de Anthropic (junto a Booking o Tripadvisor) queda fuera del alcance. Ese directorio está reservado para integraciones de socios que superen una revisión que este tipo de herramienta no superaría.


Cómo funciona

La aplicación web de VeryChic habla con una API JSON pública bajo https://api.verychic.com/verychic-endpoints/v1 (además de search.verychic.com). Este servidor reproduce esas mismas llamadas con una huella TLS similar a la de un navegador (curl_cffi), analiza las respuestas en objetos tipados y las expone como herramientas MCP. Todo funciona sin iniciar sesión. El único parámetro de solicitud volátil, channelVersion, se lee del sitio en vivo al inicio y recurre a un valor conocido si esa lectura falla.


Desarrollo

git clone https://github.com/jordantete/verychic-mcp.git && cd verychic-mcp
pip install -e ".[dev]"
pytest                  # offline tests, run against recorded fixtures
pytest -m network       # optional smoke test against the live API, low volume
ruff check verychic_mcp tests

Los lanzamientos se gestionan mediante etiquetas. Enviar una etiqueta vX.Y.Z ejecuta las pruebas, compila el paquete y lo publica en PyPI a través de GitHub Actions con publicación de confianza, por lo que no se almacena ningún token en ningún lugar.


Aviso legal

VeryChic MCP no está afiliado, respaldado ni conectado a VeryChic o VeryChic SAS. Es una herramienta comunitaria independiente para uso personal que lee la API web pública de VeryChic de la misma manera que lo hace un navegador. Eres responsable de cumplir con las condiciones de venta de VeryChic, en particular el Artículo 9 sobre propiedad intelectual y el derecho sui generis del productor de la base de datos. Úsalo bajo tu propio riesgo, solo para navegación personal y de bajo volumen. No lo uses para extracción masiva o redistribución de los datos de VeryChic.

Licencia

MIT. Consulta LICENCIA.