VeryChic Hotel Deals

io.github.jordantetePublished by GitHub account jordantetev0.4.1Updated Oct 26, 2026

Unofficial read-only MCP server for VeryChic hotel offers

VerifiedStreamable HTTPWeb executableLocation & LifestyleWeb Search & Scraping

Overview

AI-generated overview

Unofficial read-only MCP server that lets an assistant search VeryChic flash-sale hotel and package offers and read their dated prices.

What you can do
Search and filter current VeryChic offers by destination, country, price, discount, stars, flights, theme or proximity, with optional sorting and a result limit. Read one offer's full content, gallery, advantages and review grades. Look up per-month and day-by-day availability and prices for a hotel offer, optionally for chosen months.
When to use it
Useful when someone wants to browse or compare VeryChic hotel deals — by place, budget, discount, star rating or distance — and check what specific dates cost, without booking anything.
Requirements
Runs as a local process via uvx (needs uv installed) over stdio, or as a remote streamable-http endpoint; a public instance is offered but is best-effort and may be paused or rate-limited. No account, API key or credentials are needed. Network access to VeryChic's public API is required.
Before you install
Read-only and anonymous: it does not book, log in or use credentials. It replays VeryChic's public web API calls, so availability and prices may change and are not a booking guarantee. The project is unaffiliated with VeryChic and asks for personal, low-volume use only, with no bulk extraction or redistribution of data; users are responsible for complying with VeryChic's terms.

Installation

In SourceWeft

  1. Open VeryChic Hotel Deals in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.jordantete%2Fverychic-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "verychic-hotel-deals": {
      "type": "http",
      "url": "https://verychic-mcp.fly.dev/mcp"
    }
  }
}

README

[VeryChic MCP]

VeryChic MCP

Find, filter, and price VeryChic hotel deals from any MCP client

Browse current flash-sale offers, filter them by destination, country, price, discount, stars, flights, theme, or proximity (and sort the results), then read an offer's availability and prices by date. Read-only, anonymous, no account needed.


[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]


Read-only and anonymous. This server only searches and reads offers — it never books, never logs in, and uses no credentials. A conservative rate limit (≥ 1 s between requests) is built into the client. See the disclaimer for terms of use.

Demo

Adding the hosted VeryChic MCP server to Claude Desktop as a custom connector, then asking for Spain deals under €600:

[Adding VeryChic MCP to Claude Desktop as a custom connector]

▶ Watch it as MP4

Quick start

Add the server to your MCP client config. With uv installed, there is nothing to clone or install:

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

This runs the server over stdio, which is what Claude Desktop and Claude Code use. You can also run it directly:

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

The same command/args pair works in every stdio client; only the wrapping config differs. These configs are for local clients (stdio). For cloud clients like claude.ai or Cowork, which connect over HTTPS instead, see Use from Claude.ai or Cowork.

Claude Code (one-liner)
bash
claude mcp add verychic -- uvx verychic-mcp
Cursor — ~/.cursor/mcp.json
json
{  "mcpServers": {    "verychic": {      "command": "uvx",      "args": ["verychic-mcp"]    }  }}
VS Code — .vscode/mcp.json (note the servers key)
json
{  "servers": {    "verychic": {      "command": "uvx",      "args": ["verychic-mcp"]    }  }}
Windsurf — ~/.codeium/windsurf/mcp_config.json
json
{  "mcpServers": {    "verychic": {      "command": "uvx",      "args": ["verychic-mcp"]    }  }}

Tools

ToolWhat it returns
verychic_search_offersOffers filtered by destination, country, max_price, min_discount, min_stars, flights_included, theme, or proximity (near_lat/near_lng/radius_km), with optional sort_by.
verychic_offer_detailsOne offer's content (advantages, gallery) plus its availability and prices by date.

Every call is read-only and anonymous, with a conservative rate limit built into the client.

verychic_search_offers

Returns the offers matching every filter you pass (filters are combined with AND).

ParameterTypeRequiredDescription
destinationstringnoSubstring matched against the offer's destination or name, ignoring case and accents (crete finds Crète).
countrystringnoExact country match, ignoring case and accents ("Espagne", "Grece" finds Grèce).
max_pricenumbernoKeep only offers priced at or below this value (EUR).
min_discountnumbernoKeep only offers with at least this discount percentage (e.g. 40).
min_starsintegernoKeep only offers with at least this hotel star rating (1–5).
flights_includedbooleannotrue keeps flight-bearing offers, false keeps hotel-only offers.
themestring (enum)noKeep only offers matching a curated theme decoded from the catalogue's thematics tags. One of: adults_only, city_break, cruise, island, last_minute, luxury, mountain, nature, pool, romantic, rooftop, spa, sun, villa.
near_lat / near_lngnumbernoLatitude/longitude of a search center (decimal degrees), given together, to compute each offer's distance_km.
radius_kmnumbernoKeep only offers within this many km of near_lat/near_lng (requires both).
sort_bystring (enum)noOrder results: discount, price, rating, stars, or distance (nearest first, requires a center).
limitintegernoMax number of offers to return. Defaults to 20.

verychic_offer_details

Returns one offer's full content plus, for hotels, its day-by-day availability and prices.

ParameterTypeRequiredDescription
sourcestringyesORCHESTRA for a hotel, ORCHESTRA_TO for a tour-operator package.
external_idintegeryesThe offer's id, as returned by verychic_search_offers.
monthsarray of stringsnoMonths to look up availability for, each written MM/YYYY (e.g. ["01/2027", "02/2027"]). Defaults to roughly the next 5 months.

Examples

Ask your assistant things like:

  • "Browse the current VeryChic deals."
  • "Search VeryChic offers in Spain under 600 euros."
  • "Find 5-star spa hotels with at least 40% off, cheapest first."
  • "Show VeryChic offers within 300 km of Paris (48.8566, 2.3522), nearest first."
  • "Get the details and dated prices for the ORCHESTRA hotel offer 44983."
  • "What does that hotel cost in February and March 2027?" The assistant passes months: ["02/2027", "03/2027"] to look beyond the default window.
  • "Which month is cheapest for this hotel?" availabilities_by_month answers it directly — one row per month with stock, so a wide months window stays cheap to read.
  • "Get the details for the ORCHESTRA_TO package offer 301375." Tour-operator packages bundle flights with the hotel, so they do not expose day-by-day prices the way a single hotel does. The tool still returns the offer content and advantages, and sets availabilities_supported: false so an empty availabilities reads as "not supported for this offer type", not "no dates available".

Offers carry a source (ORCHESTRA for a hotel, ORCHESTRA_TO for a package) and an external_id. Both come back from verychic_search_offers, so the assistant can pass them to verychic_offer_details on its own.

A verychic_search_offers result is a list of offer objects (one shown here, trimmed):

jsonc
{  "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 adds gallery, included_added_values, a cheapest_price, the guest review grades, a per-month price rollup, and the day-by-day availabilities for a hotel:

jsonc
{  "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 }  ]}

Use from Claude.ai or Cowork

Unlike the local clients in Quick start, cloud clients such as claude.ai and Cowork only connect to remote MCP servers over HTTPS, not to a local process. To use VeryChic MCP there, host it yourself in streamable-http mode (verychic-mcp --transport streamable-http, behind HTTPS) and add it as a custom connector, pasting your deployment URL with the /mcp path.

A public instance is deployed for convenience at https://verychic-mcp.fly.dev/mcp. Add it as a custom connector in claude.ai/Cowork, or wire it into a local client that speaks remote MCP:

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

It is best-effort and may be paused or rate-limited at any time — for anything beyond a quick try, run your own instance with the uvx command above or host the streamable-http mode.

Listing in Anthropic's official connector directory (next to Booking or Tripadvisor) is out of scope. That directory is reserved for partner integrations that pass a review this kind of tool would not.


How it works

The VeryChic web app talks to a public JSON API under https://api.verychic.com/verychic-endpoints/v1 (plus search.verychic.com). This server replays those same calls with a browser-like TLS fingerprint (curl_cffi), parses the responses into typed objects, and exposes them as MCP tools. Everything works without logging in. The one volatile request parameter, channelVersion, is read from the live site at startup and falls back to a known value if that read fails.


Development

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

Releases are tag-driven. Pushing a vX.Y.Z tag runs the tests, builds the package, and publishes it to PyPI through GitHub Actions with trusted publishing, so no token is stored anywhere.


Disclaimer

VeryChic MCP is not affiliated with, endorsed by, or connected to VeryChic or VeryChic SAS. It is an independent community tool for personal use that reads VeryChic's public web API the same way a browser does. You are responsible for complying with VeryChic's terms of sale, notably Article 9 on intellectual property and the database producer's sui generis right. Use it at your own risk, for personal and low-volume browsing only. Do not use it for bulk extraction or redistribution of VeryChic's data.

License

MIT. See LICENSE.

Source: README.md at commit 846379b

Tools

2

verychic_search_offers

Search & filter VeryChic offers

Search and filter the current VeryChic offers by destination, country, price, discount, stars, flights, theme, or proximity — with optional sorting. When to use: when you already know roughly what the user wants — a place, a country, a budget, a minimum discount or star rating, flights vs hotel-only, a theme (e.g. pool, spa, romantic, last_minute), or hotels near a point (near_lat/near_lng, with an optional radius_km). To inspect one specific offer in depth use `verychic_offer_details`. All filters are optional and combine with AND; call it with no filter to browse the full current catalogue in catalogue order. Behaviour: read-only and anonymous; rate-limited to about 1 request per second. Filtering is done client-side over the live catalogue: `destination` is a substring (matched on destination or name), `country` is an exact match — both ignore case and accents, so 'grece' matches the catalogue's 'Grèce' — `max_price`/`min_discount`/`min_stars` are numeric bounds, `flights_included` toggles flight-bearing vs hotel-only, and `theme` matches a curated label decoded from the catalogue's thematics tags. Use `sort_by` to order results (`discount`, `price`, `rating`, `stars`, or `distance`). Prices are in EUR and text is in French; there is no pagination. Returns the first `limit` matches after filtering and sorting. "Current" means live offers at call time; the catalogue changes over time. Returns a list of offer objects (same `source` + `external_id` pair for use with `verychic_offer_details`). Each offer also carries `discount` (percent off, may be null), `stars` (1-5, may be null), `price_label` (human-readable price unit, e.g. "à partir de par pers. pour 3 nuits" vs "par chambre" — read this before comparing prices), `price_with_flights` (EUR, null when not applicable), `flights_included`

Parameterslimitthemecountrysort_bynear_latnear_lngmax_pricemin_starsradius_kmdestinationmin_discountflights_included

verychic_offer_details

Get VeryChic offer details & availability

Get full details plus per-date availability and prices for one specific VeryChic offer. When to use: after `verychic_search_offers` returned an offer you want to inspect — pass that offer's `source` and `external_id` here. You must obtain those two identifiers from a search result first; this tool does not search. Behaviour: read-only and anonymous; rate-limited to about 1 request per second; prices in EUR, text in French. Availability is looked up for roughly the next 5 months unless `months` names the window to query. For tour-operator packages (`source` = 'ORCHESTRA_TO') VeryChic exposes no date-availability endpoint: `availabilities` is then empty and `availabilities_supported` is false — meaning "not supported", NOT "sold out". Returns an object with: `offer` (same fields as a search result, plus `offer_url`), `advantages`, `included_added_values`, `non_included_added_values`, `gallery` (image URLs), `availabilities` (one entry per check-in date with `date`, `price`, `currency`, `nights`, `days`, `departure_city_code`), `availabilities_by_month` (one row per month with stock — `month` as 'MM/YYYY', `min_price`, `currency` and `dates_available` — in chronological order), `availabilities_supported` (bool), and `cheapest_price` (lowest available price, or null when none). To answer "which month is cheapest", read `availabilities_by_month` rather than scanning `availabilities`: it carries the same answer in a fraction of the size, and it stays small when `months` asks for a wide window.

Parametersmonthssourcerequiredexternal_idrequired

Version history

3
  1. v0.4.1LatestOct 26, 2026
  2. v0.4.0Sep 22, 2026
  3. v0.1.3Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts