verychic-mcp 0.1.0

Unofficial read-only MCP server for VeryChic hotel offers

VeryChic MCP

An unofficial, read-only Model Context Protocol server for VeryChic hotel flash-sale offers. Search current deals, filter them, and get an offer's details with availability and prices by date — straight from your MCP client.

⚠️ Disclaimer. This project is not affiliated with, endorsed by, or connected to VeryChic / VeryChic SAS in any way. It is an independent, community tool for personal use. It accesses VeryChic's public web API the same way a browser does. You are responsible for complying with VeryChic's Terms (Conditions Générales de Vente — notably Art. 9 on intellectual property and the sui generis database right). Use it at your own risk, for personal, low-volume browsing only. Do not use it for bulk extraction or redistribution of VeryChic's data.

What it does

Three tools:

Tool	Description
verychic_list_deals	The current VeryChic offers (limit configurable).
verychic_search_offers	Filter offers by destination (substring), country (exact), and/or max_price.
verychic_offer_details	An offer's content (advantages, gallery) plus availability and prices by date.

All read-only, anonymous (no login), with a built-in conservative rate limit.

Install & use (local — Claude Desktop / Claude Code)

Zero-install with uv. Add this to your MCP client config:

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

That runs the server over stdio. No clone, no manual install.

To run it yourself:

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

Use from Claude.ai / Cowork (remote)

Cloud clients (claude.ai web, Cowork) can only talk to remote MCP servers over HTTPS, so you must self-host the server in streamable-http mode and add it as a custom connector by URL. See DEPLOY.md for a 1-click template. Then, in Claude settings → Connectors → Add custom connector, paste your deployment URL.

Listing in Anthropic's official connector directory (next to Booking/Tripadvisor) is out of scope: it requires a partner review this kind of tool would not pass.

Tool examples

• "List the current VeryChic deals."
• "Search VeryChic offers in Spain under 600 €."
• "Get the details and dated prices for VeryChic offer ORCHESTRA 44983."

Development

git clone https://github.com/jordantete/verychic-mcp.git && cd verychic-mcp
pip install -e ".[dev]"
pytest                 # offline tests (fixtures); excludes the @network smoke test
pytest -m network      # optional: hits the live VeryChic API (low volume)
ruff check verychic_mcp tests

How it works

VeryChic's web front-end calls a public JSON API under https://api.verychic.com/verychic-endpoints/v1 (plus search.verychic.com). This server replays those calls with a browser-like TLS fingerprint (curl_cffi), parses the responses, and exposes them as MCP tools. The volatile channelVersion parameter is auto-discovered from the live site, with a hardcoded fallback.

License

MIT — see LICENSE.