VeryChic Hotel Deals
Unofficial read-only MCP server for VeryChic hotel offers
Open source Repository Open in the app JSON README (API)
About
Unofficial read-only MCP server for VeryChic hotel offers
Details
- Kind
- MCP servers
- Topic
- Maps, weather & travel
- Publisher
- jordantete
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.1.3
- Stars
- 1
- Last push
- 2026-08-24T12:23:17Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 04:00:17
- Updated
- 2026-08-29 04:00:17
- Origin id
io.github.jordantete/verychic-mcp
README
<!-- mcp-name: io.github.jordantete/verychic-mcp -->
<div align="center">
<img src="https://raw.githubusercontent.com/jordantete/verychic-mcp/main/assets/logo.png" alt="VeryChic MCP" width="96" height="96" />
# 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.
<br>
[](https://pypi.org/project/verychic-mcp/)
[](https://opensource.org/licenses/MIT)
[](https://github.com/jordantete/verychic-mcp/actions/workflows/release.yml)
[](https://www.python.org/)
[](https://modelcontextprotocol.io)
[](https://smithery.ai/servers/tetej171/verychic-mcp)
[](https://glama.ai/mcp/servers/jordantete/verychic-mcp)
[](https://codeguilds.dev/packages/verychic-mcp)
<br>
[](https://verychic-mcp.fly.dev/)
<br>
[](https://cursor.com/install-mcp?name=verychic&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJ2ZXJ5Y2hpYy1tY3AiXX0=)
[](https://insiders.vscode.dev/redirect/mcp/install?name=verychic&config=%7B%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22verychic-mcp%22%5D%7D)
</div>
---
> **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](#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:
▶ [Watch it as MP4](assets/connect-claude-desktop.mp4)
## Quick start
Add the server to your MCP client config. With [`uv`](https://docs.astral.sh/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](#use-from-claudeai-or-cowork).
<details>
<summary><b>Claude Code</b> (one-liner)</summary>
```bash
claude mcp add verychic -- uvx verychic-mcp
```
</details>
<details>
<summary><b>Cursor</b> — <code>~/.cursor/mcp.json</code></summary>
```json
{
"mcpServers": {
"verychic": {
"command": "uvx",
"args": ["verychic-mcp"]
}
}
}
```
</details>
<details>
<summary><b>VS Code</b> — <code>.vscode/mcp.json</code> (note the <code>servers</code> key)</summary>
```json
{
"servers": {
"verychic": {
"command": "uvx",
"args": ["verychic-mcp"]
}
}
}
```
</details>
<details>
<summary><b>Windsurf</b> — <code>~/.codeium/windsurf/mcp_config.json</code></summary>
```json
{
"mcpServers": {
"verychic": {
"command": "uvx",
"args": ["verychic-mcp"]
}
}
}
```
</details>
---
## 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 | 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_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):
```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`, and the
day-by-day `availabilities` for a hotel:
```jsonc
{
"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](#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-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](https://docs.pypi.org/trusted-publishers/),
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](LICENSE).