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
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.
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 €:

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
| Herramienta | Qué devuelve |
|---|---|
verychic_search_offers | Ofertas 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_details | El 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ámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
destination | string | no | Subcadena que se compara con el destino o el nombre de la oferta, ignorando mayúsculas/minúsculas y acentos (crete encuentra Crète). |
country | string | no | Coincidencia exacta de país, ignorando mayúsculas/minúsculas y acentos ("Espagne", "Grece" encuentra Grèce). |
max_price | number | no | Conserva solo ofertas con un precio igual o inferior a este valor (EUR). |
min_discount | number | no | Conserva solo ofertas con al menos este porcentaje de descuento (p. ej. 40). |
min_stars | integer | no | Conserva solo ofertas con al menos esta calificación de estrellas del hotel (1–5). |
flights_included | boolean | no | true conserva ofertas con vuelos, false conserva ofertas solo de hotel. |
theme | string (enum) | no | Conserva 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_lng | number | no | Latitud/longitud de un centro de búsqueda (grados decimales), dados juntos, para calcular el distance_km de cada oferta. |
radius_km | number | no | Conserva solo ofertas dentro de esta cantidad de km de near_lat/near_lng (requiere ambos). |
sort_by | string (enum) | no | Ordena los resultados: discount, price, rating, stars o distance (los más cercanos primero, requiere un centro). |
limit | integer | no | Nú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ámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
source | string | sí | ORCHESTRA para un hotel, ORCHESTRA_TO para un paquete de operador turístico. |
external_id | integer | sí | El id de la oferta, tal como lo devuelve verychic_search_offers. |
months | array de strings | no | Meses 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_monthlo responde directamente: una fila por mes con stock, por lo que una ventana amplia demonthssigue 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: falsepara que unavailabilitiesvací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.