[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_123":124},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":24,"_25":26,"_27":28,"_29":30,"_31":32,"_33":34,"_35":26,"_36":37,"_38":-5,"_39":-5,"_40":41,"_42":43,"_44":45,"_46":47,"_48":49,"_50":51,"_52":53,"_54":55,"_56":-5,"_57":49,"_58":59,"_60":61,"_62":63,"_64":65,"_66":67,"_68":49,"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":-5,"_80":-5,"_81":-5,"_82":49,"_83":-5,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93,"_94":95,"_96":97},"apiUrl","https://odel.app/api","creator","jordantete","moduleId","verychic-mcp","@jordantete/verychic-mcp","displayName","VeryChic Hotel Deals","tagline","Unofficial read-only MCP server for VeryChic hotel offers","iconKey","https://avatars.githubusercontent.com/u/2340374?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://verychic-mcp.fly.dev/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1783340206000,"updatedAt",1788781523000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=io.github.jordantete%2Fverychic-mcp","sourceVerified",true,"sourceMissingSince","importedAt","upstreamStars",1,"upstreamUpdatedAt",1787574197000,"detectedTransport","streamable-http","detectedAuthType","none","probeStatus","ok","lastProbedAt","githubRepoUrl","https://github.com/jordantete/verychic-mcp","githubRepoFullName","jordantete/verychic-mcp","releaseId","ext-jordantete-verychic-mcp","version","0.1.3","descriptionMarkdown","\n\n

\n\n $\"VeryChic$ \n\n# VeryChic MCP\n\n### Find, filter, and price VeryChic hotel deals from any MCP client\n\nBrowse current flash-sale offers, filter them by destination, country, price, discount,\nstars, flights, theme, or proximity (and sort the results), then read an offer's\navailability and prices by date. Read-only, anonymous, no account needed.\n\n
\n\n[![PyPI version](https://img.shields.io/pypi/v/verychic-mcp.svg?style=flat-square)](https://pypi.org/project/verychic-mcp/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=flat-square)](https://opensource.org/licenses/MIT)\n[![Release](https://img.shields.io/github/actions/workflow/status/jordantete/verychic-mcp/release.yml?style=flat-square&label=release)](https://github.com/jordantete/verychic-mcp/actions/workflows/release.yml)\n[![Python](https://img.shields.io/badge/python-%3E%3D3.11-3776AB?style=flat-square&logo=python&logoColor=white)](https://www.python.org/)\n[![MCP](https://img.shields.io/badge/MCP-server-7C3AED?style=flat-square)](https://modelcontextprotocol.io)\n[![Smithery](https://img.shields.io/badge/Smithery-verychic--mcp-1B1B1B?style=flat-square)](https://smithery.ai/servers/tetej171/verychic-mcp)\n[![Glama score](https://glama.ai/mcp/servers/jordantete/verychic-mcp/badges/score.svg)](https://glama.ai/mcp/servers/jordantete/verychic-mcp)\n[![Available on CodeGuilds](https://img.shields.io/badge/Available_on-CodeGuilds-6366f1?style=flat-square)](https://codeguilds.dev/packages/verychic-mcp)\n\n
\n\n[![Open the live landing page](https://img.shields.io/badge/%F0%9F%8C%90_Live_site-verychic--mcp.fly.dev-d8b27a?style=for-the-badge&labelColor=0c0a09)](https://verychic-mcp.fly.dev/)\n\n
\n\n[![Install in Cursor](https://img.shields.io/badge/Cursor-Install_server-000000?style=flat-square&logo=cursor&logoColor=white)](https://cursor.com/install-mcp?name=verychic&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJ2ZXJ5Y2hpYy1tY3AiXX0=)\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_server-0098FF?style=flat-square&logo=visualstudiocode&logoColor=white)](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)\n\n

\n\n---\n\n> **Read-only and anonymous.** This server only *searches and reads* offers — it never books,\n> never logs in, and uses no credentials. A conservative rate limit (≥ 1 s between requests) is\n> built into the client. See the [disclaimer](#disclaimer) for terms of use.\n\n## Demo\n\nAdding the hosted VeryChic MCP server to Claude Desktop as a custom connector, then asking\nfor Spain deals under €600:\n\n![Adding VeryChic MCP to Claude Desktop as a custom connector](https://raw.githubusercontent.com/jordantete/verychic-mcp/main/assets/connect-claude-desktop.gif)\n\n▶ [Watch it as MP4](https://github.com/jordantete/verychic-mcp/blob/main/assets/connect-claude-desktop.mp4)\n\n## Quick start\n\nAdd the server to your MCP client config. With [`uv`](https://docs.astral.sh/uv/) installed,\nthere is nothing to clone or install:\n\n```json\n{\n \"mcpServers\": {\n \"verychic\": {\n \"command\": \"uvx\",\n \"args\": [\"verychic-mcp\"]\n }\n }\n}\n```\n\nThis runs the server over stdio, which is what Claude Desktop and Claude Code use. You can\nalso run it directly:\n\n```bash\nuvx verychic-mcp # stdio (default)\nuvx verychic-mcp --help # all options\n```\n\nThe same `command`/`args` pair works in every stdio client; only the wrapping config differs.\nThese configs are for **local clients** (stdio). For cloud clients like claude.ai or Cowork,\nwhich connect over HTTPS instead, see [Use from Claude.ai or Cowork](#use-from-claudeai-or-cowork).\n\n

Claude Code (one-liner)

\n\n```bash\nclaude mcp add verychic -- uvx verychic-mcp\n```\n\n

\n\n

Cursor — ~/.cursor/mcp.json

\n\n```json\n{\n \"mcpServers\": {\n \"verychic\": {\n \"command\": \"uvx\",\n \"args\": [\"verychic-mcp\"]\n }\n }\n}\n```\n\n

\n\n

VS Code — .vscode/mcp.json (note the servers key)

\n\n```json\n{\n \"servers\": {\n \"verychic\": {\n \"command\": \"uvx\",\n \"args\": [\"verychic-mcp\"]\n }\n }\n}\n```\n\n

\n\n

Windsurf — ~/.codeium/windsurf/mcp_config.json

\n\n```json\n{\n \"mcpServers\": {\n \"verychic\": {\n \"command\": \"uvx\",\n \"args\": [\"verychic-mcp\"]\n }\n }\n}\n```\n\n

\n\n---\n\n## Tools\n\n| Tool | What it returns |\n| --- | --- |\n| `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`. |\n| `verychic_offer_details` | One offer's content (advantages, gallery) plus its availability and prices by date. |\n\nEvery call is read-only and anonymous, with a conservative rate limit built into the client.\n\n### `verychic_search_offers`\n\nReturns the offers matching every filter you pass (filters are combined with AND).\n\n| Parameter | Type | Required | Description |\n| --- | --- | --- | --- |\n| `destination` | string | no | Case-insensitive substring matched against the offer's destination *or* name. |\n| `country` | string | no | Exact, case-insensitive country match (e.g. `\"Espagne\"`). |\n| `max_price` | number | no | Keep only offers priced at or below this value (EUR). |\n| `min_discount` | number | no | Keep only offers with at least this discount percentage (e.g. `40`). |\n| `min_stars` | integer | no | Keep only offers with at least this hotel star rating (1–5). |\n| `flights_included` | boolean | no | `true` keeps flight-bearing offers, `false` keeps hotel-only offers. |\n| `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`. |\n| `near_lat` / `near_lng` | number | no | Latitude/longitude of a search center (decimal degrees), given together, to compute each offer's `distance_km`. |\n| `radius_km` | number | no | Keep only offers within this many km of `near_lat`/`near_lng` (requires both). |\n| `sort_by` | string (enum) | no | Order results: `discount`, `price`, `rating`, `stars`, or `distance` (nearest first, requires a center). |\n| `limit` | integer | no | Max number of offers to return. Defaults to `20`. |\n\n### `verychic_offer_details`\n\nReturns one offer's full content plus, for hotels, its day-by-day availability and prices.\n\n| Parameter | Type | Required | Description |\n| --- | --- | --- | --- |\n| `source` | string | yes | `ORCHESTRA` for a hotel, `ORCHESTRA_TO` for a tour-operator package. |\n| `external_id` | integer | yes | The offer's id, as returned by `verychic_search_offers`. |\n\n---\n\n## Examples\n\nAsk your assistant things like:\n\n- \"Browse the current VeryChic deals.\"\n- \"Search VeryChic offers in Spain under 600 euros.\"\n- \"Find 5-star spa hotels with at least 40% off, cheapest first.\"\n- \"Show VeryChic offers within 300 km of Paris (48.8566, 2.3522), nearest first.\"\n- \"Get the details and dated prices for the ORCHESTRA hotel offer 44983.\"\n- \"Get the details for the ORCHESTRA_TO package offer 301375.\" Tour-operator packages bundle\n flights with the hotel, so they do not expose day-by-day prices the way a single hotel does.\n The tool still returns the offer content and advantages, and sets\n `availabilities_supported: false` so an empty `availabilities` reads as \"not supported for this\n offer type\", not \"no dates available\".\n\nOffers carry a `source` (`ORCHESTRA` for a hotel, `ORCHESTRA_TO` for a package) and an\n`external_id`. Both come back from `verychic_search_offers`, so the\nassistant can pass them to `verychic_offer_details` on its own.\n\nA `verychic_search_offers` result is a list of offer objects (one shown here, trimmed):\n\n```jsonc\n{\n \"source\": \"ORCHESTRA\",\n \"external_id\": 36509,\n \"name\": \"Sofitel New York ****\",\n \"destination\": \"New York, États-Unis\",\n \"country\": \"États-Unis\",\n \"price\": 182,\n \"currency\": \"EUR\",\n \"discount\": 57.0,\n \"sales_mode\": \"FLASH\",\n \"offer_end_date\": \"2026-06-24T23:55+0200\",\n \"image\": \"https://.../sofitel-new-york.jpg\",\n \"advantages\": [\"Petit-déjeuner inclus\", \"VeryFlexible : réservez en toute sérénité !\"],\n \"offer_url\": \"https://www.verychic.fr/p/36509/etats-unis-new-york-hotel-sofitel-new-york\"\n}\n```\n\n`verychic_offer_details` adds `gallery`, `included_added_values`, a `cheapest_price`, and the\nday-by-day `availabilities` for a hotel:\n\n```jsonc\n{\n \"offer\": { \"source\": \"ORCHESTRA\", \"external_id\": 44983, \"name\": \"Hotel Kaktus Playa *****\", \"...\": \"...\" },\n \"cheapest_price\": 169,\n \"availabilities_supported\": true,\n \"availabilities\": [\n { \"date\": \"20/06/2026\", \"price\": 169, \"currency\": \"EUR\", \"nights\": 1, \"days\": 2 },\n { \"date\": \"21/06/2026\", \"price\": 169, \"currency\": \"EUR\", \"nights\": 1, \"days\": 2 }\n ]\n}\n```\n\n---\n\n## Use from Claude.ai or Cowork\n\nUnlike the local clients in [Quick start](#quick-start), cloud clients such as claude.ai and\nCowork only connect to remote MCP servers over HTTPS, not to a local process. To use VeryChic\nMCP there, host it yourself in `streamable-http` mode\n(`verychic-mcp --transport streamable-http`, behind HTTPS) and add it as a custom connector,\npasting your deployment URL with the `/mcp` path.\n\nA public instance is deployed for convenience at `https://verychic-mcp.fly.dev/mcp`. Add it as\na custom connector in claude.ai/Cowork, or wire it into a local client that speaks remote MCP:\n\n```json\n{\n \"mcpServers\": {\n \"verychic\": {\n \"url\": \"https://verychic-mcp.fly.dev/mcp\"\n }\n }\n}\n```\n\nIt is best-effort and may be paused or rate-limited at any time — for anything beyond a quick\ntry, run your own instance with the `uvx` command above or host the `streamable-http` mode.\n\nListing in Anthropic's official connector directory (next to Booking or Tripadvisor) is out of\nscope. That directory is reserved for partner integrations that pass a review this kind of tool\nwould not.\n\n---\n\n## How it works\n\nThe VeryChic web app talks to a public JSON API under\n`https://api.verychic.com/verychic-endpoints/v1` (plus `search.verychic.com`). This server\nreplays those same calls with a browser-like TLS fingerprint (`curl_cffi`), parses the\nresponses into typed objects, and exposes them as MCP tools. Everything works without logging\nin. The one volatile request parameter, `channelVersion`, is read from the live site at startup\nand falls back to a known value if that read fails.\n\n---\n\n## Development\n\n```bash\ngit clone https://github.com/jordantete/verychic-mcp.git && cd verychic-mcp\npip install -e \".[dev]\"\npytest # offline tests, run against recorded fixtures\npytest -m network # optional smoke test against the live API, low volume\nruff check verychic_mcp tests\n```\n\nReleases are tag-driven. Pushing a `vX.Y.Z` tag runs the tests, builds the package, and\npublishes it to PyPI through GitHub Actions with [trusted publishing](https://docs.pypi.org/trusted-publishers/),\nso no token is stored anywhere.\n\n---\n\n## Disclaimer\n\n> VeryChic MCP is not affiliated with, endorsed by, or connected to VeryChic or VeryChic SAS.\n> It is an independent community tool for personal use that reads VeryChic's public web API the\n> same way a browser does. You are responsible for complying with VeryChic's terms of sale,\n> notably Article 9 on intellectual property and the database producer's *sui generis* right.\n> Use it at your own risk, for personal and low-volume browsing only. Do not use it for bulk\n> extraction or redistribution of VeryChic's data.\n\n## License\n\nMIT. See [LICENSE](https://github.com/jordantete/verychic-mcp/blob/main/LICENSE).\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"iconType","image","upstream",{"_106":107,"_108":109,"_110":111,"_112":113,"_114":70,"_115":116},"requiredSecrets",[],"tags",[100,101,102,103,104,105],"assets",[],"stats",{"_98":85,"_99":85},"ratingAvg","reviewCount","ai-agents","claude","fastmcp","hotel-deals","travel","verychic","topics",[100,101,102,103,121,122,104,105],"license","MIT","language","Python","registryName","io.github.jordantete/verychic-mcp","homepage","packages",[117],{"_118":119,"_120":21,"_75":76},"registryType","pypi","identifier","mcp","mcp-server","ENV",{"_125":126,"_127":128,"_129":130},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]