Are you the author? Sign in to claim
Unofficial read-only MCP server for VeryChic hotel offers (search, filter, availability & prices)
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.
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.
Adding the hosted VeryChic MCP server to Claude Desktop as a custom connector, then asking for Spain deals under €600:

Add the server to your MCP client config. With uv installed,
there is nothing to clone or install:
{
"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:
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 mcp add verychic -- uvx verychic-mcp
~/.cursor/mcp.json{
"mcpServers": {
"verychic": {
"command": "uvx",
"args": ["verychic-mcp"]
}
}
}
.vscode/mcp.json (note the servers key){
"servers": {
"verychic": {
"command": "uvx",
"args": ["verychic-mcp"]
}
}
}
~/.codeium/windsurf/mcp_config.json{
"mcpServers": {
"verychic": {
"command": "uvx",
"args": ["verychic-mcp"]
}
}
}
| Tool | What it returns |
|---|---|
verychic_search_offers | Offers 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_details | One 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_offersReturns the offers matching every filter you pass (filters are combined with AND).
| Parameter | Type | Required | Description |
|---|---|---|---|
destination | string | no | Case-insensitive substring matched against the offer's destination or name. |
country | string | no | Exact, case-insensitive country match (e.g. "Espagne"). |
max_price | number | no | Keep only offers priced at or below this value (EUR). |
min_discount | number | no | Keep only offers with at least this discount percentage (e.g. 40). |
min_stars | integer | no | Keep only offers with at least this hotel star rating (1–5). |
flights_included | boolean | no | true keeps flight-bearing offers, false keeps hotel-only offers. |
theme | string (enum) | no | Keep 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_lng | number | no | Latitude/longitude of a search center (decimal degrees), given together, to compute each offer's distance_km. |
radius_km | number | no | Keep only offers within this many km of near_lat/near_lng (requires both). |
sort_by | string (enum) | no | Order results: discount, price, rating, stars, or distance (nearest first, requires a center). |
limit | integer | no | Max number of offers to return. Defaults to 20. |
verychic_offer_detailsReturns one offer's full content plus, for hotels, its day-by-day availability and prices.
| Parameter | Type | Required | Description |
|---|---|---|---|
source | string | yes | ORCHESTRA for a hotel, ORCHESTRA_TO for a tour-operator package. |
external_id | integer | yes | The offer's id, as returned by verychic_search_offers. |
Ask your assistant things like:
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):
{
"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, and the
day-by-day availabilities for a hotel:
{
"offer": { "source": "ORCHESTRA", "external_id": 44983, "name": "Hotel Kaktus Playa *****", "...": "..." },
"cheapest_price": 169,
"availabilities_supported": true,
"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 }
]
}
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:
{
"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.
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.
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
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.
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.
MIT. See LICENSE.
Run Claude Code as an MCP server so any agent can delegate coding tasks to it
Browser automation using accessibility snapshots instead of screenshots
Google's universal MCP server supporting PostgreSQL, MySQL, MongoDB, Redis, and 10+ databases
Official GitHub integration for repos, issues, PRs, and CI/CD workflows