Skip to main content
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:

{
  "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 Code (one-liner)
claude mcp add verychic -- uvx verychic-mcp
Cursor~/.cursor/mcp.json
{
  "mcpServers": {
    "verychic": {
      "command": "uvx",
      "args": ["verychic-mcp"]
    }
  }
}
VS Code.vscode/mcp.json (note the servers key)
{
  "servers": {
    "verychic": {
      "command": "uvx",
      "args": ["verychic-mcp"]
    }
  }
}
Windsurf~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "verychic": {
      "command": "uvx",
      "args": ["verychic-mcp"]
    }
  }
}

Tools

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_offers

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

Parameter Type Required Description
destination string no Substring matched against the offer's destination or name, ignoring case and accents (crete finds Crète).
country string no Exact country match, ignoring case and accents ("Espagne", "Grece" finds Grèce).
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_details

Returns 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.

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."
  • "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):

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

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:

{
  "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

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.


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.

Release files for verychic-mcp 0.3.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for verychic-mcp 0.3.0
File Size Uploaded
verychic_mcp-0.3.0.tar.gz 5.5 MB Details

Built distribution (wheel)

Table of built distributions (wheels) for verychic-mcp 0.3.0
File Interpreter ABI Platform
verychic_mcp-0.3.0-py3-none-any.whl Python 3 none any Details

Total release size: 5.5 MB

Release files / verychic_mcp-0.3.0.tar.gz

Download URL verychic_mcp-0.3.0.tar.gz
Size 5.5 MB
Tags Source
SHA-256 checksum
How to use checksums
633389e9786260c9ab2ff0f0ebd1857b3db107f1aceb013f867c2f05ea0c0ab9
BLAKE2b-256 checksum
How to use checksums
8ceff6fec2c25445ed011d8ccd8157b5211d02f03e0b7571a4d3e99ebd527187
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.

Transparency log

Release files / verychic_mcp-0.3.0-py3-none-any.whl

Download URL verychic_mcp-0.3.0-py3-none-any.whl
Size 29.6 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5f4c231a11ade9591d5173c5945f1d1c023009645c07d16c64cb3f45cc9bde3a
BLAKE2b-256 checksum
How to use checksums
0b4cb9161a207c204c5404bbc28429cd3a92459870040a0480cf68b5558c16d0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Sep 21, 2026.

Transparency log

Release history Release notifications | RSS feed

0.4.0

2 release files

This release

0.3.0 This release

2 release files

0.2.1

2 release files

0.2.0

2 release files

0.1.9

2 release files

0.1.8

2 release files

0.1.7

2 release files

0.1.6

2 release files

0.1.5

2 release files

0.1.4

2 release files

0.1.3

2 release files

0.1.2

2 release files

0.1.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page