verychic-mcp

verychic_offer_details

Read-onlyIdempotent

Inspect a specific VeryChic offer after searching: pass its source and external ID to get full details, per-date availability, prices, and monthly minimums.

Instructions

Get full details plus per-date availability and prices for one specific VeryChic offer.

    When to use: after `verychic_search_offers` returned an offer you want to inspect —
    pass that offer's `source` and `external_id` here. You must obtain those two
    identifiers from a search result first; this tool does not search.

    Behaviour: read-only and anonymous; rate-limited to about 1 request per second;
    prices in EUR, text in French. Availability is looked up for roughly the next 5
    months unless `months` names the window to query. For tour-operator packages
    (`source` = 'ORCHESTRA_TO') VeryChic exposes no date-availability endpoint:
    `availabilities` is then empty and `availabilities_supported` is false —
    meaning "not supported", NOT "sold out".

    Returns an object with: `offer` (same fields as a search result, plus `offer_url`),
    `advantages`, `included_added_values`, `non_included_added_values`, `gallery`
    (image URLs), `availabilities` (one entry per check-in date with `date`, `price`,
    `currency`, `nights`, `days`, `departure_city_code`), `availabilities_by_month`
    (one row per month with stock — `month` as 'MM/YYYY', `min_price`, `currency` and
    `dates_available` — in chronological order), `availabilities_supported` (bool), and
    `cheapest_price` (lowest available price, or null when none).

    To answer "which month is cheapest", read `availabilities_by_month` rather than
    scanning `availabilities`: it carries the same answer in a fraction of the size,
    and it stays small when `months` asks for a wide window.

Input Schema

TableJSON Schema

Name	Required	Description
`months`	No	Months to look up check-in availability for, each written 'MM/YYYY' (e.g. ['01/2027', '02/2027']). Use it to look further ahead than the default window, or to target a season. Omit for roughly the next 5 months. Has no effect on tour-operator packages, which expose no date availability.
`source`	Yes	The offer's source type, copied verbatim from the `source` field of a `verychic_search_offers` result. One of 'ORCHESTRA' (a single hotel) or 'ORCHESTRA_TO' (a tour-operator package). Packages have no per-date availability.
`external_id`	Yes	The offer's numeric `external_id`, copied from a `verychic_search_offers` result. Identifies the offer together with `source`.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`offer`	Yes
`gallery`	Yes
`advantages`	Yes
`availabilities`	Yes
`cheapest_price`	Yes
`included_added_values`	Yes
`availabilities_by_month`	Yes
`availabilities_supported`	Yes
`non_included_added_values`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed11 schema fields changedv0.4.0Sep 21, 2026

addedInput schema / properties / months

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "Months to look up check-in availability for, each written 'MM/YYYY' (e.g. ['01/2027', '02/2027']). Use it to look further ahead than the default window, or to target a season. Omit for roughly the next 5 months. Has no effect on tour-operator packages, which expose no date availability.",
+  "title": "Months"
+}

addedOutput schema / $defs / MonthPriceOut

Added value: +{
+  "properties": {
+    "currency": {
+      "title": "Currency",
+      "type": "string"
+    },
+    "dates_available": {
+      "title": "Dates Available",
+      "type": "integer"
+    },
+    "min_price": {
+      "title": "Min Price",
+      "type": "integer"
+    },
+    "month": {
+      "title": "Month",
+      "type": "string"
+    }
+  },
+  "required": [
+    "month",
+    "min_price",
+    "currency",
+    "dates_available"
+  ],
+  "title": "MonthPriceOut",
+  "type": "object"
+}

addedOutput schema / $defs / OfferOut / properties / opinion_count

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "title": "Opinion Count"
+}

addedOutput schema / $defs / OfferOut / properties / rating_food

Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "title": "Rating Food"
+}

addedOutput schema / $defs / OfferOut / properties / rating_location

Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "title": "Rating Location"
+}

addedOutput schema / $defs / OfferOut / properties / rating_public_area

Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "title": "Rating Public Area"
+}

addedOutput schema / $defs / OfferOut / properties / rating_room

Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "title": "Rating Room"
+}

addedOutput schema / $defs / OfferOut / properties / rating_service

Added value: +{
+  "anyOf": [
+    {
+      "type": "number"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "title": "Rating Service"
+}

changedOutput schema / $defs / OfferOut / required

Previous value: -[
-  "source",
-  "external_id",
-  "name",
-  "destination",
-  "country",
-  "price",
-  "currency",
-  "short_desc",
-  "discount",
-  "url_name",
-  "sales_mode",
-  "offer_end_date",
-  "latitude",
-  "longitude",
-  "image",
-  "advantages",
-  "themes",
-  "stars",
-  "price_label",
-  "price_with_flights",
-  "flights_included",
-  "rating",
-  "distance_km",
-  "offer_url"
-]New value: +[
+  "source",
+  "external_id",
+  "name",
+  "destination",
+  "country",
+  "price",
+  "currency",
+  "short_desc",
+  "discount",
+  "url_name",
+  "sales_mode",
+  "offer_end_date",
+  "latitude",
+  "longitude",
+  "image",
+  "advantages",
+  "themes",
+  "stars",
+  "price_label",
+  "price_with_flights",
+  "flights_included",
+  "rating",
+  "opinion_count",
+  "rating_location",
+  "rating_public_area",
+  "rating_room",
+  "rating_service",
+  "rating_food",
+  "distance_km",
+  "offer_url"
+]

addedOutput schema / properties / availabilities_by_month

Added value: +{
+  "items": {
+    "$ref": "#/$defs/MonthPriceOut"
+  },
+  "title": "Availabilities By Month",
+  "type": "array"
+}

changedOutput schema / required

Previous value: -[
-  "offer",
-  "advantages",
-  "included_added_values",
-  "non_included_added_values",
-  "gallery",
-  "availabilities",
-  "availabilities_supported",
-  "cheapest_price"
-]New value: +[
+  "offer",
+  "advantages",
+  "included_added_values",
+  "non_included_added_values",
+  "gallery",
+  "availabilities",
+  "availabilities_by_month",
+  "availabilities_supported",
+  "cheapest_price"
+]

Changed3 schema fields changedv0.2.1Sep 20, 2026

addedInput schema / properties / external_id / description

Added value: +"The offer's numeric `external_id`, copied from a `verychic_search_offers` result. Identifies the offer together with `source`."

addedInput schema / properties / source / description

Added value: +"The offer's source type, copied verbatim from the `source` field of a `verychic_search_offers` result. One of 'ORCHESTRA' (a single hotel) or 'ORCHESTRA_TO' (a tour-operator package). Packages have no per-date availability."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$defs": {
+    "AvailabilityOut": {
+      "properties": {
+        "currency": {
+          "title": "Currency",
+          "type": "string"
+        },
+        "date": {
+          "title": "Date",
+          "type": "string"
+        },
+        "days": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Days"
+        },
+        "departure_city_code": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Departure City Code"
+        },
+        "nights": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Nights"
+        },
+        "price": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Price"
+        }
+      },
+      "required": [
+        "date",
+        "price",
+        "currency",
+        "nights",
+        "days",
+        "departure_city_code"
+      ],
+      "title": "AvailabilityOut",
+      "type": "object"
+    },
+    "OfferOut": {
+      "properties": {
+        "advantages": {
+          "items": {
+            "type": "string"
+          },
+          "title": "Advantages",
+          "type": "array"
+        },
+        "country": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Country"
+        },
+        "currency": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Currency"
+        },
+        "destination": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Destination"
+        },
+        "discount": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Discount"
+        },
+        "distance_km": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Distance Km"
+        },
+        "external_id": {
+          "title": "External Id",
+          "type": "integer"
+        },
+        "flights_included": {
+          "title": "Flights Included",
+          "type": "boolean"
+        },
+        "image": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Image"
+        },
+        "latitude": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Latitude"
+        },
+        "longitude": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Longitude"
+        },
+        "name": {
+          "title": "Name",
+          "type": "string"
+        },
+        "offer_end_date": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Offer End Date"
+        },
+        "offer_url": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Offer Url"
+        },
+        "price": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Price"
+        },
+        "price_label": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Price Label"
+        },
+        "price_with_flights": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Price With Flights"
+        },
+        "rating": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Rating"
+        },
+        "sales_mode": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Sales Mode"
+        },
+        "short_desc": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Short Desc"
+        },
+        "source": {
+          "title": "Source",
+          "type": "string"
+        },
+        "stars": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Stars"
+        },
+        "themes": {
+          "items": {
+            "type": "string"
+          },
+          "title": "Themes",
+          "type": "array"
+        },
+        "url_name": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "title": "Url Name"
+        }
+      },
+      "required": [
+        "source",
+        "external_id",
+        "name",
+        "destination",
+        "country",
+        "price",
+        "currency",
+        "short_desc",
+        "discount",
+        "url_name",
+        "sales_mode",
+        "offer_end_date",
+        "latitude",
+        "longitude",
+        "image",
+        "advantages",
+        "themes",
+        "stars",
+        "price_label",
+        "price_with_flights",
+        "flights_included",
+        "rating",
+        "distance_km",
+        "offer_url"
+      ],
+      "title": "OfferOut",
+      "type": "object"
+    }
+  },
+  "properties": {
+    "advantages": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Advantages",
+      "type": "array"
+    },
+    "availabilities": {
+      "items": {
+        "$ref": "#/$defs/AvailabilityOut"
+      },
+      "title": "Availabilities",
+      "type": "array"
+    },
+    "availabilities_supported": {
+      "title": "Availabilities Supported",
+      "type": "boolean"
+    },
+    "cheapest_price": {
+      "anyOf": [
+        {
+          "type": "integer"
+        },
+        {
+          "type": "null"
+        }
+      ],
+      "title": "Cheapest Price"
+    },
+    "gallery": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Gallery",
+      "type": "array"
+    },
+    "included_added_values": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Included Added Values",
+      "type": "array"
+    },
+    "non_included_added_values": {
+      "items": {
+        "type": "string"
+      },
+      "title": "Non Included Added Values",
+      "type": "array"
+    },
+    "offer": {
+      "$ref": "#/$defs/OfferOut"
+    }
+  },
+  "required": [
+    "offer",
+    "advantages",
+    "included_added_values",
+    "non_included_added_values",
+    "gallery",
+    "availabilities",
+    "availabilities_supported",
+    "cheapest_price"
+  ],
+  "title": "OfferDetailsOut",
+  "type": "object"
+}

First observedv0.1.3Jun 23, 2026

TDQS

A4.7/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description goes well beyond the annotations by disclosing that the call is read-only and anonymous, rate-limited to about 1 request per second, returns EUR prices and French text, defaults to a roughly 5-month availability window, and handles the tour-operator case where empty `availabilities` means 'not supported', not 'sold out'. These are specific and important behavioral details.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is well-structured into purpose, when-to-use, behavior, return shape, and an efficiency hint. Although it is fairly long, every section adds operational value and the key purpose is front-loaded.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

It covers prerequisites, request constraints, rate limits, units, language, the special-case behavior for tour-operator packages, the full return object shape, and a recommendation for efficiently answering 'which month is cheapest'. An agent has everything needed to call this tool correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already documents all three parameters with descriptions, examples, and the tour-operator caveat, so schema coverage is 100%. The description reinforces that `source` and `external_id` come from a search result and clarifies the `months` default, but it does not add substantial meaning beyond what the schema already provides.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with 'Get full details plus per-date availability and prices for one specific VeryChic offer', which names the verb, resource, and scope precisely. It clearly distinguishes this from the sibling `verychic_search_offers` by emphasizing this tool inspects one already-found offer rather than searching.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is an explicit 'When to use' section: use it after `verychic_search_offers` returns an offer, and pass that offer's `source` and `external_id`. It also states that the identifiers must be obtained from a search result first and that this tool does not search, giving clear routing and prerequisites.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server