Samuelz Chauffeur Booking

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Public chauffeur prices, policy and consent-led offers for travel bookers and AI assistants.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Samuelz Chauffeur Booking": {
      "url": "https://platform-api.samuelz.com/api/v1/mcp/chauffeur/samuelz-chauffeur",
      "transport": "streamable-http"
    }
  }
}

Measured tools (5)

• get_service_options read-only

  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.

  Parameters:

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

  Hints: read-only yes · destructive no · idempotent yes · open-world no

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

  Parameters:

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

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• quote_ride read-only

  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.

  Parameters:

  • ride (required) — 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.

  Hints: read-only yes · destructive no · idempotent no · open-world yes

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

  Parameters:

  • submissionId (required) — string — 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.
  • resumeToken (required) — 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.
  • offerRequested (required) — boolean — True only after the customer explicitly asks for an offer.
  • contact (required) — object — Customer email or phone for this requested offer.
  • ride (required) — 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.
  • firstTouchTrackingToken — string — Existing first-touch token. Never invent one.
  • distributionPartnerCapability — string — Existing dp_live_ partner token. Omit for customers.

  Hints: read-only no · destructive no · idempotent yes · open-world yes

• get_offer_status read-only

  Use this when recovering a submitted offer after a timeout or on return. Do not use for new requests (use prepare_offer instead). For rides A then B, pair A's submissionId with A's resumeToken to read A, even after B. Recovery preserves the original language: there is no locale override. pending: retry after retryAfterSeconds; prepared: private checkout/terms links; available: recorded booking state. not_found does not prove creation failed: check the pair and provider before another attempt. The private pair authorizes this stored read without login and expires 24 hours after first submission. There is no provider refresh. Recorded flags do not prove fresh payment or availability.

  Parameters:

  • submissionId (required) — 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.
  • resumeToken (required) — 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.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.