verychic-mcp 0.1.1

Unofficial read-only MCP server for VeryChic hotel offers

VeryChic MCP

Search VeryChic hotel deals from any MCP client

Browse current flash-sale offers, filter them by destination or price, and read an offer's availability and prices by date. Read-only, anonymous, no account needed.

---

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

---

Tools

Tool	What it returns
verychic_list_deals	The current VeryChic offers, with a configurable limit.
verychic_search_offers	Offers filtered by destination (substring match), country (exact match), and max_price.
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.

---

Examples

Ask your assistant things like:

• "List the current VeryChic deals."
• "Search VeryChic offers in Spain under 600 euros."
• "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.

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

---

Use from Claude.ai or Cowork

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.

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.