check_availability

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.

read-only

Argument	Type	Description
date*	string
days	integer
lang	string	ar: Arabic notes, data in English.
time	string	Pickup.
service	string

Input schema (JSON)

{
  "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"
    }
  }
}

find_events

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.

read-only

Argument	Type	Description
to	string	Default a year after from.
from	string	Default today.
lang	string	ar: Arabic notes, data in English.
limit	integer
query	string	Words, e.g. "Hospices", "jazz".
origin	string	Start of the driver quote (default beaune).

Input schema (JSON)

{
  "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"
      ],
      "type": "string",
      "description": "Start of the driver quote (default beaune)."
    }
  }
}

find_packages

Ready-made trips of one to seven days from Beaune, in plans (where the travellers arrive, the pace): the driver meets them at a station or airport, takes them to the vineyards, abbeys or tables and back. Each plan is priced per vehicle as the sum of its services; hotels, tastings, meals and visits are the traveller's own. startDate dates each service and the booking link; request_booking takes the plan's id as package. 6 results unless limit, cheapest first.

read-only

Argument	Type	Description
days	integer
lang	string	ar: Arabic notes, data in English.
pace	string	light: one or two outings a day; full: with wine days.
limit	integer
query	string
theme	string
arrive	string	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	integer
startDate

get_booking_status

What became of a booking request: requested (no answer yet), confirmed (with the deposit link once it can be paid), declined (with the driver's note), deposit_paid or cancelled, its days and amounts. Needs the reference and the e-mail address of the request.

read-only

Argument	Type	Description
ref*	string	CP-XXX-XXX
lang	string	ar: Arabic notes, data in English.
email*	string

Input schema (JSON)

{
  "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
    }
  }
}

get_page

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.

read-only

Argument	Type	Description
id	string	Same as ref.
ref	string	An id, address, path or name.
url	string	Same as ref.
lang	string	ar: Arabic notes, data in English.
path	string	Same as ref.

Input schema (JSON)

{
  "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."
    }
  }
}

get_policies

The booking rules as facts: the cars and the guests each takes, deposit, 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.

read-only

Argument	Type	Description
lang	string	ar: Arabic notes, data in English.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "lang": {
      "enum": [
        "en",
        "fr",
        "de",
        "zh",
        "ar"
      ],
      "type": "string",
      "description": "ar: Arabic notes, data in English."
    }
  }
}

get_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, the deposit rate. Tastings are paid to the estates.

read-only

Argument	Type	Description
lang	string	ar: Arabic notes, data in English.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "lang": {
      "enum": [
        "en",
        "fr",
        "de",
        "zh",
        "ar"
      ],
      "type": "string",
      "description": "ar: Arabic notes, data in English."
    }
  }
}

plan_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.

read-only

Argument	Type	Description
car	string	polestar (included), eclass (4 guests) or vclass (7): the Mercedes on request, a supplement per day of service.
date	string
from	string	Start and end (default beaune).
lang	string	ar: Arabic notes, data in English.
time	string	Pickup.
lunch	string	"yes", or a place to have lunch near.
stops*	array	Place ids or names.
guests	integer

Input schema (JSON)

quote

The exact price the booking page charges for one service, or a whole trip (items: one total, one deposit), 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), or to from Beaune or from; returnTrip: the driver waits up to 3 h; returnLater: back later (2 rides). Transfer: route (its id, its page slug such as lyon-beaune, or a name such as "Lyon airport"), or from and to. 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.

read-only

Argument	Type	Description
to	string	A place id or name, or event:<id>.
car	string	polestar (included), eclass (4 guests) or vclass (7): the Mercedes on request, a supplement per day of service.
date	string
from	string	Start of a driver trip, or of a transfer to another place; airfields by ICAO code.
lang	string	ar: Arabic notes, data in English.
time	string	Pickup (a transfer to Beaune: the arrival).

request_booking

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_packages (package, startDate), and the traveller's details. Nothing is charged: the traveller gets the request by e-mail, the driver confirms or declines it, and the confirmation says how to pay the 30% deposit (next says it for this request). 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).

Argument	Type	Description
to	string
car	string
date	string
from	string
lang	string	ar: Arabic notes, data in English.
name*	string
time	string
email*	string
hours

search_places

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 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.

read-only

Argument	Type	Description
area	string	cote: Côtes de Nuits and de Beaune; north: Chablis, Yonne, Auxois; south: Chalonnais, Mâconnais.
kind	string
lang	string	ar: Arabic notes, data in English.
near	string	A place id or name.
limit	integer
query	string	Words in names, communes and summaries, e.g. "abbey", "grand cru".
compact	boolean
radiusKm	integer	Default 10.

Input schema (JSON)

Côte Privée: private driver in Burgundy

Try it

check_availability Read-only

Côte Privée: private driver in Burgundy

Try it

check_availability Read-only

Tools (11)