Côte Privée MCP
An official MCP server operated by Côte Privée, a licensed private driver service in Beaune, Burgundy. It allows AI agents to search for places, find events, get prices and policies, check availability, plan wine days, request bookings, and retrieve booking status for private driver services.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://www.cote-privee.com/mcpWhat its tools do
11 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.
Read-only (10)
Can change data (1)
Checks and signals
Each line is separate evidence, not a trust score.
- Passed Endpoint answered the live check ·
- Passed Official MCP Registry namespace is tied to cote-privee.com ·
- Passed Endpoint is on the registry namespace domain ·
- Availability 1 of 1 checks passed in 30 days
What you can do with it
- Search for wine tour locations and châteaux
- Find upcoming events in Burgundy
- Check driver availability and get price quotes
- Request and track private driver bookings
Source and maintenance
Protocol and capabilities
- Server
- cote-privee 1.2.0
- MCP protocol negotiated in check
- 2025-06-18
- Tools
- 11 advertised
- Resources
- 3 advertised
- Resource templates
- 0 advertised
- Prompts
- 1 advertised
{
"tools": {
"listChanged": false
},
"prompts": {
"listChanged": false
},
"resources": {}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
11 advertised
search_places — Search places in Burgundy
Wine villages, châteaux, things to do and MICHELIN-starred restaurants: id, commune, drive and price by private driver from Beaune (per vehicle, one way / same-day return), the drive and fare from Paris and from Lyon airport (fromParis, fromLyon: the same both ways), the wine day of its page and its price, page and booking link; a restaurant's stars and cheapest menu (no opening days in the data). near and radiusKm: the places around a place, nearest first. 8 results unless limit; compact drops summaries.
{
"type": "object",
"properties": {
"area": {
"enum": [
"beaune",
"cote",
"dijon",
"south",
"north",
"beyond"
],
"type": "string",
"description": "cote: Côtes de Nuits and de Beaune; north: Chablis, Yonne, Auxois; south: Chalonnais, Mâconnais."
},
"kind": {
"enum": [
"village",
"chateau",
"sight",
"restaurant"
],
"type": "string"
},
"lang": {
"enum": [
"en",
"fr",
"de",
"zh",
"ar"
],
"type": "string",
"description": "ar: Arabic notes, data in English."
},
"near": {
"type": "string",
"maxLength": 200,
"description": "A place id or name."
},
"limit": {
"type": "integer",
"maximum": 25,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Words in names, communes and summaries, e.g. \"abbey\", \"grand cru\"."
},
"compact": {
"type": "boolean"
},
"radiusKm": {
"type": "integer",
"maximum": 60,
"minimum": 1,
"description": "Default 10."
}
}
}{
"type": "object",
"required": [
"count",
"results"
],
"properties": {
"near": {
"type": "object",
"required": [
"id",
"name",
"radiusKm"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"radiusKm": {
"type": "number"
}
}
},
"count": {
"type": "integer",
"minimum": 0
},
"results": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"kind",
"name",
"commune",
"area",
"lat",
"lon",
"driveFromBeaune",
"priceFromBeaune",
"fromParis",
"fromLyon",
"url",
"bookUrl"
],
"properties": {
"id": {
"type": "string"
},
"lat": {
"type": "number"
},
"lon": {
"type": "number"
},
"url": {
"type": "string",
"format": "uri"
},
"area": {
"enum": [
"beaune",
"cote",
"dijon",
"south",
"north",
"beyond"
],
"type": "string"
},
"kind": {
"enum": [
"village",
"chateau",
"sight",
"restaurant"
],
"type": "string"
},
"name": {
"type": "string"
},
"bookUrl": {
"type": "string",
"format": "uri"
},
"commune": {
"type": "string"
},
"service": {
"type": "string",
"format": "uri"
},
"summary": {
"type": "string"
},
"wineDay": {
"type": [
"object",
"null"
],
"required": [
"option",
"extraHours",
"hours",
"price"
],
"properties": {
"hours": {
"type": "integer"
},
"price": {
"type": "number"
},
"option": {
"enum": [
"half",
"full",
"long"
],
"type": "string"
},
"extraHours": {
"type": "integer",
"minimum": 0
}
}
},
"fromLyon": {
"type": [
"object",
"null"
],
"required": [
"km",
"minutes",
"oneWay"
],
"properties": {
"km": {
"type": "number"
},
"oneWay": {
"type": "number"
},
"minutes": {
"type": "number"
}
}
},
"markdown": {
"type": "string",
"format": "uri"
},
"fromParis": {
"type": [
"object",
"null"
],
"required": [
"km",
"minutes",
"oneWay"
],
"properties": {
"km": {
"type": "number"
},
"oneWay": {
"type": "number"
},
"minutes": {
"type": "number"
}
}
},
"distanceKm": {
"type": "number"
},
"restaurant": {
"type": "object",
"required": [
"stars",
"menuFrom",
"cuisine"
],
"properties": {
"stars": {
"type": "integer",
"maximum": 3,
"minimum": 1
},
"cuisine": {
"type": [
"string",
"null"
]
},
"menuFrom": {
"type": [
"number",
"null"
]
}
}
},
"driveFromBeaune": {
"type": "object",
"required": [
"km",
"minutes"
],
"properties": {
"km": {
"type": "number"
},
"minutes": {
"type": "number"
}
}
},
"priceFromBeaune": {
"type": [
"object",
"null"
],
"required": [
"oneWay",
"return",
"currency",
"perVehicle"
],
"properties": {
"oneWay": {
"type": "number"
},
"return": {
"type": "number"
},
"currency": {
"enum": [
"EUR"
],
"type": "string"
},
"perVehicle": {
"type": "boolean"
},
"returnLater": {
"type": "number"
}
}
}
}
}
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_page — Read a page of the site
A page in Markdown (a place, event, guide, service, prices, policies): facts, history, visiting, nearby, sources. ref: an id from search_places ("chateau:closvougeot"), a page address or path ("/prices") or a place name; id, url and path are the same. Without lang, an address in /fr, /de or /zh gives that language.
{
"type": "object",
"properties": {
"id": {
"type": "string",
"maxLength": 300,
"description": "Same as ref."
},
"ref": {
"type": "string",
"maxLength": 300,
"description": "An id, address, path or name."
},
"url": {
"type": "string",
"maxLength": 300,
"description": "Same as ref."
},
"lang": {
"enum": [
"en",
"fr",
"de",
"zh",
"ar"
],
"type": "string",
"description": "ar: Arabic notes, data in English."
},
"path": {
"type": "string",
"maxLength": 300,
"description": "Same as ref."
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}find_events — Find events and wine festivals
Wine fairs, festivals, auctions and cultural events between two dates, at their next appearance: id (event:<id>, which quote takes as to), placeId, dates and whether they are confirmed, website, and a driver quote for the day asked within the event (dated once confirmed): a wine day for a wine event in a wine village, else the ride from Beaune (or origin) and back later the same day.
{
"type": "object",
"properties": {
"to": {
"type": "string",
"format": "date",
"description": "Default a year after from."
},
"from": {
"type": "string",
"format": "date",
"description": "Default today."
},
"lang": {
"enum": [
"en",
"fr",
"de",
"zh",
"ar"
],
"type": "string",
"description": "ar: Arabic notes, data in English."
},
"limit": {
"type": "integer",
"maximum": 40,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 200,
"description": "Words, e.g. \"Hospices\", \"jazz\"."
},
"origin": {
"enum": [
"beaune",
"dijon",
"lyon",
"paris",
"geneva",
"creusot",
"lfsd",
"lfgj",
"lfgf",
"lfgz",
"lflh",
"lfgi",
"lfep",
"macon",
"chalon",
"reims",
"epernay",
"troyes",
"colmar",
"strasbourg",
"besancon",
"arbois",
"annecy",
"chamonix",
"avignon"
],
"type": "string",
"description": "Start of the driver quote (default beaune)."
}
}
}{
"type": "object",
"required": [
"from",
"to",
"count",
"events"
],
"properties": {
"to": {
"type": "string",
"format": "date"
},
"from": {
"type": "string",
"format": "date"
},
"count": {
"type": "integer",
"minimum": 0
},
"events": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"summary",
"start",
"end",
"datesConfirmed",
"where",
"placeId",
"category",
"free",
"website",
"url",
"bookDriver"
],
"properties": {
"id": {
"type": "string"
},
"end": {
"type": "string",
"format": "date"
},
"url": {
"type": "string",
"format": "uri"
},
"free": {
"type": [
"boolean",
"null"
]
},
"name": {
"type": "string"
},
"start": {
"type": "string",
"format": "date"
},
"where": {
"type": "string"
},
"placeId": {
"type": [
"string",
"null"
]
},
"summary": {
"type": "string"
},
"website": {
"type": [
"string",
"null"
]
},
"category": {
"type": "string"
},
"bookDriver": {
"type": "string",
"format": "uri"
},
"driverQuote": {
"type": "object",
"required": [
"service",
"title",
"price",
"payment",
"deposit",
"bookUrl"
],
"properties": {
"date": {
"type": "string",
"format": "date"
},
"note": {
"type": "string"
},
"price": {
"type": "number"
},
"title": {
"type": "string"
},
"bookUrl": {
"type": "string",
"format": "uri"
},
"deposit": {
"type": "number",
"deprecated": true
},
"payment": {
"enum": [
"in full when the driver confirms"
],
"type": "string"
},
"service": {
"enum": [
"wine-tour",
"driver",
"transfer"
],
"type": "string"
}
}
},
"datesConfirmed": {
"type": "boolean"
}
}
}
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_prices — Prices
Every price per vehicle, taxes, tolls and parking included: the cars (the Polestar 2, 4 guests, included; a Mercedes E-Class or V-Class, up to 7, on request for a supplement per day of service), wine days and which one a place needs by its distance (wineDayByDistance), driver by the hour, trips from Beaune and same-day returns, transfers, and when the price is paid (in full, once the driver confirms). Tastings are paid to the estates.
{
"type": "object",
"properties": {
"lang": {
"enum": [
"en",
"fr",
"de",
"zh",
"ar"
],
"type": "string",
"description": "ar: Arabic notes, data in English."
}
}
}{
"type": "object",
"required": [
"updated",
"validThrough",
"currency",
"perVehicle",
"maxGuests",
"vehicle",
"cars",
"taxesIncluded",
"tollsAndParkingIncluded",
"tastingsIncluded",
"payment",
"wineDays",
"wineDayByDistance",
"driverByTheHour",
"tripsFromBeaune",
"transfers",
"pricesPage"
],
"properties": {
"cars": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"seats",
"bags",
"included",
"onRequest",
"supplementPerDay",
"rideBase",
"ridePerKm"
],
"properties": {
"id": {
"enum": [
"polestar",
"eclass",
"vclass"
],
"type": "string"
},
"bags": {
"type": "object",
"required": [
"large",
"cabin"
],
"properties": {
"cabin": {
"type": "integer"
},
"large": {
"type": "integer"
}
}
},
"name": {
"type": "string"
},
"seats": {
"type": "integer"
},
"included": {
"type": "boolean"
},
"rideBase": {
"type": [
"number",
"null"
]
},
"onRequest": {
"type": "boolean"
},
"ridePerKm": {
"type": [
"number",
"null"
]
},
"supplementPerDay": {
"type": "number"
}
}
}
},
"payment": {
"enum": [
"in full when the driver confirms"
],
"type": "string"
},
"updated": {
"type": "string",
"format": "date"
},
"vehicle": {
"type": "string"
},
"currency": {
"enum": [
"EUR"
],
"type": "string"
},
"wineDays": {
"type": "array",
"items": {
"type": "object",
"required": [
"option",
"name",
"hours",
"price",
"extraHour",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string"
},
"hours": {
"type": "integer"
},
"price": {
"type": "number"
},
"option": {
"enum": [
"half",
"full",
"long"
],
"type": "string"
},
"extraHour": {
"type": "number"
}
}
}
},
"maxGuests": {
"type": "integer"
},
"transfers": {
"type": "array",
"items": {
"type": "object",
"required": [
"route",
"name",
"oneWay",
"returnTrip",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string"
},
"floor": {
"type": "boolean"
},
"route": {
"enum": [
"lyon",
"paris",
"dijon",
"geneva",
"creusot",
"lfsd",
"lfgj"
],
"type": "string"
},
"oneWay": {
"type": "number"
},
"returnTrip": {
"type": "number"
}
}
}
},
"perVehicle": {
"type": "boolean"
},
"pricesPage": {
"type": "string",
"format": "uri"
},
"tastingsNote": {
"type": "string"
},
"validThrough": {
"type": "string",
"format": "date"
},
"taxesIncluded": {
"type": "boolean"
},
"driverByTheHour": {
"type": "object",
"required": [
"price",
"minHours",
"maxHours",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"price": {
"type": "number"
},
"maxHours": {
"type": "integer"
},
"minHours": {
"type": "integer"
}
}
},
"tripsFromBeaune": {
"type": "object",
"required": [
"from",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"from": {
"type": "number"
},
"laterRides": {
"type": "integer"
},
"returnFactor": {
"type": "number"
},
"returnWaitHours": {
"type": "number"
}
}
},
"tastingsIncluded": {
"type": "boolean"
},
"wineDayByDistance": {
"type": "array",
"items": {
"type": "object",
"required": [
"upToKm",
"option",
"extraHours",
"hours",
"price",
"name",
"examples"
],
"properties": {
"name": {
"type": "string"
},
"hours": {
"type": "integer"
},
"price": {
"type": "number"
},
"option": {
"enum": [
"half",
"full",
"long"
],
"type": "string"
},
"upToKm": {
"type": [
"number",
"null"
]
},
"examples": {
"type": "array",
"items": {
"type": "string"
}
},
"extraHours": {
"type": "integer",
"minimum": 0
}
}
}
},
"tollsAndParkingIncluded": {
"type": "boolean"
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_policies — Booking rules and the car
The booking rules as facts: the cars, the guests and the bags each takes, when the price is paid (in full, once the driver confirms), booking window and today in Beaune, service hours, luggage, waiting, cancellation, child seats, languages, the hours bookings are answered, the kind of licence and the SIREN, and the FAQ answers about them. A rule not published yet is null or left out.
{
"type": "object",
"properties": {
"lang": {
"enum": [
"en",
"fr",
"de",
"zh",
"ar"
],
"type": "string",
"description": "ar: Arabic notes, data in English."
}
}
}{
"type": "object",
"required": [
"vehicle",
"cars",
"guests",
"payment",
"deposit",
"booking",
"serviceHours",
"luggage",
"waiting",
"cancellation",
"childSeats",
"languages",
"hours",
"licence",
"answers",
"termsFinal",
"pages"
],
"properties": {
"cars": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"seats",
"bags",
"included",
"onRequest",
"supplementPerDay",
"rideBase",
"ridePerKm"
],
"properties": {
"id": {
"enum": [
"polestar",
"eclass",
"vclass"
],
"type": "string"
},
"bags": {
"type": "object",
"required": [
"large",
"cabin"
],
"properties": {
"cabin": {
"type": "integer"
},
"large": {
"type": "integer"
}
}
},
"name": {
"type": "string"
},
"seats": {
"type": "integer"
},
"included": {
"type": "boolean"
},
"rideBase": {
"type": [
"number",
"null"
]
},
"onRequest": {
"type": "boolean"
},
"ridePerKm": {
"type": [
"number",
"null"
]
},
"supplementPerDay": {
"type": "number"
}
}
}
},
"hours": {
"type": "array",
"items": {
"type": "object",
"required": [
"days",
"opens",
"closes"
],
"properties": {
"days": {
"type": "array",
"items": {
"type": "string"
}
},
"opens": {
"type": "string"
},
"closes": {
"type": "string"
}
}
}
},
"pages": {
"type": "object",
"required": [
"prices",
"faq",
"terms"
],
"properties": {
"faq": {
"type": "string",
"format": "uri"
},
"terms": {
"type": "string",
"format": "uri"
},
"prices": {
"type": "string",
"format": "uri"
}
}
},
"guests": {
"type": "object",
"required": [
"max",
"standardCar",
"pricesPerVehicle",
"byCar",
"note"
],
"properties": {
"max": {
"type": "integer"
},
"note": {
"type": "string"
},
"byCar": {
"type": "object",
"additionalProperties": {
"type": "integer"
}
},
"standardCar": {
"type": "integer"
},
"pricesPerVehicle": {
"type": "boolean"
}
}
},
"answers": {
"type": "array",
"items": {
"type": "object",
"required": [
"question",
"answer",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"answer": {
"type": "string"
},
"question": {
"type": "string"
}
}
}
},
"booking": {
"type": "object",
"required": [
"advanceOnly",
"earliest",
"latest",
"monthsAhead",
"page",
"today",
"timezone"
],
"properties": {
"page": {
"type": "string",
"format": "uri"
},
"today": {
"type": "string",
"format": "date"
},
"latest": {
"type": "string",
"format": "date"
},
"earliest": {
"type": "string",
"format": "date"
},
"timezone": {
"type": "string"
},
"advanceOnly": {
"type": "boolean"
},
"monthsAhead": {
"type": "integer"
}
}
},
"deposit": {
"type": "object",
"required": [
"rate",
"payment"
],
"deprecated": true,
"properties": {
"rate": {
"type": "number"
},
"payment": {
"type": "string"
}
}
},
"licence": {
"type": "object",
"required": [
"kind",
"siren",
"insurer"
],
"properties": {
"kind": {
"type": "string"
},
"siren": {
"type": [
"string",
"null"
]
},
"insurer": {
"type": [
"string",
"null"
]
}
}
},
"luggage": {
"type": "object",
"required": [
"maxBags",
"bagsWithoutNote",
"largeWithFourGuests",
"cabinWithFourGuests",
"wineCases",
"notes"
],
"properties": {
"notes": {
"type": "array",
"items": {
"type": "string"
}
},
"maxBags": {
"type": "integer"
},
"wineCases": {
"type": [
"number",
"null"
]
},
"bagsWithoutNote": {
"type": "integer"
},
"cabinWithFourGuests": {
"type": [
"number",
"null"
]
},
"largeWithFourGuests": {
"type": [
"number",
"null"
]
}
}
},
"payment": {
"type": "object",
"required": [
"when",
"answer"
],
"properties": {
"when": {
"enum": [
"in full when the driver confirms"
],
"type": "string"
},
"answer": {
"type": "string"
}
}
},
"vehicle": {
"type": "object",
"required": [
"model",
"electric",
"seats",
"features"
],
"properties": {
"model": {
"type": "string"
},
"seats": {
"type": "integer"
},
"electric": {
"type": "boolean"
},
"features": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"waiting": {
"type": "object",
"required": [
"returnWaitHours",
"freeMinutes",
"feePer15Min",
"delays"
],
"properties": {
"delays": {
"type": "string"
},
"feePer15Min": {
"type": [
"number",
"null"
]
},
"freeMinutes": {
"type": "object",
"required": [
"airport",
"station",
"address"
],
"properties": {
"address": {
"type": [
"number",
"null"
]
},
"airport": {
"type": [
"number",
"null"
]
},
"station": {
"type": [
"number",
"null"
]
}
}
},
"returnWaitHours": {
"type": "number"
}
}
},
"languages": {
"type": "array",
"items": {
"type": "string"
}
},
"childSeats": {
"type": "object",
"required": [
"onRequest",
"seats",
"answer"
],
"properties": {
"seats": {
"type": [
"number",
"null"
]
},
"answer": {
"type": "string"
},
"onRequest": {
"type": "boolean"
}
}
},
"termsFinal": {
"type": "boolean"
},
"cancellation": {
"type": "object",
"required": [
"freeUntilHoursBefore",
"refundDays"
],
"properties": {
"refundDays": {
"type": [
"number",
"null"
]
},
"freeUntilHoursBefore": {
"type": [
"number",
"null"
]
}
}
},
"serviceHours": {
"type": "object",
"additionalProperties": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
}
}
}
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}check_availability — Is the driver free?
Whether the one car and its driver are free on a day and the next days: free; pending (a request awaits the driver's answer and may still be confirmed); busy; unbookable (outside the booking rules: tomorrow to 18 months ahead, Beaune time, within the service's hours). With the hours held, the next free days, the sources read, when, today's date, the page to cite (url, pricesUrl) and a booking link. The driver confirms every booking.
{
"type": "object",
"required": [
"date"
],
"properties": {
"date": {
"type": "string",
"format": "date"
},
"days": {
"type": "integer",
"maximum": 31,
"minimum": 1
},
"lang": {
"enum": [
"en",
"fr",
"de",
"zh",
"ar"
],
"type": "string",
"description": "ar: Arabic notes, data in English."
},
"time": {
"type": "string",
"pattern": "^\\d\\d:\\d\\d$",
"description": "Pickup."
},
"service": {
"enum": [
"wine-tour",
"driver",
"transfer"
],
"type": "string"
}
}
}{
"type": "object",
"required": [
"date",
"state",
"days",
"nextFree",
"sources",
"checkedAt",
"rules",
"today",
"timezone",
"note",
"url",
"pricesUrl"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"date": {
"type": "string",
"format": "date"
},
"days": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"state",
"held"
],
"properties": {
"date": {
"type": "string",
"format": "date"
},
"held": {
"type": "array",
"items": {
"type": "object",
"required": [
"from",
"to",
"state"
],
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"state": {
"enum": [
"pending",
"busy"
],
"type": "string"
}
}
}
},
"state": {
"enum": [
"free",
"pending",
"busy",
"unbookable"
],
"type": "string"
}
}
}
},
"note": {
"type": "string"
},
"time": {
"type": "string"
},
"rules": {
"type": "object",
"required": [
"accepted",
"earliest",
"latest",
"problems"
],
"properties": {
"hours": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
}
}
},
"latest": {
"type": "string",
"format": "date"
},
"accepted": {
"type": "boolean"
},
"earliest": {
"type": "string",
"format": "date"
},
"problems": {
"type": "array",
"items": {
"type": "object",
"required": [
"field",
"code",
"message"
],
"properties": {
"code": {
"type": "string"
},
"field": {
"type": "string"
},
"allowed": {
"type": [
"object",
"array"
],
"items": {
"type": "string"
},
"additionalProperties": {
"type": "string"
}
},
"message": {
"type": "string"
},
"expected": {
"type": "string"
},
"candidates": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"kind",
"name"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
},
"messageLocalized": {
"type": "string"
}
}
}
}
}
},
"state": {
"enum": [
"free",
"pending",
"busy",
"unbookable",
"unknown"
],
"type": "string"
},
"today": {
"type": "string",
"format": "date"
},
"bookUrl": {
"type": "string",
"format": "uri"
},
"service": {
"enum": [
"wine-tour",
"driver",
"transfer"
],
"type": "string"
},
"sources": {
"type": "array",
"items": {
"enum": [
"bookings",
"calendar"
],
"type": "string"
}
},
"nextFree": {
"type": "array",
"items": {
"type": "string",
"format": "date"
}
},
"timezone": {
"type": "string"
},
"checkedAt": {
"type": "string",
"format": "date-time"
},
"pricesUrl": {
"type": "string",
"format": "uri"
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}quote — Exact price for a trip
The exact price the booking page charges for one service, or a whole trip (items: one total, paid in full once the driver confirms), the page of the priced service to cite (url; pricesUrl: every price) and a link that opens the booking page filled in (time, guests and bags too). Wine day: option and stops; a day too short for its stops is priced as the one they need (optionRaised). Driver: hours (and stops); with to, a ride there from Beaune or from; returnTrip: the driver waits up to 3 h; returnLater: back later (2 rides). Transfer, a ride from any starting point or place to any other: route (its id, its page slug such as lyon-beaune, or a name such as "Lyon airport"), or from and to; direction from: the way back (Meursault → Paris for a flight), at the same fare; stop: a stop on the way; back: the way back; a ride from or to Paris or Lyon never costs less than its route to Beaune, and from or to paris never comes back the same day. A Mercedes adds its supplement per day of service; over 4 guests, the V-Class (carRaised). resolved: what each name became (an unknown place or route is an error with candidates); alternatives: cheaper products for the same job; availability: with date.
{
"type": "object",
"properties": {
"to": {
"type": "string",
"maxLength": 200,
"description": "A place id or name, or event:<id>; for a ride a starting point too (\"Lyon airport\", \"geneva\")."
},
"car": {
"enum": [
"polestar",
"eclass",
"vclass"
],
"type": "string",
"description": "polestar (included), eclass (4 guests) or vclass (7): the Mercedes on request, a supplement per day of service."
},
"back": {
"enum": [
"none",
"wait",
"later",
"day"
],
"type": "string",
"description": "A ride's way back, instead of returnTrip: wait or later the same day (never from or to paris), day another day (returnDate)."
},
"date": {
"type": "string",
"format": "date"
},
"from": {
"enum": [
"beaune",
"dijon",
"lyon",
"paris",
"geneva",
"creusot",
"lfsd",
"lfgj",
"lfgf",
"lfgz",
"lflh",
"lfgi",
"lfep",
"macon",
"chalon",
"reims",
"epernay",
"troyes",
"colmar",
"strasbourg",
"besancon",
"arbois",
"annecy",
"chamonix",
"avignon"
],
"type": "string",
"description": "Start of a ride (service transfer, or the driver to one place): a station, an airport (airfields by ICAO code), Paris, Lyon, Geneva, Mâcon-Loché TGV (macon), Chalon-sur-Saône (chalon) or a city beyond Burgundy (reims, epernay, troyes, colmar, strasbourg, besancon, arbois, annecy, chamonix, avignon). A wine day: dijon, a full or long day from Dijon and back there, at its price."
},
"lang": {
"enum": [
"en",
"fr",
"de",
"zh",
"ar"
],
"type": "string",
"description": "ar: Arabic notes, data in English."
},
"stop": {
"type": "string",
"maxLength": 120,
"description": "A ride's stop on the way (a tasting, a lunch): a place id or name; stopHours 1 to 3, each at the hourly price, plus the detour."
},
"time": {
"type": "string",
"pattern": "^\\d\\d:\\d\\d$",
"description": "Pickup (a transfer to Beaune: the arrival)."
},
"hours": {
"type": "integer",
"maximum": 12,
"minimum": 3,
"description": "Driver by the hour."
},
"items": {
"type": "array",
"items": {
"type": "object"
},
"maxItems": 6,
"description": "Several services (at most 6), each with the fields above."
},
"notes": {
"type": "string",
"maxLength": 1000,
"description": "For the driver: estates to visit, child seats…"
},
"route": {
"type": "string",
"maxLength": 120,
"description": "A transfer route, by id or page slug (lyon (lyon-beaune), paris (paris-beaune), dijon (dijon-beaune), geneva (geneva-beaune), creusot (le-creusot-tgv-beaune), lfsd (dijon-airport-beaune), lfgj (dole-jura-airport-beaune)) or by name (\"Lyon airport\", \"Dijon-Bourgogne\", \"Dole\"): a transfer to or from Beaune (creusot: Le Creusot TGV; lfsd, lfgj: the airports)."
},
"stops": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120
},
"maxItems": 12,
"description": "Places of a wine day, or of the driver by the hour."
},
"guests": {
"type": "integer",
"maximum": 7,
"minimum": 1,
"description": "4 in the Polestar 2 or the E-Class, 7 in the V-Class."
},
"option": {
"enum": [
"half",
"full",
"long"
],
"type": "string",
"description": "Wine day: half 4 h, full 8 h, long 12 h."
},
"luggage": {
"type": "integer",
"maximum": 6,
"minimum": 0,
"description": "Bags."
},
"service": {
"enum": [
"wine-tour",
"driver",
"transfer"
],
"type": "string"
},
"direction": {
"enum": [
"to",
"from"
],
"type": "string",
"description": "A ride: to Beaune or the place (default), or from it: from paris, to village:meursault, direction from is Meursault → Paris (CDG, Orly or the city), at the same fare."
},
"stopHours": {
"type": "integer",
"maximum": 3,
"minimum": 1
},
"extraHours": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "Wine day; default what its stops need."
},
"returnTrip": {
"type": "boolean",
"description": "Driver to a place: back the same day, the driver waiting. Transfer: a trip back another day."
},
"returnLater": {
"type": "boolean",
"description": "Driver to a place: back later the same day (two rides)."
}
}
}{
"type": "object",
"required": [
"service",
"title",
"details",
"price",
"servicePrice",
"car",
"currency",
"perVehicle",
"guests",
"maxGuests",
"payment",
"deposit",
"tastingsIncluded",
"resolved",
"notFound",
"url",
"pricesUrl",
"bookUrl"
],
"properties": {
"car": {
"type": "object",
"required": [
"id",
"name",
"seats",
"onRequest",
"supplementPerDay",
"days",
"supplement"
],
"properties": {
"id": {
"enum": [
"polestar",
"eclass",
"vclass"
],
"type": "string"
},
"days": {
"type": "integer",
"minimum": 1
},
"name": {
"type": "string"
},
"seats": {
"type": "integer"
},
"onRequest": {
"type": "boolean"
},
"supplement": {
"type": "number"
},
"supplementPerDay": {
"type": "number"
}
}
},
"url": {
"type": "string",
"format": "uri"
},
"date": {
"type": "string",
"format": "date"
},
"fits": {
"type": "object",
"required": [
"guests",
"luggage"
],
"properties": {
"note": {
"type": "string"
},
"guests": {
"type": "boolean"
},
"luggage": {
"type": [
"boolean",
"null"
]
},
"suggestCar": {
"enum": [
"polestar",
"eclass",
"vclass"
],
"type": "string"
}
}
},
"time": {
"type": "string"
},
"drive": {
"type": "object",
"required": [
"km",
"minutes"
],
"properties": {
"km": {
"type": "number"
},
"minutes": {
"type": "number"
}
}
},
"price": {
"type": "number"
},
"title": {
"type": "string"
},
"guests": {
"type": "integer"
},
"option": {
"enum": [
"half",
"full",
"long"
],
"type": "string"
},
"balance": {
"type": "number",
"deprecated": true
},
"bookUrl": {
"type": "string",
"format": "uri"
},
"deposit": {
"type": "number",
"deprecated": true
},
"details": {
"type": "array",
"items": {
"type": "string"
}
},
"luggage": {
"type": "integer"
},
"payment": {
"enum": [
"in full when the driver confirms"
],
"type": "string"
},
"service": {
"enum": [
"wine-tour",
"driver",
"transfer",
"trip"
],
"type": "string"
},
"currency": {
"enum": [
"EUR"
],
"type": "string"
},
"notFound": {
"type": "array",
"items": {
"type": "string"
}
},
"resolved": {
"type": "array",
"items": {
"type": "object",
"required": [
"asked",
"id",
"kind",
"name",
"how"
],
"properties": {
"id": {
"type": "string"
},
"how": {
"enum": [
"id",
"name",
"typo",
"partial",
"event"
],
"type": "string"
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"asked": {
"type": "string"
},
"place": {
"type": "string"
}
}
}
},
"services": {
"type": "array",
"items": {
"type": "object",
"required": [
"service",
"title",
"details",
"servicePrice",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"date": {
"type": "string",
"format": "date"
},
"time": {
"type": "string"
},
"drive": {
"type": "object",
"required": [
"km",
"minutes"
],
"properties": {
"km": {
"type": "number"
},
"minutes": {
"type": "number"
}
}
},
"title": {
"type": "string"
},
"option": {
"enum": [
"half",
"full",
"long"
],
"type": "string"
},
"details": {
"type": "array",
"items": {
"type": "string"
}
},
"luggage": {
"type": "integer"
},
"service": {
"enum": [
"wine-tour",
"driver",
"transfer"
],
"type": "string"
},
"extraHours": {
"type": "integer",
"minimum": 0
},
"availability": {
"type": "object",
"required": [
"state"
],
"properties": {
"state": {
"enum": [
"free",
"pending",
"busy"
],
"type": "string"
},
"nextFree": {
"type": "array",
"items": {
"type": "string",
"format": "date"
}
},
"conflicts": {
"type": "array",
"items": {
"type": "object",
"required": [
"item",
"date",
"from",
"to",
"state"
],
"properties": {
"to": {
"type": "string"
},
"date": {
"type": "string",
"format": "date"
},
"from": {
"type": "string"
},
"item": {
"type": "integer"
},
"state": {
"enum": [
"pending",
"busy"
],
"type": "string"
}
}
}
}
}
},
"optionRaised": {
"type": "object",
"required": [
"from",
"to",
"reason"
],
"properties": {
"to": {
"enum": [
"half",
"full",
"long"
],
"type": "string"
},
"from": {
"enum": [
"half",
"full",
"long"
],
"type": "string"
},
"reason": {
"type": "string"
},
"extraHours": {
"type": "integer",
"minimum": 0
}
}
},
"servicePrice": {
"type": "number"
}
}
}
},
"carRaised": {
"type": "object",
"required": [
"from",
"to",
"reason"
],
"properties": {
"to": {
"enum": [
"polestar",
"eclass",
"vclass"
],
"type": "string"
},
"from": {
"type": "string"
},
"reason": {
"type": "string"
}
}
},
"maxGuests": {
"type": "integer"
},
"pricesUrl": {
"type": "string",
"format": "uri"
},
"extraHours": {
"type": "integer",
"minimum": 0
},
"perVehicle": {
"type": "boolean"
},
"alternatives": {
"type": "array",
"items": {
"type": "object",
"required": [
"label",
"price",
"bookUrl",
"why"
],
"properties": {
"why": {
"type": "string"
},
"label": {
"type": "string"
},
"price": {
"type": "number"
},
"bookUrl": {
"type": "string",
"format": "uri"
}
}
}
},
"availability": {
"type": "object",
"required": [
"state"
],
"properties": {
"state": {
"enum": [
"free",
"pending",
"busy"
],
"type": "string"
},
"nextFree": {
"type": "array",
"items": {
"type": "string",
"format": "date"
}
},
"conflicts": {
"type": "array",
"items": {
"type": "object",
"required": [
"item",
"date",
"from",
"to",
"state"
],
"properties": {
"to": {
"type": "string"
},
"date": {
"type": "string",
"format": "date"
},
"from": {
"type": "string"
},
"item": {
"type": "integer"
},
"state": {
"enum": [
"pending",
"busy"
],
"type": "string"
}
}
}
}
}
},
"optionRaised": {
"type": "object",
"required": [
"from",
"to",
"reason"
],
"properties": {
"to": {
"enum": [
"half",
"full",
"long"
],
"type": "string"
},
"from": {
"enum": [
"half",
"full",
"long"
],
"type": "string"
},
"reason": {
"type": "string"
},
"extraHours": {
"type": "integer",
"minimum": 0
}
}
},
"servicePrice": {
"type": "number"
},
"tastingsIncluded": {
"type": "boolean"
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}plan_wine_day — Plan a wine day
A timed wine day through the places asked: its length (with the extra hours their distance needs), the stops in order, the drives from and back to Beaune (or from), lunch where the day reaches midday (at a starred table among the stops, else a slot with the starred tables near it), the end time, the price for the guests and their car (the V-Class beyond 4), the page of that wine day (url) and a booking link.
{
"type": "object",
"required": [
"stops"
],
"properties": {
"car": {
"enum": [
"polestar",
"eclass",
"vclass"
],
"type": "string",
"description": "polestar (included), eclass (4 guests) or vclass (7): the Mercedes on request, a supplement per day of service."
},
"date": {
"type": "string",
"format": "date"
},
"from": {
"enum": [
"beaune",
"dijon",
"lyon",
"paris",
"geneva",
"creusot",
"lfsd",
"lfgj",
"lfgf",
"lfgz",
"lflh",
"lfgi",
"lfep",
"macon",
"chalon",
"reims",
"epernay",
"troyes",
"colmar",
"strasbourg",
"besancon",
"arbois",
"annecy",
"chamonix",
"avignon"
],
"type": "string",
"description": "Start and end (default beaune)."
},
"lang": {
"enum": [
"en",
"fr",
"de",
"zh",
"ar"
],
"type": "string",
"description": "ar: Arabic notes, data in English."
},
"time": {
"type": "string",
"pattern": "^\\d\\d:\\d\\d$",
"description": "Pickup."
},
"lunch": {
"type": "string",
"maxLength": 120,
"description": "\"yes\", or a place to have lunch near."
},
"stops": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120
},
"maxItems": 12,
"description": "Place ids or names."
},
"guests": {
"type": "integer",
"maximum": 7,
"minimum": 1
}
}
}{
"type": "object",
"required": [
"day",
"extraHours",
"hours",
"start",
"end",
"guests",
"car",
"price",
"payment",
"deposit",
"schedule",
"legs",
"stops",
"resolved",
"notFound",
"url",
"pricesUrl",
"bookUrl",
"note"
],
"properties": {
"car": {
"type": "object",
"required": [
"id",
"name",
"seats",
"onRequest",
"supplementPerDay",
"days",
"supplement"
],
"properties": {
"id": {
"enum": [
"polestar",
"eclass",
"vclass"
],
"type": "string"
},
"days": {
"type": "integer",
"minimum": 1
},
"name": {
"type": "string"
},
"seats": {
"type": "integer"
},
"onRequest": {
"type": "boolean"
},
"supplement": {
"type": "number"
},
"supplementPerDay": {
"type": "number"
}
}
},
"day": {
"enum": [
"half",
"full",
"long"
],
"type": "string"
},
"end": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"legs": {
"type": "array",
"items": {
"type": "object",
"required": [
"from",
"to",
"minutes"
],
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
},
"minutes": {
"type": "number"
}
}
}
},
"note": {
"type": "string"
},
"hours": {
"type": "integer"
},
"lunch": {
"type": "object",
"required": [
"at",
"until",
"near",
"tables",
"note"
],
"properties": {
"at": {
"type": "string"
},
"near": {
"type": "string"
},
"note": {
"type": "string"
},
"until": {
"type": "string"
},
"tables": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"commune",
"stars",
"menuFrom",
"distanceKm"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"stars": {
"type": "integer"
},
"commune": {
"type": "string"
},
"menuFrom": {
"type": [
"number",
"null"
]
},
"distanceKm": {
"type": "number"
}
}
}
}
}
},
"price": {
"type": "number"
},
"start": {
"type": "string"
},
"stops": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"kind",
"name",
"line"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"enum": [
"village",
"chateau",
"sight",
"restaurant"
],
"type": "string"
},
"line": {
"type": "string"
},
"name": {
"type": "string"
}
}
}
},
"guests": {
"type": "integer"
},
"bookUrl": {
"type": "string",
"format": "uri"
},
"deposit": {
"type": "number",
"deprecated": true
},
"payment": {
"enum": [
"in full when the driver confirms"
],
"type": "string"
},
"notFound": {
"type": "array",
"items": {
"type": "string"
}
},
"resolved": {
"type": "array",
"items": {
"type": "object",
"required": [
"asked",
"id",
"kind",
"name",
"how"
],
"properties": {
"id": {
"type": "string"
},
"how": {
"enum": [
"id",
"name",
"typo",
"partial",
"event"
],
"type": "string"
},
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"asked": {
"type": "string"
},
"place": {
"type": "string"
}
}
}
},
"schedule": {
"type": "array",
"items": {
"type": "object",
"required": [
"time",
"kind"
],
"properties": {
"kind": {
"enum": [
"pickup",
"visit",
"lunch",
"back"
],
"type": "string"
},
"time": {
"type": "string"
},
"place": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
}
},
"until": {
"type": "string"
}
}
}
},
"pricesUrl": {
"type": "string",
"format": "uri"
},
"extraHours": {
"type": "integer",
"minimum": 0
},
"availability": {
"type": "object",
"required": [
"state"
],
"properties": {
"state": {
"enum": [
"free",
"pending",
"busy"
],
"type": "string"
},
"nextFree": {
"type": "array",
"items": {
"type": "string",
"format": "date"
}
},
"conflicts": {
"type": "array",
"items": {
"type": "object",
"required": [
"item",
"date",
"from",
"to",
"state"
],
"properties": {
"to": {
"type": "string"
},
"date": {
"type": "string",
"format": "date"
},
"from": {
"type": "string"
},
"item": {
"type": "integer"
},
"state": {
"enum": [
"pending",
"busy"
],
"type": "string"
}
}
}
}
}
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}find_trips — Find rides over several days
The private driver's rides over one to seven days from Beaune, in plans (where the travellers arrive, the pace): the driver meets them at a station or airport, drives them to the vineyards, abbeys or tables and back. Each plan is priced per vehicle as the sum of its rides; transport only: hotels, tastings, meals and tickets are booked and paid by the traveller (Côte Privée sells no package). startDate dates each ride and the booking link; request_booking takes the plan's id as trip. 6 results unless limit, cheapest first.
{
"type": "object",
"properties": {
"days": {
"type": "integer",
"maximum": 7,
"minimum": 1
},
"lang": {
"enum": [
"en",
"fr",
"de",
"zh",
"ar"
],
"type": "string",
"description": "ar: Arabic notes, data in English."
},
"pace": {
"enum": [
"light",
"full"
],
"type": "string",
"description": "light: one or two outings a day; full: with wine days."
},
"limit": {
"type": "integer",
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 200
},
"theme": {
"enum": [
"first",
"nuits",
"whites",
"chablis",
"south",
"heritage",
"food",
"family",
"cycling",
"seasons",
"journeys"
],
"type": "string"
},
"arrive": {
"enum": [
"beaune",
"dijon",
"lyon",
"paris",
"geneva",
"creusot",
"lfsd",
"lfgj",
"lfgf",
"lfgz",
"lflh",
"lfgi",
"lfep",
"macon",
"chalon",
"reims",
"epernay",
"troyes",
"colmar",
"strasbourg",
"besancon",
"arbois",
"annecy",
"chamonix",
"avignon",
"air"
],
"type": "string",
"description": "beaune (its station or the hotel), dijon (Dijon-Ville: the TGV from Paris), paris (collected in Paris), an airport or airfield, or air for any."
},
"maxPrice": {
"type": "integer",
"maximum": 100000,
"minimum": 0
},
"startDate": {
"type": "string",
"format": "date"
}
}
}{
"type": "object",
"required": [
"count",
"trips"
],
"properties": {
"count": {
"type": "integer",
"minimum": 0
},
"trips": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"itinerary",
"variant",
"title",
"days",
"pace",
"theme",
"arrive",
"depart",
"route",
"price",
"currency",
"perVehicle",
"payment",
"deposit",
"services",
"plan",
"url",
"markdown",
"bookUrl"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"days": {
"type": "integer",
"maximum": 7,
"minimum": 1
},
"pace": {
"enum": [
"light",
"full"
],
"type": "string"
},
"plan": {
"type": "array",
"items": {
"type": "object",
"required": [
"day",
"title",
"legs"
],
"properties": {
"day": {
"type": "integer"
},
"legs": {
"type": "array",
"items": {
"type": "object",
"required": [
"title",
"detail"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"note": {
"type": "string"
},
"time": {
"type": "string"
},
"price": {
"type": "number"
},
"title": {
"type": "string"
},
"until": {
"type": "string"
},
"detail": {
"type": "string"
},
"places": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri"
},
"name": {
"type": "string"
}
}
}
}
}
}
},
"title": {
"type": "string"
}
}
}
},
"price": {
"type": "number"
},
"route": {
"type": "string"
},
"theme": {
"enum": [
"first",
"nuits",
"whites",
"chablis",
"south",
"heritage",
"food",
"family",
"cycling",
"seasons",
"journeys"
],
"type": "string"
},
"title": {
"type": "string"
},
"arrive": {
"type": "string"
},
"depart": {
"type": "string"
},
"bookUrl": {
"type": "string",
"format": "uri"
},
"deposit": {
"type": "number",
"deprecated": true
},
"endDate": {
"type": "string",
"format": "date"
},
"payment": {
"enum": [
"in full when the driver confirms"
],
"type": "string"
},
"summary": {
"type": "string"
},
"variant": {
"type": "string"
},
"currency": {
"enum": [
"EUR"
],
"type": "string"
},
"markdown": {
"type": "string",
"format": "uri"
},
"services": {
"type": "array",
"items": {
"type": "object",
"required": [
"day",
"service",
"title",
"price"
],
"properties": {
"day": {
"type": "integer"
},
"date": {
"type": "string",
"format": "date"
},
"price": {
"type": "number"
},
"title": {
"type": "string"
},
"service": {
"type": "string"
}
}
}
},
"itinerary": {
"type": "string"
},
"startDate": {
"type": "string",
"format": "date"
},
"themeName": {
"type": "string"
},
"perVehicle": {
"type": "boolean"
}
}
}
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}request_booking — Send a booking request
Sends a booking request as the booking page does, once the traveller has seen the price and accepted the terms of sale (https://www.cote-privee.com/terms): one service (the fields of quote, with date, time and pickup), several (items) or a plan of find_trips (trip, startDate), and the traveller's details. Nothing is charged: the traveller gets the request by e-mail, and the driver confirms it by e-mail and says how to pay the full price, or declines it (next says it for this request; payment: "in full when the driver confirms"). dry_run checks and prices without sending; the same request within a day, or the same requestId, answers the same reference. Only valid requests count against the limits; a refusal names each argument to fix and what is allowed (retryAfter after a limit).
{
"type": "object",
"required": [
"name",
"email",
"phone",
"accept_terms"
],
"properties": {
"to": {
"type": "string",
"maxLength": 200
},
"car": {
"enum": [
"polestar",
"eclass",
"vclass"
],
"type": "string"
},
"back": {
"enum": [
"none",
"wait",
"later",
"day"
],
"type": "string"
},
"date": {
"type": "string",
"format": "date"
},
"from": {
"enum": [
"beaune",
"dijon",
"lyon",
"paris",
"geneva",
"creusot",
"lfsd",
"lfgj",
"lfgf",
"lfgz",
"lflh",
"lfgi",
"lfep",
"macon",
"chalon",
"reims",
"epernay",
"troyes",
"colmar",
"strasbourg",
"besancon",
"arbois",
"annecy",
"chamonix",
"avignon"
],
"type": "string"
},
"lang": {
"enum": [
"en",
"fr",
"de",
"zh",
"ar"
],
"type": "string",
"description": "ar: Arabic notes, data in English."
},
"name": {
"type": "string",
"maxLength": 120
},
"stop": {
"type": "string",
"maxLength": 120
},
"time": {
"type": "string",
"pattern": "^\\d\\d:\\d\\d$"
},
"trip": {
"type": "string",
"maxLength": 80,
"description": "A plan id of find_trips."
},
"email": {
"type": "string",
"format": "email",
"maxLength": 160
},
"hours": {
"type": "integer",
"maximum": 12,
"minimum": 3
},
"items": {
"type": "array",
"items": {
"type": "object"
},
"maxItems": 6,
"description": "Several services (at most 6), each with the fields above."
},
"notes": {
"type": "string",
"maxLength": 1500
},
"phone": {
"type": "string",
"maxLength": 40
},
"route": {
"type": "string",
"maxLength": 120
},
"stops": {
"type": "array",
"items": {
"type": "string",
"maxLength": 120
},
"maxItems": 12
},
"flight": {
"type": "string",
"maxLength": 20,
"description": "Flight or train."
},
"guests": {
"type": "integer",
"maximum": 7,
"minimum": 1
},
"option": {
"enum": [
"half",
"full",
"long"
],
"type": "string"
},
"pickup": {
"type": "string",
"maxLength": 300,
"description": "Pickup address (a hotel, a street) at the start of a ride or of the day."
},
"dropoff": {
"type": "string",
"maxLength": 300,
"description": "A ride: where the car leaves the guests (a hotel)."
},
"dry_run": {
"type": "boolean"
},
"luggage": {
"type": "integer",
"maximum": 6,
"minimum": 0
},
"service": {
"enum": [
"wine-tour",
"driver",
"transfer"
],
"type": "string"
},
"direction": {
"enum": [
"to",
"from"
],
"type": "string"
},
"requestId": {
"type": "string",
"maxLength": 64,
"description": "8 to 64 letters, digits, - or _."
},
"startDate": {
"type": "string",
"format": "date",
"description": "The plan's first day."
},
"stopHours": {
"type": "integer",
"maximum": 3,
"minimum": 1
},
"extraHours": {
"type": "integer",
"maximum": 3,
"minimum": 0
},
"returnDate": {
"type": "string",
"format": "date"
},
"returnTime": {
"type": "string",
"pattern": "^\\d\\d:\\d\\d$"
},
"returnTrip": {
"type": "boolean"
},
"returnLater": {
"type": "boolean"
},
"accept_terms": {
"type": "boolean",
"description": "true only once the traveller has accepted the terms of sale."
},
"returnFlight": {
"type": "string",
"maxLength": 20
}
}
}{
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}get_booking_status — Status of a booking request
What became of a booking request: requested (no answer yet), confirmed (with the payment link of the full price once it can be paid), declined (with the driver's note), deposit_paid (paid in full) or cancelled, its days and its total. Needs the reference and the e-mail address of the request.
{
"type": "object",
"required": [
"ref",
"email"
],
"properties": {
"ref": {
"type": "string",
"maxLength": 20,
"description": "CP-XXX-XXX"
},
"lang": {
"enum": [
"en",
"fr",
"de",
"zh",
"ar"
],
"type": "string",
"description": "ar: Arabic notes, data in English."
},
"email": {
"type": "string",
"format": "email",
"maxLength": 160
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}Prompts
1 advertised
plan_burgundy_day — Plan a day in Burgundy
A day with the private driver from Beaune: places that suit the travellers' interests, the right length of day, the price per vehicle and the booking link.
- date
- Day of the trip, YYYY-MM-DD.
- guests
- Number of travellers, 1 to 7 (more than 4 travel in the Mercedes V-Class, on request).
- interests
- What they would like to see or do, e.g. "grand cru villages, a château, lunch".
- base
- Where they stay, e.g. "Beaune" or a hotel.
Resources
3 advertised
llms.txt — Côte Privée for AI assistants
The map of the site: services and prices, quick answers, key places, how to book, and the files and tools for agents.
https://www.cote-privee.com/llms.txtprices.json — Prices per vehicle
Every price per vehicle: wine days, driver by the hour, transfers, the cheapest trip from Beaune and when the price is paid.
https://www.cote-privee.com/data/prices.jsonfaq.md — Frequently asked questions
The FAQ of the site in Markdown: booking and payment, wine tours, transfers, getting around, the driver and the car.
https://www.cote-privee.com/md/faq.md90-day uptime
A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.
- 2026-11-02: 1 of 1 checks answered
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1413 ms
- 95th percentile latency
- 1413 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1413 ms · metadata changed · 11 tool(s), 3 resource(s), 0 resource template(s), 1 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http co-te-prive-e-mcp https://www.cote-privee.com/mcpCodex
codex mcp add co-te-prive-e-mcp --url https://www.cote-privee.com/mcpCursor
{
"mcpServers": {
"co-te-prive-e-mcp": {
"url": "https://www.cote-privee.com/mcp"
}
}
}Cline
{
"mcpServers": {
"co-te-prive-e-mcp": {
"type": "streamableHttp",
"url": "https://www.cote-privee.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"co-te-prive-e-mcp": {
"type": "http",
"url": "https://www.cote-privee.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http co-te-prive-e-mcp https://www.cote-privee.com/mcpClaude Desktop
{
"mcpServers": {
"co-te-prive-e-mcp": {
"url": "https://www.cote-privee.com/mcp"
}
}
}Windsurf
{
"mcpServers": {
"co-te-prive-e-mcp": {
"serverUrl": "https://www.cote-privee.com/mcp"
}
}
}Let your agent find its tools
Find servers like Côte Privée MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other commerce servers
Do you run Côte Privée MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.