Samuelz Chauffeur Booking

Working · 3.6 s

io.github.samuelzcom/chauffeur-bookingv1.1.0

Chauffeur price previews and consent-led offers for the provider's published service areas.

Local Services

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://platform-api.samuelz.com/api/v1/mcp/chauffeur/samuelz-chauffeur

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_customer_policy Read-only

Use this when checking Samuelz Chauffeur lead time, account requirements and booking confirmation terms. Do not use for service coverage (use get_service_options instead). Returns available with observedAt and terms, or unavailable. Lead time is in minutes; interpret dates in the returned time zone and revalidate terms on the eventual offer. This cheap, repeatable read creates nothing. Pass a published offerKey for its location’s terms; omit it for default policy.

localestring

Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility.

offerKeystring

Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant.

Tools (5)

Tool list last changed Oct 25, 2026.

get_customer_policy

read-only

Argument	Type	Description
locale	string	Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility.
offerKey	string	Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "locale": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "default": "en",
      "description": "Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility."
    },
    "offerKey": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$",
      "description": "Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant."
    }
  },
  "additionalProperties": false
}

get_offer_status

Use this when reading a submitted offer's stored status. Do not use for new requests (use prepare_offer instead). Reuse the original submissionId/resumeToken: this provider's proof expires 24 hours after the first submission. prepared returns private checkout/terms links; available returns recorded booking, payment and assignment fields. Each call reads stored data without provider refresh. Expired or invalid proof can return not_found.

read-only

Argument	Type	Description
resumeToken*	string	Original private 64-character hexadecimal resumeToken sent with this submissionId. Reuse it unchanged; never generate a replacement. Expired, invalid or foreign-provider proof can return not_found without proving that no booking exists.
submissionId*	string	Original submissionId UUID sent to prepare_offer for this attempt, including when its response was lost. Reuse it with the original resumeToken; do not generate a new ID or substitute a booking ID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "submissionId",
    "resumeToken"
  ],
  "properties": {
    "resumeToken": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$",
      "description": "Original private 64-character hexadecimal resumeToken sent with this submissionId. Reuse it unchanged; never generate a replacement. Expired, invalid or foreign-provider proof can return not_found without proving that no booking exists."
    },
    "submissionId": {
      "type": "string",
      "format": "uuid",
      "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      "description": "Original submissionId UUID sent to prepare_offer for this attempt, including when its response was lost. Reuse it with the original resumeToken; do not generate a new ID or substitute a booking ID."
    }
  },
  "additionalProperties": false
}

get_service_options

Use this when discovering Samuelz Chauffeur services, areas and time zones. Do not use for terms (use get_customer_policy instead). Keep offerKey and locale across policy/price calls so location and language agree; omit the key for discovery. Returns available or unavailable. Anonymous stored read; no price, availability confirmation or writes.

read-only

Argument	Type	Description
locale	string	Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility.
offerKey	string	Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "locale": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "default": "en",
      "description": "Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility."
    },
    "offerKey": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$",
      "description": "Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant."
    }
  },
  "additionalProperties": false
}

prepare_offer

Use this when preparing a customer-requested unpaid Samuelz Chauffeur offer (offerRequested=true). Do not use for prices (use quote_ride instead). Supply email or E.164 phone. Bind submissionId/resumeToken to unchanged ride, contact, locale, offerKey and partner context. Intake and unpaid state may persist after disconnect. Recover with get_offer_status and the original pair. prepared returns private checkoutUrl for customer confirmation/payment before offer.expiresAt. Wait retryAfterSeconds if given; review conflict/ambiguous. This call does not charge or confirm, dispatch or send messages.

Argument	Type	Description
ride*	object	Pickup, destination, local date, time and passengers.
locale	string	Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility.
contact*	object	Customer email or phone for this requested offer.
offerKey	string	Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant.
resumeToken*	string	Caller-generated private secret of 64 hexadecimal characters. Generate once, retain it with submissionId for recovery, and never share the pair publicly or replace it on uncertain retries.

quote_ride

Use this when pricing a complete anonymous Samuelz Chauffeur ride. Do not use for discovery (use get_service_options instead); check terms with get_customer_policy. Keep offerKey across these calls; it determines the local calendar/time zone. Return pickup must follow outbound pickup; hourly service cannot include a return. vehiclePreference and specialRequests share 500 characters, including the added 'Vehicle preference: ' prefix and newline. quoted is no reservation or availability promise; outside_service_area has no price; review_required needs review. No login/contact. Repeats consume the shared REST/MCP budget; wait retryAfterSeconds on rate_limited.

read-only

Argument	Type	Description
ride*	object	Pickup, destination, local date, time and passengers.
locale	string	Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility.
offerKey	string	Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant.
specialRequests	string	Optional requirements, at most 500 characters.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "ride"
  ],
  "properties": {
    "ride": {
      "type": "object",
      "required": [
        "pickup",
        "destination",
        "date",
        "time",
        "passengers",
        "tripType"
      ],
      "properties": {
        "date": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "description": "Service date as YYYY-MM-DD, for example 2026-12-24, in the selected location’s time zone; do not convert it to a UTC date."
        },
        "time": {
          "type": "string",
          "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
          "description": "Local pickup time in 24-hour HH:mm format, for example 14:30, in the selected location’s time zone."
        },
        "hours": {
          "type": "integer",
          "maximum": 24,
          "minimum": 1,
          "description": "Whole service hours from 1 to 24, for example 3. Required only for serviceType=hourly; omit for transfers. Billable hours may differ after price calculation."
        },
        "pickup": {
          "type": "string",
          "maxLength": 240,
          "minLength": 2,
          "description": "Pickup place with city or postcode, inside a served area."
        },
        "luggage": {
          "type": "string",
          "maxLength": 240,
          "minLength": 1,
          "description": "Luggage notes. Unusual items may need review."
        },
        "tripType": {
          "enum": [
            "one_way",
            "return"
          ],
          "type": "string",
          "description": "one_way, or return with a later pickup."
        },
        "passengers": {
          "type": "integer",
          "maximum": 60,
          "minimum": 1,
          "description": "Number of people travelling, from 1 to 60."
        },
        "returnDate": {
          "type": "string",
          "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
          "description": "Return date YYYY-MM-DD, only for a return trip."
        },
        "returnTime": {
          "type": "string",
          "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$",
          "description": "Return time HH:mm, only for a return trip."
        },
        "destination": {
          "type": "string",
          "maxLength": 240,
          "minLength": 2,
          "description": "Destination with city or postcode, distinct from pickup."
        },
        "serviceType": {
          "enum": [
            "hourly"
          ],
          "type": "string",
          "description": "Set hourly for duration service; omit for transfers."
        },
        "flightNumber": {
          "type": "string",
          "maxLength": 240,
          "minLength": 1,
          "description": "Flight number for an airport pickup, if known."
        },
        "vehiclePreference": {
          "type": "string",
          "maxLength": 240,
          "minLength": 1,
          "description": "Optional vehicle wish, without a price guarantee."
        }
      },
      "description": "Pickup, destination, local date, time and passengers.",
      "additionalProperties": false
    },
    "locale": {
      "enum": [
        "de",
        "en"
      ],
      "type": "string",
      "default": "en",
      "description": "Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility."
    },
    "offerKey": {
      "type": "string",
      "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$",
      "description": "Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant."
    },
    "specialRequests": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Optional requirements, at most 500 characters."
    }
  },
  "additionalProperties": false
}

{ "type": "object", "$schema": "https://json-schema.org/draft/2020-12/schema", "required": [ "submissionId", "resumeToken", "offerRequested", "contact", "ride" ], "properties": { "ride": { "type": "object", "required": [ "pickup", "destination", "date", "time", "passengers", "tripType" ], "properties": { "date": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "description": "Service date as YYYY-MM-DD, for example 2026-12-24, in the selected location’s time zone; do not convert it to a UTC date." }, "time": { "type": "string", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$", "description": "Local pickup time in 24-hour HH:mm format, for example 14:30, in the selected location’s time zone." }, "hours": { "type": "integer", "maximum": 24, "minimum": 1, "description": "Whole service hours from 1 to 24, for example 3. Required only for serviceType=hourly; omit for transfers. Billable hours may differ after price calculation." }, "pickup": { "type": "string", "maxLength": 240, "minLength": 2, "description": "Pickup place with city or postcode, inside a served area." }, "luggage": { "type": "string", "maxLength": 240, "minLength": 1, "description": "Luggage notes. Unusual items may need review." }, "tripType": { "enum": [ "one_way", "return" ], "type": "string", "description": "one_way, or return with a later pickup." }, "passengers": { "type": "integer", "maximum": 60, "minimum": 1, "description": "Number of people travelling, from 1 to 60." }, "returnDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "description": "Return date YYYY-MM-DD, only for a return trip." }, "returnTime": { "type": "string", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$", "description": "Return time HH:mm, only for a return trip." }, "destination": { "type": "string", "maxLength": 240, "minLength": 2, "description": "Destination with city or postcode, distinct from pickup." }, "serviceType": { "enum": [ "hourly" ], "type": "string", "description": "Set hourly for duration service; omit for transfers." }, "flightNumber": { "type": "string", "maxLength": 240, "minLength": 1, "description": "Flight number for an airport pickup, if known." }, "vehiclePreference": { "type": "string", "maxLength": 240, "minLength": 1, "description": "Optional vehicle wish, without a price guarantee." } }, "description": "Pickup, destination, local date, time and passengers.", "additionalProperties": false }, "locale": { "enum": [ "de", "en" ], "type": "string", "default": "en", "description": "Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility." }, "contact": { "type": "object", "properties": { "email": { "type": "string", "format": "email", "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "maxLength": 254, "description": "Customer email, required when no phone is given." }, "phone": { "type": "string", "pattern": "^\\+[1-9][0-9]{6,14}$", "description": "E.164 phone, required when no email is given." }, "fullName": { "type": "string", "maxLength": 120, "minLength": 2, "description": "Optional customer name, 2 to 120 characters." } }, "description": "Customer email or phone for this requested offer.", "additionalProperties": false }, "offerKey": { "type": "string", "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$", "description": "Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant." }, "resumeToken": { "type": "string", "pattern": "^[a-f0-9]{64}$", "description": "Caller-generated private secret of 64 hexadecimal characters. Generate once, retain it with submissionId for recovery, and never share the pair publicly or replace it on uncertain retries." }, "submissionId": { "type": "string", "format": "uuid", "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$", "description": "Create one UUID for one explicitly requested offer, for example 123e4567-e89b-42d3-a456-426614174000. Retain it with the original resumeToken and unchanged request on retries." }, "offerRequested": { "type": "boolean", "const": true, "description": "True only after the customer explicitly asks for an offer." }, "specialRequests": { "type": "string", "maxLength": 500, "minLength": 1, "description": "Optional requirements, at most 500 characters." }, "firstTouchTrackingToken": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "description": "Existing first-touch token. Never invent one." }, "distributionPartnerCapability": { "type": "string", "pattern": "^dp_live_[a-f0-9]{64}$", "description": "Existing dp_live_ partner token. Omit for customers." } }, "additionalProperties": false }