{ "openapi": { "info": { "description": "Public customer information, price previews and capability-bound offer preparation. No login or API key required. Prepared offers remain unpaid and require explicit customer confirmation on checkoutUrl. REST and MCP share the same tenant quote budget. Retry only after Retry-After on HTTP 429.", "title": "Chauffeur customer API", "version": "1.0.0" }, "openapi": "3.1.0", "paths": { "/offers/prepare": { "post": { "description": "Use only for an explicit offer request with offerRequested=true, complete ride facts and email OR E.164 phone. Creates one unpaid draft and an offer link; the customer reviews bound terms and confirms via checkoutUrl. No charge or booking confirmation. Use quote_ride for price-only questions. Keep submissionId, resumeToken and inputs unchanged on retries; inspect get_offer_status on ambiguous/conflict. On rate_limited wait retryAfterSeconds. Changed facts need an explicitly requested new intent; expired or revised offers require current review.", "operationId": "chauffeur_offers/prepare", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "contact": { "additionalProperties": false, "description": "Customer/booker contact for this explicitly requested offer: email OR E.164 phone is required. Contact does not authorize private booking/history access.", "properties": { "email": { "description": "Reachable customer/booker email, at most 254 characters; required if no phone is supplied.", "format": "email", "maxLength": 254, "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "fullName": { "description": "Optional customer/booker full name, 2–120 characters.", "maxLength": 120, "minLength": 2, "type": "string" }, "phone": { "description": "Reachable international E.164 phone, + followed by 7–15 digits, no spaces; required if no email is supplied.", "pattern": "^\\+[1-9][0-9]{6,14}$", "type": "string" } }, "type": "object" }, "distributionPartnerCapability": { "description": "Optional existing opaque dp_live_ capability issued to an approved distribution partner. Omit for normal customers; do not create or guess one.", "pattern": "^dp_live_[a-f0-9]{64}$", "type": "string" }, "firstTouchTrackingToken": { "description": "Optional existing server-issued first-touch UUID token for this tenant and consented attribution. Omit if none; never invent a token or source.", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" }, "locale": { "default": "en", "description": "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone.", "enum": [ "de", "en" ], "type": "string" }, "offerKey": { "description": "Optional existing published provider offer key. Selects its configured service location; not booking authority.", "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$", "type": "string" }, "offerRequested": { "const": true, "description": "Must be true only after the customer explicitly requests an offer; a price question alone is insufficient consent.", "type": "boolean" }, "resumeToken": { "description": "Private 64-character hexadecimal secret generated for this submission. Reuse its original pair with submissionId for retries and status; never substitute account credentials.", "pattern": "^[a-f0-9]{64}$", "type": "string" }, "ride": { "additionalProperties": false, "description": "Ride facts with distinct pickup/destination and valid local dates/times. Return requires returnDate/returnTime after pickup; one_way omits both. Hourly requires one_way and hours; transfers omit hours.", "properties": { "date": { "description": "Service date as YYYY-MM-DD in the provider timeZone returned by get_service_options; resolve relative dates first.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "destination": { "description": "Destination distinct from pickup, with city/municipality or postcode; e.g. München Hauptbahnhof, 80335 München. For hourly service describe the planned route or As directed.", "maxLength": 240, "minLength": 2, "type": "string" }, "flightNumber": { "description": "Flight number for an airport pickup, such as LH123; omit when not applicable.", "maxLength": 240, "minLength": 1, "type": "string" }, "hours": { "description": "Booked duration for hourly service; omit for transfers.", "maximum": 24, "minimum": 1, "type": "integer" }, "luggage": { "description": "Luggage count/type or fit requirements; unusual luggage may require review.", "maxLength": 240, "minLength": 1, "type": "string" }, "passengers": { "description": "Total people travelling; determines vehicle requirements, not availability or acceptance.", "maximum": 60, "minimum": 1, "type": "integer" }, "pickup": { "description": "Pickup address or named place with city/municipality or postcode; e.g. Flughafen München (MUC), 85356 München-Flughafen.", "maxLength": 240, "minLength": 2, "type": "string" }, "returnDate": { "description": "Return pickup date in the same local format as date, in the provider timeZone; provide only for return trips, after the outbound pickup.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "returnTime": { "description": "Return pickup time in the same local format as time and the same provider timeZone; provide only for return trips.", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$", "type": "string" }, "serviceType": { "description": "Set hourly for service booked by duration; omit for transfers.", "enum": [ "hourly" ], "type": "string" }, "time": { "description": "Local pickup time in 24-hour HH:mm format, in the provider timeZone (Samuelz: Europe/Berlin); not UTC or an offset timestamp.", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$", "type": "string" }, "tripType": { "description": "one_way for a single transfer or hourly service; return for outbound plus a separate later return transfer.", "enum": [ "one_way", "return" ], "type": "string" }, "vehiclePreference": { "description": "Volunteered vehicle preference only; no class, price or availability guarantee. Additional requirements may require review.", "maxLength": 240, "minLength": 1, "type": "string" } }, "required": [ "pickup", "destination", "date", "time", "passengers", "tripType" ], "type": "object" }, "specialRequests": { "description": "Optional ride requirements, at most 500 characters. Additional stops or unusual requirements may require review; do not include contact details in a quote.", "maxLength": 500, "minLength": 1, "type": "string" }, "submissionId": { "description": "Identifies one offer intent. Generate a UUID for a requested new offer; keep it with the same resumeToken for unchanged retries and status.", "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)$", "type": "string" } }, "required": [ "submissionId", "resumeToken", "offerRequested", "contact", "ride" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "pending", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "enum": [ "conflict", "ambiguous", "not_found" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "booking": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "bookingKey": { "maxLength": 128, "minLength": 1, "type": "string" }, "bookingReference": { "minLength": 1, "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "fulfillment": { "additionalProperties": false, "properties": { "chauffeurAssignmentRecorded": { "type": "boolean" }, "completionRecorded": { "type": "boolean" }, "vehicleAssignmentRecorded": { "type": "boolean" } }, "required": [ "chauffeurAssignmentRecorded", "vehicleAssignmentRecorded", "completionRecorded" ], "type": "object" }, "payment": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "status": { "const": "available", "type": "string" } }, "required": [ "status", "bookingKey", "bookingReference", "booking", "payment", "fulfillment", "customerPortalUrl" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message", "review" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "expired", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "checkoutUrl": { "format": "uri", "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "offer": { "additionalProperties": false, "properties": { "completeTermsBound": { "const": true, "type": "boolean" }, "currency": { "const": "EUR", "type": "string" }, "customerConfirmationRequired": { "const": true, "type": "boolean" }, "expiresAt": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "expiresAt", "customerConfirmationRequired", "completeTermsBound" ], "type": "object" }, "status": { "const": "prepared", "type": "string" }, "termsUrl": { "format": "uri", "type": "string" } }, "required": [ "status", "bookingConfirmed", "checkoutUrl", "termsUrl", "offer", "nextAction" ], "type": "object" } ] } } }, "description": "Current public result; inspect status." }, "202": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "pending", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "enum": [ "conflict", "ambiguous", "not_found" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "booking": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "bookingKey": { "maxLength": 128, "minLength": 1, "type": "string" }, "bookingReference": { "minLength": 1, "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "fulfillment": { "additionalProperties": false, "properties": { "chauffeurAssignmentRecorded": { "type": "boolean" }, "completionRecorded": { "type": "boolean" }, "vehicleAssignmentRecorded": { "type": "boolean" } }, "required": [ "chauffeurAssignmentRecorded", "vehicleAssignmentRecorded", "completionRecorded" ], "type": "object" }, "payment": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "status": { "const": "available", "type": "string" } }, "required": [ "status", "bookingKey", "bookingReference", "booking", "payment", "fulfillment", "customerPortalUrl" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message", "review" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "expired", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "checkoutUrl": { "format": "uri", "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "offer": { "additionalProperties": false, "properties": { "completeTermsBound": { "const": true, "type": "boolean" }, "currency": { "const": "EUR", "type": "string" }, "customerConfirmationRequired": { "const": true, "type": "boolean" }, "expiresAt": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "expiresAt", "customerConfirmationRequired", "completeTermsBound" ], "type": "object" }, "status": { "const": "prepared", "type": "string" }, "termsUrl": { "format": "uri", "type": "string" } }, "required": [ "status", "bookingConfirmed", "checkoutUrl", "termsUrl", "offer", "nextAction" ], "type": "object" } ] } } }, "description": "Preparation is pending; read status after retryAfterSeconds." }, "400": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "pending", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "enum": [ "conflict", "ambiguous", "not_found" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "booking": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "bookingKey": { "maxLength": 128, "minLength": 1, "type": "string" }, "bookingReference": { "minLength": 1, "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "fulfillment": { "additionalProperties": false, "properties": { "chauffeurAssignmentRecorded": { "type": "boolean" }, "completionRecorded": { "type": "boolean" }, "vehicleAssignmentRecorded": { "type": "boolean" } }, "required": [ "chauffeurAssignmentRecorded", "vehicleAssignmentRecorded", "completionRecorded" ], "type": "object" }, "payment": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "status": { "const": "available", "type": "string" } }, "required": [ "status", "bookingKey", "bookingReference", "booking", "payment", "fulfillment", "customerPortalUrl" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message", "review" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "expired", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "checkoutUrl": { "format": "uri", "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "offer": { "additionalProperties": false, "properties": { "completeTermsBound": { "const": true, "type": "boolean" }, "currency": { "const": "EUR", "type": "string" }, "customerConfirmationRequired": { "const": true, "type": "boolean" }, "expiresAt": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "expiresAt", "customerConfirmationRequired", "completeTermsBound" ], "type": "object" }, "status": { "const": "prepared", "type": "string" }, "termsUrl": { "format": "uri", "type": "string" } }, "required": [ "status", "bookingConfirmed", "checkoutUrl", "termsUrl", "offer", "nextAction" ], "type": "object" } ] } } }, "description": "Invalid request." }, "404": { "description": "Module or provider not published." }, "405": { "description": "Method not allowed." }, "409": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "pending", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "enum": [ "conflict", "ambiguous", "not_found" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "booking": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "bookingKey": { "maxLength": 128, "minLength": 1, "type": "string" }, "bookingReference": { "minLength": 1, "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "fulfillment": { "additionalProperties": false, "properties": { "chauffeurAssignmentRecorded": { "type": "boolean" }, "completionRecorded": { "type": "boolean" }, "vehicleAssignmentRecorded": { "type": "boolean" } }, "required": [ "chauffeurAssignmentRecorded", "vehicleAssignmentRecorded", "completionRecorded" ], "type": "object" }, "payment": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "status": { "const": "available", "type": "string" } }, "required": [ "status", "bookingKey", "bookingReference", "booking", "payment", "fulfillment", "customerPortalUrl" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message", "review" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "expired", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "checkoutUrl": { "format": "uri", "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "offer": { "additionalProperties": false, "properties": { "completeTermsBound": { "const": true, "type": "boolean" }, "currency": { "const": "EUR", "type": "string" }, "customerConfirmationRequired": { "const": true, "type": "boolean" }, "expiresAt": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "expiresAt", "customerConfirmationRequired", "completeTermsBound" ], "type": "object" }, "status": { "const": "prepared", "type": "string" }, "termsUrl": { "format": "uri", "type": "string" } }, "required": [ "status", "bookingConfirmed", "checkoutUrl", "termsUrl", "offer", "nextAction" ], "type": "object" } ] } } }, "description": "Idempotency conflict or ambiguous operation; do not retry blindly." }, "413": { "description": "Request exceeds 8192 bytes." }, "415": { "description": "Use application/json." }, "429": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "pending", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "enum": [ "conflict", "ambiguous", "not_found" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "booking": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "bookingKey": { "maxLength": 128, "minLength": 1, "type": "string" }, "bookingReference": { "minLength": 1, "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "fulfillment": { "additionalProperties": false, "properties": { "chauffeurAssignmentRecorded": { "type": "boolean" }, "completionRecorded": { "type": "boolean" }, "vehicleAssignmentRecorded": { "type": "boolean" } }, "required": [ "chauffeurAssignmentRecorded", "vehicleAssignmentRecorded", "completionRecorded" ], "type": "object" }, "payment": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "status": { "const": "available", "type": "string" } }, "required": [ "status", "bookingKey", "bookingReference", "booking", "payment", "fulfillment", "customerPortalUrl" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message", "review" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "expired", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "checkoutUrl": { "format": "uri", "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "offer": { "additionalProperties": false, "properties": { "completeTermsBound": { "const": true, "type": "boolean" }, "currency": { "const": "EUR", "type": "string" }, "customerConfirmationRequired": { "const": true, "type": "boolean" }, "expiresAt": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "expiresAt", "customerConfirmationRequired", "completeTermsBound" ], "type": "object" }, "status": { "const": "prepared", "type": "string" }, "termsUrl": { "format": "uri", "type": "string" } }, "required": [ "status", "bookingConfirmed", "checkoutUrl", "termsUrl", "offer", "nextAction" ], "type": "object" } ] } } }, "description": "Shared tenant/client quote budget reached.", "headers": { "Retry-After": { "description": "Seconds before retry.", "schema": { "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "pending", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "enum": [ "conflict", "ambiguous", "not_found" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "booking": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "bookingKey": { "maxLength": 128, "minLength": 1, "type": "string" }, "bookingReference": { "minLength": 1, "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "fulfillment": { "additionalProperties": false, "properties": { "chauffeurAssignmentRecorded": { "type": "boolean" }, "completionRecorded": { "type": "boolean" }, "vehicleAssignmentRecorded": { "type": "boolean" } }, "required": [ "chauffeurAssignmentRecorded", "vehicleAssignmentRecorded", "completionRecorded" ], "type": "object" }, "payment": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "status": { "const": "available", "type": "string" } }, "required": [ "status", "bookingKey", "bookingReference", "booking", "payment", "fulfillment", "customerPortalUrl" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message", "review" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "expired", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "checkoutUrl": { "format": "uri", "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "offer": { "additionalProperties": false, "properties": { "completeTermsBound": { "const": true, "type": "boolean" }, "currency": { "const": "EUR", "type": "string" }, "customerConfirmationRequired": { "const": true, "type": "boolean" }, "expiresAt": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "expiresAt", "customerConfirmationRequired", "completeTermsBound" ], "type": "object" }, "status": { "const": "prepared", "type": "string" }, "termsUrl": { "format": "uri", "type": "string" } }, "required": [ "status", "bookingConfirmed", "checkoutUrl", "termsUrl", "offer", "nextAction" ], "type": "object" } ] } } }, "description": "Temporarily unavailable." } }, "summary": "Prepare an unpaid chauffeur offer", "x-mcp-tool": "prepare_offer" } }, "/offers/status": { "post": { "description": "Use to read one existing request with its original submissionId/resumeToken pair within the original 24-hour window. Returns offer state or recorded booking/payment/fulfillment after payment; no pricing call or new business action. For pending, wait retryAfterSeconds and retry that pair. For ambiguous/conflict inspect that intent; not_found denies access and unavailable is not vehicle evidence. Open customerPortalUrl for private login. No locale (original language), history, cancellation or modification.", "operationId": "chauffeur_offers/status", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "resumeToken": { "description": "Private 64-character hexadecimal secret generated for this submission. Reuse its original pair with submissionId for retries and status; never substitute account credentials.", "pattern": "^[a-f0-9]{64}$", "type": "string" }, "submissionId": { "description": "Identifies one offer intent. Generate a UUID for a requested new offer; keep it with the same resumeToken for unchanged retries and status.", "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)$", "type": "string" } }, "required": [ "submissionId", "resumeToken" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "pending", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "enum": [ "conflict", "ambiguous", "not_found" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "booking": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "bookingKey": { "maxLength": 128, "minLength": 1, "type": "string" }, "bookingReference": { "minLength": 1, "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "fulfillment": { "additionalProperties": false, "properties": { "chauffeurAssignmentRecorded": { "type": "boolean" }, "completionRecorded": { "type": "boolean" }, "vehicleAssignmentRecorded": { "type": "boolean" } }, "required": [ "chauffeurAssignmentRecorded", "vehicleAssignmentRecorded", "completionRecorded" ], "type": "object" }, "payment": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "status": { "const": "available", "type": "string" } }, "required": [ "status", "bookingKey", "bookingReference", "booking", "payment", "fulfillment", "customerPortalUrl" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message", "review" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "expired", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "checkoutUrl": { "format": "uri", "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "offer": { "additionalProperties": false, "properties": { "completeTermsBound": { "const": true, "type": "boolean" }, "currency": { "const": "EUR", "type": "string" }, "customerConfirmationRequired": { "const": true, "type": "boolean" }, "expiresAt": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "expiresAt", "customerConfirmationRequired", "completeTermsBound" ], "type": "object" }, "status": { "const": "prepared", "type": "string" }, "termsUrl": { "format": "uri", "type": "string" } }, "required": [ "status", "bookingConfirmed", "checkoutUrl", "termsUrl", "offer", "nextAction" ], "type": "object" } ] } } }, "description": "Current public result; inspect status." }, "202": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "pending", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "enum": [ "conflict", "ambiguous", "not_found" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "booking": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "bookingKey": { "maxLength": 128, "minLength": 1, "type": "string" }, "bookingReference": { "minLength": 1, "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "fulfillment": { "additionalProperties": false, "properties": { "chauffeurAssignmentRecorded": { "type": "boolean" }, "completionRecorded": { "type": "boolean" }, "vehicleAssignmentRecorded": { "type": "boolean" } }, "required": [ "chauffeurAssignmentRecorded", "vehicleAssignmentRecorded", "completionRecorded" ], "type": "object" }, "payment": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "status": { "const": "available", "type": "string" } }, "required": [ "status", "bookingKey", "bookingReference", "booking", "payment", "fulfillment", "customerPortalUrl" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message", "review" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "expired", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "checkoutUrl": { "format": "uri", "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "offer": { "additionalProperties": false, "properties": { "completeTermsBound": { "const": true, "type": "boolean" }, "currency": { "const": "EUR", "type": "string" }, "customerConfirmationRequired": { "const": true, "type": "boolean" }, "expiresAt": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "expiresAt", "customerConfirmationRequired", "completeTermsBound" ], "type": "object" }, "status": { "const": "prepared", "type": "string" }, "termsUrl": { "format": "uri", "type": "string" } }, "required": [ "status", "bookingConfirmed", "checkoutUrl", "termsUrl", "offer", "nextAction" ], "type": "object" } ] } } }, "description": "Preparation is pending; read status after retryAfterSeconds." }, "400": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "pending", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "enum": [ "conflict", "ambiguous", "not_found" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "booking": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "bookingKey": { "maxLength": 128, "minLength": 1, "type": "string" }, "bookingReference": { "minLength": 1, "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "fulfillment": { "additionalProperties": false, "properties": { "chauffeurAssignmentRecorded": { "type": "boolean" }, "completionRecorded": { "type": "boolean" }, "vehicleAssignmentRecorded": { "type": "boolean" } }, "required": [ "chauffeurAssignmentRecorded", "vehicleAssignmentRecorded", "completionRecorded" ], "type": "object" }, "payment": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "status": { "const": "available", "type": "string" } }, "required": [ "status", "bookingKey", "bookingReference", "booking", "payment", "fulfillment", "customerPortalUrl" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message", "review" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "expired", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "checkoutUrl": { "format": "uri", "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "offer": { "additionalProperties": false, "properties": { "completeTermsBound": { "const": true, "type": "boolean" }, "currency": { "const": "EUR", "type": "string" }, "customerConfirmationRequired": { "const": true, "type": "boolean" }, "expiresAt": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "expiresAt", "customerConfirmationRequired", "completeTermsBound" ], "type": "object" }, "status": { "const": "prepared", "type": "string" }, "termsUrl": { "format": "uri", "type": "string" } }, "required": [ "status", "bookingConfirmed", "checkoutUrl", "termsUrl", "offer", "nextAction" ], "type": "object" } ] } } }, "description": "Invalid request." }, "404": { "description": "Module or provider not published." }, "405": { "description": "Method not allowed." }, "409": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "pending", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "enum": [ "conflict", "ambiguous", "not_found" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "booking": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "bookingKey": { "maxLength": 128, "minLength": 1, "type": "string" }, "bookingReference": { "minLength": 1, "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "fulfillment": { "additionalProperties": false, "properties": { "chauffeurAssignmentRecorded": { "type": "boolean" }, "completionRecorded": { "type": "boolean" }, "vehicleAssignmentRecorded": { "type": "boolean" } }, "required": [ "chauffeurAssignmentRecorded", "vehicleAssignmentRecorded", "completionRecorded" ], "type": "object" }, "payment": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "status": { "const": "available", "type": "string" } }, "required": [ "status", "bookingKey", "bookingReference", "booking", "payment", "fulfillment", "customerPortalUrl" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message", "review" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "expired", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "checkoutUrl": { "format": "uri", "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "offer": { "additionalProperties": false, "properties": { "completeTermsBound": { "const": true, "type": "boolean" }, "currency": { "const": "EUR", "type": "string" }, "customerConfirmationRequired": { "const": true, "type": "boolean" }, "expiresAt": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "expiresAt", "customerConfirmationRequired", "completeTermsBound" ], "type": "object" }, "status": { "const": "prepared", "type": "string" }, "termsUrl": { "format": "uri", "type": "string" } }, "required": [ "status", "bookingConfirmed", "checkoutUrl", "termsUrl", "offer", "nextAction" ], "type": "object" } ] } } }, "description": "Idempotency conflict or ambiguous operation; do not retry blindly." }, "413": { "description": "Request exceeds 8192 bytes." }, "415": { "description": "Use application/json." }, "429": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "pending", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "enum": [ "conflict", "ambiguous", "not_found" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "booking": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "bookingKey": { "maxLength": 128, "minLength": 1, "type": "string" }, "bookingReference": { "minLength": 1, "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "fulfillment": { "additionalProperties": false, "properties": { "chauffeurAssignmentRecorded": { "type": "boolean" }, "completionRecorded": { "type": "boolean" }, "vehicleAssignmentRecorded": { "type": "boolean" } }, "required": [ "chauffeurAssignmentRecorded", "vehicleAssignmentRecorded", "completionRecorded" ], "type": "object" }, "payment": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "status": { "const": "available", "type": "string" } }, "required": [ "status", "bookingKey", "bookingReference", "booking", "payment", "fulfillment", "customerPortalUrl" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message", "review" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "expired", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "checkoutUrl": { "format": "uri", "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "offer": { "additionalProperties": false, "properties": { "completeTermsBound": { "const": true, "type": "boolean" }, "currency": { "const": "EUR", "type": "string" }, "customerConfirmationRequired": { "const": true, "type": "boolean" }, "expiresAt": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "expiresAt", "customerConfirmationRequired", "completeTermsBound" ], "type": "object" }, "status": { "const": "prepared", "type": "string" }, "termsUrl": { "format": "uri", "type": "string" } }, "required": [ "status", "bookingConfirmed", "checkoutUrl", "termsUrl", "offer", "nextAction" ], "type": "object" } ] } } }, "description": "Shared tenant/client quote budget reached.", "headers": { "Retry-After": { "description": "Seconds before retry.", "schema": { "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "pending", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "enum": [ "conflict", "ambiguous", "not_found" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "booking": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "bookingKey": { "maxLength": 128, "minLength": 1, "type": "string" }, "bookingReference": { "minLength": 1, "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "fulfillment": { "additionalProperties": false, "properties": { "chauffeurAssignmentRecorded": { "type": "boolean" }, "completionRecorded": { "type": "boolean" }, "vehicleAssignmentRecorded": { "type": "boolean" } }, "required": [ "chauffeurAssignmentRecorded", "vehicleAssignmentRecorded", "completionRecorded" ], "type": "object" }, "payment": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "status": { "const": "available", "type": "string" } }, "required": [ "status", "bookingKey", "bookingReference", "booking", "payment", "fulfillment", "customerPortalUrl" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message", "review" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "expired", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "checkoutUrl": { "format": "uri", "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "offer": { "additionalProperties": false, "properties": { "completeTermsBound": { "const": true, "type": "boolean" }, "currency": { "const": "EUR", "type": "string" }, "customerConfirmationRequired": { "const": true, "type": "boolean" }, "expiresAt": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "expiresAt", "customerConfirmationRequired", "completeTermsBound" ], "type": "object" }, "status": { "const": "prepared", "type": "string" }, "termsUrl": { "format": "uri", "type": "string" } }, "required": [ "status", "bookingConfirmed", "checkoutUrl", "termsUrl", "offer", "nextAction" ], "type": "object" } ] } } }, "description": "Temporarily unavailable." } }, "summary": "Read prepared offer status", "x-mcp-tool": "get_offer_status" } }, "/policy": { "get": { "description": "Use after get_service_options and before prepare_offer to retrieve current account, guest-booking and minimum-lead-time rules. Returns observedAt and revalidationRequired: refresh the rules before preparing an offer; no terms-validity window is promised. Review bound waiting and cancellation terms on the current offer before confirmation. On unavailable, report that the rules could not be read; do not invent them. For a price use quote_ride.", "operationId": "chauffeur_policy", "parameters": [ { "in": "query", "name": "locale", "required": false, "schema": { "default": "en", "description": "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone.", "enum": [ "de", "en" ], "type": "string" } }, { "in": "query", "name": "offerKey", "required": false, "schema": { "description": "Optional existing published provider offer key. Selects its configured service location; not booking authority.", "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "bookingUrl": { "format": "uri", "type": "string" }, "observedAt": { "type": "string" }, "revalidationRequired": { "const": true, "type": "boolean" }, "scope": { "const": "booking_preparation", "type": "string" }, "status": { "const": "available", "type": "string" }, "terms": { "additionalProperties": false, "properties": { "accountRequired": { "type": "boolean" }, "bookerForGuestAllowed": { "type": "boolean" }, "bookingConfirmation": { "const": "after_confirmed_full_payment", "type": "string" }, "minimumLeadTimeMinutes": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "serviceSpecificTerms": { "const": "review_the_current_offer_before_confirmation", "type": "string" } }, "required": [ "minimumLeadTimeMinutes", "accountRequired", "bookerForGuestAllowed", "bookingConfirmation", "serviceSpecificTerms" ], "type": "object" }, "timeZone": { "type": "string" } }, "required": [ "status", "bookingUrl", "timeZone", "observedAt", "scope", "revalidationRequired", "terms", "bookingConfirmed" ], "type": "object" } ] } } }, "description": "Current public result; inspect status." }, "202": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "bookingUrl": { "format": "uri", "type": "string" }, "observedAt": { "type": "string" }, "revalidationRequired": { "const": true, "type": "boolean" }, "scope": { "const": "booking_preparation", "type": "string" }, "status": { "const": "available", "type": "string" }, "terms": { "additionalProperties": false, "properties": { "accountRequired": { "type": "boolean" }, "bookerForGuestAllowed": { "type": "boolean" }, "bookingConfirmation": { "const": "after_confirmed_full_payment", "type": "string" }, "minimumLeadTimeMinutes": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "serviceSpecificTerms": { "const": "review_the_current_offer_before_confirmation", "type": "string" } }, "required": [ "minimumLeadTimeMinutes", "accountRequired", "bookerForGuestAllowed", "bookingConfirmation", "serviceSpecificTerms" ], "type": "object" }, "timeZone": { "type": "string" } }, "required": [ "status", "bookingUrl", "timeZone", "observedAt", "scope", "revalidationRequired", "terms", "bookingConfirmed" ], "type": "object" } ] } } }, "description": "Preparation is pending; read status after retryAfterSeconds." }, "400": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "bookingUrl": { "format": "uri", "type": "string" }, "observedAt": { "type": "string" }, "revalidationRequired": { "const": true, "type": "boolean" }, "scope": { "const": "booking_preparation", "type": "string" }, "status": { "const": "available", "type": "string" }, "terms": { "additionalProperties": false, "properties": { "accountRequired": { "type": "boolean" }, "bookerForGuestAllowed": { "type": "boolean" }, "bookingConfirmation": { "const": "after_confirmed_full_payment", "type": "string" }, "minimumLeadTimeMinutes": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "serviceSpecificTerms": { "const": "review_the_current_offer_before_confirmation", "type": "string" } }, "required": [ "minimumLeadTimeMinutes", "accountRequired", "bookerForGuestAllowed", "bookingConfirmation", "serviceSpecificTerms" ], "type": "object" }, "timeZone": { "type": "string" } }, "required": [ "status", "bookingUrl", "timeZone", "observedAt", "scope", "revalidationRequired", "terms", "bookingConfirmed" ], "type": "object" } ] } } }, "description": "Invalid request." }, "404": { "description": "Module or provider not published." }, "405": { "description": "Method not allowed." }, "409": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "bookingUrl": { "format": "uri", "type": "string" }, "observedAt": { "type": "string" }, "revalidationRequired": { "const": true, "type": "boolean" }, "scope": { "const": "booking_preparation", "type": "string" }, "status": { "const": "available", "type": "string" }, "terms": { "additionalProperties": false, "properties": { "accountRequired": { "type": "boolean" }, "bookerForGuestAllowed": { "type": "boolean" }, "bookingConfirmation": { "const": "after_confirmed_full_payment", "type": "string" }, "minimumLeadTimeMinutes": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "serviceSpecificTerms": { "const": "review_the_current_offer_before_confirmation", "type": "string" } }, "required": [ "minimumLeadTimeMinutes", "accountRequired", "bookerForGuestAllowed", "bookingConfirmation", "serviceSpecificTerms" ], "type": "object" }, "timeZone": { "type": "string" } }, "required": [ "status", "bookingUrl", "timeZone", "observedAt", "scope", "revalidationRequired", "terms", "bookingConfirmed" ], "type": "object" } ] } } }, "description": "Idempotency conflict or ambiguous operation; do not retry blindly." }, "413": { "description": "Request exceeds 8192 bytes." }, "415": { "description": "Use application/json." }, "429": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "bookingUrl": { "format": "uri", "type": "string" }, "observedAt": { "type": "string" }, "revalidationRequired": { "const": true, "type": "boolean" }, "scope": { "const": "booking_preparation", "type": "string" }, "status": { "const": "available", "type": "string" }, "terms": { "additionalProperties": false, "properties": { "accountRequired": { "type": "boolean" }, "bookerForGuestAllowed": { "type": "boolean" }, "bookingConfirmation": { "const": "after_confirmed_full_payment", "type": "string" }, "minimumLeadTimeMinutes": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "serviceSpecificTerms": { "const": "review_the_current_offer_before_confirmation", "type": "string" } }, "required": [ "minimumLeadTimeMinutes", "accountRequired", "bookerForGuestAllowed", "bookingConfirmation", "serviceSpecificTerms" ], "type": "object" }, "timeZone": { "type": "string" } }, "required": [ "status", "bookingUrl", "timeZone", "observedAt", "scope", "revalidationRequired", "terms", "bookingConfirmed" ], "type": "object" } ] } } }, "description": "Shared tenant/client quote budget reached.", "headers": { "Retry-After": { "description": "Seconds before retry.", "schema": { "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "bookingUrl": { "format": "uri", "type": "string" }, "observedAt": { "type": "string" }, "revalidationRequired": { "const": true, "type": "boolean" }, "scope": { "const": "booking_preparation", "type": "string" }, "status": { "const": "available", "type": "string" }, "terms": { "additionalProperties": false, "properties": { "accountRequired": { "type": "boolean" }, "bookerForGuestAllowed": { "type": "boolean" }, "bookingConfirmation": { "const": "after_confirmed_full_payment", "type": "string" }, "minimumLeadTimeMinutes": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "serviceSpecificTerms": { "const": "review_the_current_offer_before_confirmation", "type": "string" } }, "required": [ "minimumLeadTimeMinutes", "accountRequired", "bookerForGuestAllowed", "bookingConfirmation", "serviceSpecificTerms" ], "type": "object" }, "timeZone": { "type": "string" } }, "required": [ "status", "bookingUrl", "timeZone", "observedAt", "scope", "revalidationRequired", "terms", "bookingConfirmed" ], "type": "object" } ] } } }, "description": "Temporarily unavailable." } }, "summary": "Published customer terms", "x-mcp-tool": "get_customer_policy" } }, "/quotes": { "post": { "description": "Use after get_service_options to calculate an anonymous price preview for complete ride facts in the provider timeZone. No contact is needed. Resolve missing return or hourly facts before quoting. The calculatedAt preview requires revalidation; no price-validity window is guaranteed. For rate_limited wait retryAfterSeconds. For review_required follow the returned guidance; it does not prove vehicle unavailability. No offer, reservation, charge or message is created. Call prepare_offer only for an explicit offer request.", "operationId": "chauffeur_quotes", "requestBody": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "locale": { "default": "en", "description": "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone.", "enum": [ "de", "en" ], "type": "string" }, "offerKey": { "description": "Optional existing published provider offer key. Selects its configured service location; not booking authority.", "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$", "type": "string" }, "ride": { "additionalProperties": false, "description": "Ride facts with distinct pickup/destination and valid local dates/times. Return requires returnDate/returnTime after pickup; one_way omits both. Hourly requires one_way and hours; transfers omit hours.", "properties": { "date": { "description": "Service date as YYYY-MM-DD in the provider timeZone returned by get_service_options; resolve relative dates first.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "destination": { "description": "Destination distinct from pickup, with city/municipality or postcode; e.g. München Hauptbahnhof, 80335 München. For hourly service describe the planned route or As directed.", "maxLength": 240, "minLength": 2, "type": "string" }, "flightNumber": { "description": "Flight number for an airport pickup, such as LH123; omit when not applicable.", "maxLength": 240, "minLength": 1, "type": "string" }, "hours": { "description": "Booked duration for hourly service; omit for transfers.", "maximum": 24, "minimum": 1, "type": "integer" }, "luggage": { "description": "Luggage count/type or fit requirements; unusual luggage may require review.", "maxLength": 240, "minLength": 1, "type": "string" }, "passengers": { "description": "Total people travelling; determines vehicle requirements, not availability or acceptance.", "maximum": 60, "minimum": 1, "type": "integer" }, "pickup": { "description": "Pickup address or named place with city/municipality or postcode; e.g. Flughafen München (MUC), 85356 München-Flughafen.", "maxLength": 240, "minLength": 2, "type": "string" }, "returnDate": { "description": "Return pickup date in the same local format as date, in the provider timeZone; provide only for return trips, after the outbound pickup.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "returnTime": { "description": "Return pickup time in the same local format as time and the same provider timeZone; provide only for return trips.", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$", "type": "string" }, "serviceType": { "description": "Set hourly for service booked by duration; omit for transfers.", "enum": [ "hourly" ], "type": "string" }, "time": { "description": "Local pickup time in 24-hour HH:mm format, in the provider timeZone (Samuelz: Europe/Berlin); not UTC or an offset timestamp.", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$", "type": "string" }, "tripType": { "description": "one_way for a single transfer or hourly service; return for outbound plus a separate later return transfer.", "enum": [ "one_way", "return" ], "type": "string" }, "vehiclePreference": { "description": "Volunteered vehicle preference only; no class, price or availability guarantee. Additional requirements may require review.", "maxLength": 240, "minLength": 1, "type": "string" } }, "required": [ "pickup", "destination", "date", "time", "passengers", "tripType" ], "type": "object" }, "specialRequests": { "description": "Optional ride requirements, at most 500 characters. Additional stops or unusual requirements may require review; do not include contact details in a quote.", "maxLength": 500, "minLength": 1, "type": "string" } }, "required": [ "ride" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "bookingUrl", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "bookingUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "quote": { "additionalProperties": false, "properties": { "billableHoursPerServiceLine": { "exclusiveMinimum": 0, "type": "number" }, "calculatedAt": { "type": "string" }, "currency": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "parkingIncluded": { "type": "boolean" }, "pricesIncludeVat": { "type": "boolean" }, "revalidationRequired": { "const": true, "type": "boolean" }, "serviceLines": { "items": { "additionalProperties": false, "properties": { "direction": { "enum": [ "outbound", "return" ], "type": "string" }, "grossAmountCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "direction", "grossAmountCents" ], "type": "object" }, "type": "array" }, "tollsIncluded": { "type": "boolean" }, "vatRateBasisPoints": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "vehicleCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "pricesIncludeVat", "vatRateBasisPoints", "parkingIncluded", "tollsIncluded", "vehicleCount", "billableHoursPerServiceLine", "serviceLines", "calculatedAt", "revalidationRequired" ], "type": "object" }, "status": { "const": "quoted", "type": "string" } }, "required": [ "status", "bookingUrl", "bookingConfirmed", "quote", "nextAction" ], "type": "object" } ] } } }, "description": "Current public result; inspect status." }, "202": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "bookingUrl", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "bookingUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "quote": { "additionalProperties": false, "properties": { "billableHoursPerServiceLine": { "exclusiveMinimum": 0, "type": "number" }, "calculatedAt": { "type": "string" }, "currency": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "parkingIncluded": { "type": "boolean" }, "pricesIncludeVat": { "type": "boolean" }, "revalidationRequired": { "const": true, "type": "boolean" }, "serviceLines": { "items": { "additionalProperties": false, "properties": { "direction": { "enum": [ "outbound", "return" ], "type": "string" }, "grossAmountCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "direction", "grossAmountCents" ], "type": "object" }, "type": "array" }, "tollsIncluded": { "type": "boolean" }, "vatRateBasisPoints": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "vehicleCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "pricesIncludeVat", "vatRateBasisPoints", "parkingIncluded", "tollsIncluded", "vehicleCount", "billableHoursPerServiceLine", "serviceLines", "calculatedAt", "revalidationRequired" ], "type": "object" }, "status": { "const": "quoted", "type": "string" } }, "required": [ "status", "bookingUrl", "bookingConfirmed", "quote", "nextAction" ], "type": "object" } ] } } }, "description": "Preparation is pending; read status after retryAfterSeconds." }, "400": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "bookingUrl", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "bookingUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "quote": { "additionalProperties": false, "properties": { "billableHoursPerServiceLine": { "exclusiveMinimum": 0, "type": "number" }, "calculatedAt": { "type": "string" }, "currency": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "parkingIncluded": { "type": "boolean" }, "pricesIncludeVat": { "type": "boolean" }, "revalidationRequired": { "const": true, "type": "boolean" }, "serviceLines": { "items": { "additionalProperties": false, "properties": { "direction": { "enum": [ "outbound", "return" ], "type": "string" }, "grossAmountCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "direction", "grossAmountCents" ], "type": "object" }, "type": "array" }, "tollsIncluded": { "type": "boolean" }, "vatRateBasisPoints": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "vehicleCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "pricesIncludeVat", "vatRateBasisPoints", "parkingIncluded", "tollsIncluded", "vehicleCount", "billableHoursPerServiceLine", "serviceLines", "calculatedAt", "revalidationRequired" ], "type": "object" }, "status": { "const": "quoted", "type": "string" } }, "required": [ "status", "bookingUrl", "bookingConfirmed", "quote", "nextAction" ], "type": "object" } ] } } }, "description": "Invalid request." }, "404": { "description": "Module or provider not published." }, "405": { "description": "Method not allowed." }, "409": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "bookingUrl", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "bookingUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "quote": { "additionalProperties": false, "properties": { "billableHoursPerServiceLine": { "exclusiveMinimum": 0, "type": "number" }, "calculatedAt": { "type": "string" }, "currency": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "parkingIncluded": { "type": "boolean" }, "pricesIncludeVat": { "type": "boolean" }, "revalidationRequired": { "const": true, "type": "boolean" }, "serviceLines": { "items": { "additionalProperties": false, "properties": { "direction": { "enum": [ "outbound", "return" ], "type": "string" }, "grossAmountCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "direction", "grossAmountCents" ], "type": "object" }, "type": "array" }, "tollsIncluded": { "type": "boolean" }, "vatRateBasisPoints": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "vehicleCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "pricesIncludeVat", "vatRateBasisPoints", "parkingIncluded", "tollsIncluded", "vehicleCount", "billableHoursPerServiceLine", "serviceLines", "calculatedAt", "revalidationRequired" ], "type": "object" }, "status": { "const": "quoted", "type": "string" } }, "required": [ "status", "bookingUrl", "bookingConfirmed", "quote", "nextAction" ], "type": "object" } ] } } }, "description": "Idempotency conflict or ambiguous operation; do not retry blindly." }, "413": { "description": "Request exceeds 8192 bytes." }, "415": { "description": "Use application/json." }, "429": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "bookingUrl", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "bookingUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "quote": { "additionalProperties": false, "properties": { "billableHoursPerServiceLine": { "exclusiveMinimum": 0, "type": "number" }, "calculatedAt": { "type": "string" }, "currency": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "parkingIncluded": { "type": "boolean" }, "pricesIncludeVat": { "type": "boolean" }, "revalidationRequired": { "const": true, "type": "boolean" }, "serviceLines": { "items": { "additionalProperties": false, "properties": { "direction": { "enum": [ "outbound", "return" ], "type": "string" }, "grossAmountCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "direction", "grossAmountCents" ], "type": "object" }, "type": "array" }, "tollsIncluded": { "type": "boolean" }, "vatRateBasisPoints": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "vehicleCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "pricesIncludeVat", "vatRateBasisPoints", "parkingIncluded", "tollsIncluded", "vehicleCount", "billableHoursPerServiceLine", "serviceLines", "calculatedAt", "revalidationRequired" ], "type": "object" }, "status": { "const": "quoted", "type": "string" } }, "required": [ "status", "bookingUrl", "bookingConfirmed", "quote", "nextAction" ], "type": "object" } ] } } }, "description": "Shared tenant/client quote budget reached.", "headers": { "Retry-After": { "description": "Seconds before retry.", "schema": { "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "bookingUrl", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "bookingUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "quote": { "additionalProperties": false, "properties": { "billableHoursPerServiceLine": { "exclusiveMinimum": 0, "type": "number" }, "calculatedAt": { "type": "string" }, "currency": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "parkingIncluded": { "type": "boolean" }, "pricesIncludeVat": { "type": "boolean" }, "revalidationRequired": { "const": true, "type": "boolean" }, "serviceLines": { "items": { "additionalProperties": false, "properties": { "direction": { "enum": [ "outbound", "return" ], "type": "string" }, "grossAmountCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "direction", "grossAmountCents" ], "type": "object" }, "type": "array" }, "tollsIncluded": { "type": "boolean" }, "vatRateBasisPoints": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "vehicleCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "pricesIncludeVat", "vatRateBasisPoints", "parkingIncluded", "tollsIncluded", "vehicleCount", "billableHoursPerServiceLine", "serviceLines", "calculatedAt", "revalidationRequired" ], "type": "object" }, "status": { "const": "quoted", "type": "string" } }, "required": [ "status", "bookingUrl", "bookingConfirmed", "quote", "nextAction" ], "type": "object" } ] } } }, "description": "Temporarily unavailable." } }, "summary": "Chauffeur price preview", "x-mcp-tool": "quote_ride" } }, "/services": { "get": { "description": "Use first to learn this provider's service scope, required ride facts and local timeZone. Read current published facts; do not assume additional locations. Language defaults to English; pass locale=de for German, without changing timeZone. It gives no price or availability confirmation. Use get_customer_policy for booking rules, quote_ride for a price, or prepare_offer only after an explicit offer request.", "operationId": "chauffeur_services", "parameters": [ { "in": "query", "name": "locale", "required": false, "schema": { "default": "en", "description": "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone.", "enum": [ "de", "en" ], "type": "string" } }, { "in": "query", "name": "offerKey", "required": false, "schema": { "description": "Optional existing published provider offer key. Selects its configured service location; not booking authority.", "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "hourlyRideFacts": { "items": { "type": "string" }, "type": "array" }, "location": { "additionalProperties": false, "properties": { "countryCode": { "type": "string" }, "key": { "type": "string" }, "label": { "type": "string" } }, "required": [ "key", "countryCode", "label" ], "type": "object" }, "nextAction": { "type": "string" }, "provider": { "type": "string" }, "requiredRideFacts": { "items": { "type": "string" }, "type": "array" }, "returnRideFacts": { "items": { "type": "string" }, "type": "array" }, "services": { "items": { "additionalProperties": false, "properties": { "availability": { "const": "requires_offer_review", "type": "string" }, "key": { "type": "string" }, "tripTypes": { "items": { "enum": [ "one_way", "return" ], "type": "string" }, "type": "array" } }, "required": [ "key", "tripTypes", "availability" ], "type": "object" }, "type": "array" }, "status": { "const": "available", "type": "string" }, "timeZone": { "type": "string" } }, "required": [ "status", "provider", "timeZone", "bookingUrl", "services", "requiredRideFacts", "returnRideFacts", "hourlyRideFacts", "nextAction" ], "type": "object" } ] } } }, "description": "Current public result; inspect status." }, "202": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "hourlyRideFacts": { "items": { "type": "string" }, "type": "array" }, "location": { "additionalProperties": false, "properties": { "countryCode": { "type": "string" }, "key": { "type": "string" }, "label": { "type": "string" } }, "required": [ "key", "countryCode", "label" ], "type": "object" }, "nextAction": { "type": "string" }, "provider": { "type": "string" }, "requiredRideFacts": { "items": { "type": "string" }, "type": "array" }, "returnRideFacts": { "items": { "type": "string" }, "type": "array" }, "services": { "items": { "additionalProperties": false, "properties": { "availability": { "const": "requires_offer_review", "type": "string" }, "key": { "type": "string" }, "tripTypes": { "items": { "enum": [ "one_way", "return" ], "type": "string" }, "type": "array" } }, "required": [ "key", "tripTypes", "availability" ], "type": "object" }, "type": "array" }, "status": { "const": "available", "type": "string" }, "timeZone": { "type": "string" } }, "required": [ "status", "provider", "timeZone", "bookingUrl", "services", "requiredRideFacts", "returnRideFacts", "hourlyRideFacts", "nextAction" ], "type": "object" } ] } } }, "description": "Preparation is pending; read status after retryAfterSeconds." }, "400": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "hourlyRideFacts": { "items": { "type": "string" }, "type": "array" }, "location": { "additionalProperties": false, "properties": { "countryCode": { "type": "string" }, "key": { "type": "string" }, "label": { "type": "string" } }, "required": [ "key", "countryCode", "label" ], "type": "object" }, "nextAction": { "type": "string" }, "provider": { "type": "string" }, "requiredRideFacts": { "items": { "type": "string" }, "type": "array" }, "returnRideFacts": { "items": { "type": "string" }, "type": "array" }, "services": { "items": { "additionalProperties": false, "properties": { "availability": { "const": "requires_offer_review", "type": "string" }, "key": { "type": "string" }, "tripTypes": { "items": { "enum": [ "one_way", "return" ], "type": "string" }, "type": "array" } }, "required": [ "key", "tripTypes", "availability" ], "type": "object" }, "type": "array" }, "status": { "const": "available", "type": "string" }, "timeZone": { "type": "string" } }, "required": [ "status", "provider", "timeZone", "bookingUrl", "services", "requiredRideFacts", "returnRideFacts", "hourlyRideFacts", "nextAction" ], "type": "object" } ] } } }, "description": "Invalid request." }, "404": { "description": "Module or provider not published." }, "405": { "description": "Method not allowed." }, "409": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "hourlyRideFacts": { "items": { "type": "string" }, "type": "array" }, "location": { "additionalProperties": false, "properties": { "countryCode": { "type": "string" }, "key": { "type": "string" }, "label": { "type": "string" } }, "required": [ "key", "countryCode", "label" ], "type": "object" }, "nextAction": { "type": "string" }, "provider": { "type": "string" }, "requiredRideFacts": { "items": { "type": "string" }, "type": "array" }, "returnRideFacts": { "items": { "type": "string" }, "type": "array" }, "services": { "items": { "additionalProperties": false, "properties": { "availability": { "const": "requires_offer_review", "type": "string" }, "key": { "type": "string" }, "tripTypes": { "items": { "enum": [ "one_way", "return" ], "type": "string" }, "type": "array" } }, "required": [ "key", "tripTypes", "availability" ], "type": "object" }, "type": "array" }, "status": { "const": "available", "type": "string" }, "timeZone": { "type": "string" } }, "required": [ "status", "provider", "timeZone", "bookingUrl", "services", "requiredRideFacts", "returnRideFacts", "hourlyRideFacts", "nextAction" ], "type": "object" } ] } } }, "description": "Idempotency conflict or ambiguous operation; do not retry blindly." }, "413": { "description": "Request exceeds 8192 bytes." }, "415": { "description": "Use application/json." }, "429": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "hourlyRideFacts": { "items": { "type": "string" }, "type": "array" }, "location": { "additionalProperties": false, "properties": { "countryCode": { "type": "string" }, "key": { "type": "string" }, "label": { "type": "string" } }, "required": [ "key", "countryCode", "label" ], "type": "object" }, "nextAction": { "type": "string" }, "provider": { "type": "string" }, "requiredRideFacts": { "items": { "type": "string" }, "type": "array" }, "returnRideFacts": { "items": { "type": "string" }, "type": "array" }, "services": { "items": { "additionalProperties": false, "properties": { "availability": { "const": "requires_offer_review", "type": "string" }, "key": { "type": "string" }, "tripTypes": { "items": { "enum": [ "one_way", "return" ], "type": "string" }, "type": "array" } }, "required": [ "key", "tripTypes", "availability" ], "type": "object" }, "type": "array" }, "status": { "const": "available", "type": "string" }, "timeZone": { "type": "string" } }, "required": [ "status", "provider", "timeZone", "bookingUrl", "services", "requiredRideFacts", "returnRideFacts", "hourlyRideFacts", "nextAction" ], "type": "object" } ] } } }, "description": "Shared tenant/client quote budget reached.", "headers": { "Retry-After": { "description": "Seconds before retry.", "schema": { "type": "integer" } } } }, "503": { "content": { "application/json": { "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "hourlyRideFacts": { "items": { "type": "string" }, "type": "array" }, "location": { "additionalProperties": false, "properties": { "countryCode": { "type": "string" }, "key": { "type": "string" }, "label": { "type": "string" } }, "required": [ "key", "countryCode", "label" ], "type": "object" }, "nextAction": { "type": "string" }, "provider": { "type": "string" }, "requiredRideFacts": { "items": { "type": "string" }, "type": "array" }, "returnRideFacts": { "items": { "type": "string" }, "type": "array" }, "services": { "items": { "additionalProperties": false, "properties": { "availability": { "const": "requires_offer_review", "type": "string" }, "key": { "type": "string" }, "tripTypes": { "items": { "enum": [ "one_way", "return" ], "type": "string" }, "type": "array" } }, "required": [ "key", "tripTypes", "availability" ], "type": "object" }, "type": "array" }, "status": { "const": "available", "type": "string" }, "timeZone": { "type": "string" } }, "required": [ "status", "provider", "timeZone", "bookingUrl", "services", "requiredRideFacts", "returnRideFacts", "hourlyRideFacts", "nextAction" ], "type": "object" } ] } } }, "description": "Temporarily unavailable." } }, "summary": "Chauffeur service options", "x-mcp-tool": "get_service_options" } } }, "security": [], "servers": [ { "url": "/api/v1/public/chauffeur/samuelz-chauffeur" } ] }, "operations": [ { "description": "Use first to learn this provider's service scope, required ride facts and local timeZone. Read current published facts; do not assume additional locations. Language defaults to English; pass locale=de for German, without changing timeZone. It gives no price or availability confirmation. Use get_customer_policy for booking rules, quote_ride for a price, or prepare_offer only after an explicit offer request.", "method": "GET", "path": "/services", "title": "Chauffeur service options", "tool": "get_service_options" }, { "description": "Use after get_service_options and before prepare_offer to retrieve current account, guest-booking and minimum-lead-time rules. Returns observedAt and revalidationRequired: refresh the rules before preparing an offer; no terms-validity window is promised. Review bound waiting and cancellation terms on the current offer before confirmation. On unavailable, report that the rules could not be read; do not invent them. For a price use quote_ride.", "method": "GET", "path": "/policy", "title": "Published customer terms", "tool": "get_customer_policy" }, { "description": "Use after get_service_options to calculate an anonymous price preview for complete ride facts in the provider timeZone. No contact is needed. Resolve missing return or hourly facts before quoting. The calculatedAt preview requires revalidation; no price-validity window is guaranteed. For rate_limited wait retryAfterSeconds. For review_required follow the returned guidance; it does not prove vehicle unavailability. No offer, reservation, charge or message is created. Call prepare_offer only for an explicit offer request.", "method": "POST", "path": "/quotes", "title": "Chauffeur price preview", "tool": "quote_ride" }, { "description": "Use only for an explicit offer request with offerRequested=true, complete ride facts and email OR E.164 phone. Creates one unpaid draft and an offer link; the customer reviews bound terms and confirms via checkoutUrl. No charge or booking confirmation. Use quote_ride for price-only questions. Keep submissionId, resumeToken and inputs unchanged on retries; inspect get_offer_status on ambiguous/conflict. On rate_limited wait retryAfterSeconds. Changed facts need an explicitly requested new intent; expired or revised offers require current review.", "method": "POST", "path": "/offers/prepare", "title": "Prepare an unpaid chauffeur offer", "tool": "prepare_offer" }, { "description": "Use to read one existing request with its original submissionId/resumeToken pair within the original 24-hour window. Returns offer state or recorded booking/payment/fulfillment after payment; no pricing call or new business action. For pending, wait retryAfterSeconds and retry that pair. For ambiguous/conflict inspect that intent; not_found denies access and unavailable is not vehicle evidence. Open customerPortalUrl for private login. No locale (original language), history, cancellation or modification.", "method": "POST", "path": "/offers/status", "title": "Read prepared offer status", "tool": "get_offer_status" } ], "profiles": [ { "id": "Full5", "instructions": "Help customers prepare a chauffeur transfer. Language defaults to English; pass locale=de for German where supported. get_offer_status preserves the original language and accepts no locale. Ask for complete ride facts. All times use the service time zone. Quotes are price previews, not vehicle availability or bookings. Read published customer terms with get_customer_policy. Call prepare_offer only after an explicit customer request with offerRequested=true and one email or E.164 phone. It can create one unpaid reservation and binding offer for an eligible ride. The customer must review the complete bound terms and explicitly confirm on checkoutUrl. Use get_offer_status for the original submission only, including recorded booking/payment/fulfillment after payment. Open customerPortalUrl for existing Samuelz ID login and private own-booking view. Never imply that these tools created payment, dispatch or a message.", "server": { "name": "chauffeur-customer", "version": "2.2.0" }, "tools": [ { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Use first to learn this provider's service scope, required ride facts and local timeZone. Read current published facts; do not assume additional locations. Language defaults to English; pass locale=de for German, without changing timeZone. It gives no price or availability confirmation. Use get_customer_policy for booking rules, quote_ride for a price, or prepare_offer only after an explicit offer request.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "locale": { "default": "en", "description": "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone.", "enum": [ "de", "en" ], "type": "string" }, "offerKey": { "description": "Optional existing published provider offer key. Selects its configured service location; not booking authority.", "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$", "type": "string" } }, "type": "object" }, "name": "get_service_options", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "hourlyRideFacts": { "items": { "type": "string" }, "type": "array" }, "location": { "additionalProperties": false, "properties": { "countryCode": { "type": "string" }, "key": { "type": "string" }, "label": { "type": "string" } }, "required": [ "key", "countryCode", "label" ], "type": "object" }, "nextAction": { "type": "string" }, "provider": { "type": "string" }, "requiredRideFacts": { "items": { "type": "string" }, "type": "array" }, "returnRideFacts": { "items": { "type": "string" }, "type": "array" }, "services": { "items": { "additionalProperties": false, "properties": { "availability": { "const": "requires_offer_review", "type": "string" }, "key": { "type": "string" }, "tripTypes": { "items": { "enum": [ "one_way", "return" ], "type": "string" }, "type": "array" } }, "required": [ "key", "tripTypes", "availability" ], "type": "object" }, "type": "array" }, "status": { "const": "available", "type": "string" }, "timeZone": { "type": "string" } }, "required": [ "status", "provider", "timeZone", "bookingUrl", "services", "requiredRideFacts", "returnRideFacts", "hourlyRideFacts", "nextAction" ], "type": "object" } ], "type": "object" }, "title": "Chauffeur service options" }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Use after get_service_options and before prepare_offer to retrieve current account, guest-booking and minimum-lead-time rules. Returns observedAt and revalidationRequired: refresh the rules before preparing an offer; no terms-validity window is promised. Review bound waiting and cancellation terms on the current offer before confirmation. On unavailable, report that the rules could not be read; do not invent them. For a price use quote_ride.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "locale": { "default": "en", "description": "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone.", "enum": [ "de", "en" ], "type": "string" }, "offerKey": { "description": "Optional existing published provider offer key. Selects its configured service location; not booking authority.", "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$", "type": "string" } }, "type": "object" }, "name": "get_customer_policy", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "bookingUrl": { "format": "uri", "type": "string" }, "observedAt": { "type": "string" }, "revalidationRequired": { "const": true, "type": "boolean" }, "scope": { "const": "booking_preparation", "type": "string" }, "status": { "const": "available", "type": "string" }, "terms": { "additionalProperties": false, "properties": { "accountRequired": { "type": "boolean" }, "bookerForGuestAllowed": { "type": "boolean" }, "bookingConfirmation": { "const": "after_confirmed_full_payment", "type": "string" }, "minimumLeadTimeMinutes": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "serviceSpecificTerms": { "const": "review_the_current_offer_before_confirmation", "type": "string" } }, "required": [ "minimumLeadTimeMinutes", "accountRequired", "bookerForGuestAllowed", "bookingConfirmation", "serviceSpecificTerms" ], "type": "object" }, "timeZone": { "type": "string" } }, "required": [ "status", "bookingUrl", "timeZone", "observedAt", "scope", "revalidationRequired", "terms", "bookingConfirmed" ], "type": "object" } ], "type": "object" }, "title": "Published customer terms" }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true }, "description": "Use after get_service_options to calculate an anonymous price preview for complete ride facts in the provider timeZone. No contact is needed. Resolve missing return or hourly facts before quoting. The calculatedAt preview requires revalidation; no price-validity window is guaranteed. For rate_limited wait retryAfterSeconds. For review_required follow the returned guidance; it does not prove vehicle unavailability. No offer, reservation, charge or message is created. Call prepare_offer only for an explicit offer request.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "locale": { "default": "en", "description": "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone.", "enum": [ "de", "en" ], "type": "string" }, "offerKey": { "description": "Optional existing published provider offer key. Selects its configured service location; not booking authority.", "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$", "type": "string" }, "ride": { "additionalProperties": false, "description": "Ride facts with distinct pickup/destination and valid local dates/times. Return requires returnDate/returnTime after pickup; one_way omits both. Hourly requires one_way and hours; transfers omit hours.", "properties": { "date": { "description": "Service date as YYYY-MM-DD in the provider timeZone returned by get_service_options; resolve relative dates first.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "destination": { "description": "Destination distinct from pickup, with city/municipality or postcode; e.g. München Hauptbahnhof, 80335 München. For hourly service describe the planned route or As directed.", "maxLength": 240, "minLength": 2, "type": "string" }, "flightNumber": { "description": "Flight number for an airport pickup, such as LH123; omit when not applicable.", "maxLength": 240, "minLength": 1, "type": "string" }, "hours": { "description": "Booked duration for hourly service; omit for transfers.", "maximum": 24, "minimum": 1, "type": "integer" }, "luggage": { "description": "Luggage count/type or fit requirements; unusual luggage may require review.", "maxLength": 240, "minLength": 1, "type": "string" }, "passengers": { "description": "Total people travelling; determines vehicle requirements, not availability or acceptance.", "maximum": 60, "minimum": 1, "type": "integer" }, "pickup": { "description": "Pickup address or named place with city/municipality or postcode; e.g. Flughafen München (MUC), 85356 München-Flughafen.", "maxLength": 240, "minLength": 2, "type": "string" }, "returnDate": { "description": "Return pickup date in the same local format as date, in the provider timeZone; provide only for return trips, after the outbound pickup.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "returnTime": { "description": "Return pickup time in the same local format as time and the same provider timeZone; provide only for return trips.", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$", "type": "string" }, "serviceType": { "description": "Set hourly for service booked by duration; omit for transfers.", "enum": [ "hourly" ], "type": "string" }, "time": { "description": "Local pickup time in 24-hour HH:mm format, in the provider timeZone (Samuelz: Europe/Berlin); not UTC or an offset timestamp.", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$", "type": "string" }, "tripType": { "description": "one_way for a single transfer or hourly service; return for outbound plus a separate later return transfer.", "enum": [ "one_way", "return" ], "type": "string" }, "vehiclePreference": { "description": "Volunteered vehicle preference only; no class, price or availability guarantee. Additional requirements may require review.", "maxLength": 240, "minLength": 1, "type": "string" } }, "required": [ "pickup", "destination", "date", "time", "passengers", "tripType" ], "type": "object" }, "specialRequests": { "description": "Optional ride requirements, at most 500 characters. Additional stops or unusual requirements may require review; do not include contact details in a quote.", "maxLength": 500, "minLength": 1, "type": "string" } }, "required": [ "ride" ], "type": "object" }, "name": "quote_ride", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "bookingUrl", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "bookingUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "quote": { "additionalProperties": false, "properties": { "billableHoursPerServiceLine": { "exclusiveMinimum": 0, "type": "number" }, "calculatedAt": { "type": "string" }, "currency": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "parkingIncluded": { "type": "boolean" }, "pricesIncludeVat": { "type": "boolean" }, "revalidationRequired": { "const": true, "type": "boolean" }, "serviceLines": { "items": { "additionalProperties": false, "properties": { "direction": { "enum": [ "outbound", "return" ], "type": "string" }, "grossAmountCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "direction", "grossAmountCents" ], "type": "object" }, "type": "array" }, "tollsIncluded": { "type": "boolean" }, "vatRateBasisPoints": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "vehicleCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "pricesIncludeVat", "vatRateBasisPoints", "parkingIncluded", "tollsIncluded", "vehicleCount", "billableHoursPerServiceLine", "serviceLines", "calculatedAt", "revalidationRequired" ], "type": "object" }, "status": { "const": "quoted", "type": "string" } }, "required": [ "status", "bookingUrl", "bookingConfirmed", "quote", "nextAction" ], "type": "object" } ], "type": "object" }, "title": "Chauffeur price preview" }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": true, "readOnlyHint": false }, "description": "Use only for an explicit offer request with offerRequested=true, complete ride facts and email OR E.164 phone. Creates one unpaid draft and an offer link; the customer reviews bound terms and confirms via checkoutUrl. No charge or booking confirmation. Use quote_ride for price-only questions. Keep submissionId, resumeToken and inputs unchanged on retries; inspect get_offer_status on ambiguous/conflict. On rate_limited wait retryAfterSeconds. Changed facts need an explicitly requested new intent; expired or revised offers require current review.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "contact": { "additionalProperties": false, "description": "Customer/booker contact for this explicitly requested offer: email OR E.164 phone is required. Contact does not authorize private booking/history access.", "properties": { "email": { "description": "Reachable customer/booker email, at most 254 characters; required if no phone is supplied.", "format": "email", "maxLength": 254, "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$", "type": "string" }, "fullName": { "description": "Optional customer/booker full name, 2–120 characters.", "maxLength": 120, "minLength": 2, "type": "string" }, "phone": { "description": "Reachable international E.164 phone, + followed by 7–15 digits, no spaces; required if no email is supplied.", "pattern": "^\\+[1-9][0-9]{6,14}$", "type": "string" } }, "type": "object" }, "distributionPartnerCapability": { "description": "Optional existing opaque dp_live_ capability issued to an approved distribution partner. Omit for normal customers; do not create or guess one.", "pattern": "^dp_live_[a-f0-9]{64}$", "type": "string" }, "firstTouchTrackingToken": { "description": "Optional existing server-issued first-touch UUID token for this tenant and consented attribution. Omit if none; never invent a token or source.", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$", "type": "string" }, "locale": { "default": "en", "description": "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone.", "enum": [ "de", "en" ], "type": "string" }, "offerKey": { "description": "Optional existing published provider offer key. Selects its configured service location; not booking authority.", "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$", "type": "string" }, "offerRequested": { "const": true, "description": "Must be true only after the customer explicitly requests an offer; a price question alone is insufficient consent.", "type": "boolean" }, "resumeToken": { "description": "Private 64-character hexadecimal secret generated for this submission. Reuse its original pair with submissionId for retries and status; never substitute account credentials.", "pattern": "^[a-f0-9]{64}$", "type": "string" }, "ride": { "additionalProperties": false, "description": "Ride facts with distinct pickup/destination and valid local dates/times. Return requires returnDate/returnTime after pickup; one_way omits both. Hourly requires one_way and hours; transfers omit hours.", "properties": { "date": { "description": "Service date as YYYY-MM-DD in the provider timeZone returned by get_service_options; resolve relative dates first.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "destination": { "description": "Destination distinct from pickup, with city/municipality or postcode; e.g. München Hauptbahnhof, 80335 München. For hourly service describe the planned route or As directed.", "maxLength": 240, "minLength": 2, "type": "string" }, "flightNumber": { "description": "Flight number for an airport pickup, such as LH123; omit when not applicable.", "maxLength": 240, "minLength": 1, "type": "string" }, "hours": { "description": "Booked duration for hourly service; omit for transfers.", "maximum": 24, "minimum": 1, "type": "integer" }, "luggage": { "description": "Luggage count/type or fit requirements; unusual luggage may require review.", "maxLength": 240, "minLength": 1, "type": "string" }, "passengers": { "description": "Total people travelling; determines vehicle requirements, not availability or acceptance.", "maximum": 60, "minimum": 1, "type": "integer" }, "pickup": { "description": "Pickup address or named place with city/municipality or postcode; e.g. Flughafen München (MUC), 85356 München-Flughafen.", "maxLength": 240, "minLength": 2, "type": "string" }, "returnDate": { "description": "Return pickup date in the same local format as date, in the provider timeZone; provide only for return trips, after the outbound pickup.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "returnTime": { "description": "Return pickup time in the same local format as time and the same provider timeZone; provide only for return trips.", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$", "type": "string" }, "serviceType": { "description": "Set hourly for service booked by duration; omit for transfers.", "enum": [ "hourly" ], "type": "string" }, "time": { "description": "Local pickup time in 24-hour HH:mm format, in the provider timeZone (Samuelz: Europe/Berlin); not UTC or an offset timestamp.", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$", "type": "string" }, "tripType": { "description": "one_way for a single transfer or hourly service; return for outbound plus a separate later return transfer.", "enum": [ "one_way", "return" ], "type": "string" }, "vehiclePreference": { "description": "Volunteered vehicle preference only; no class, price or availability guarantee. Additional requirements may require review.", "maxLength": 240, "minLength": 1, "type": "string" } }, "required": [ "pickup", "destination", "date", "time", "passengers", "tripType" ], "type": "object" }, "specialRequests": { "description": "Optional ride requirements, at most 500 characters. Additional stops or unusual requirements may require review; do not include contact details in a quote.", "maxLength": 500, "minLength": 1, "type": "string" }, "submissionId": { "description": "Identifies one offer intent. Generate a UUID for a requested new offer; keep it with the same resumeToken for unchanged retries and status.", "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)$", "type": "string" } }, "required": [ "submissionId", "resumeToken", "offerRequested", "contact", "ride" ], "type": "object" }, "name": "prepare_offer", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "pending", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "enum": [ "conflict", "ambiguous", "not_found" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "booking": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "bookingKey": { "maxLength": 128, "minLength": 1, "type": "string" }, "bookingReference": { "minLength": 1, "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "fulfillment": { "additionalProperties": false, "properties": { "chauffeurAssignmentRecorded": { "type": "boolean" }, "completionRecorded": { "type": "boolean" }, "vehicleAssignmentRecorded": { "type": "boolean" } }, "required": [ "chauffeurAssignmentRecorded", "vehicleAssignmentRecorded", "completionRecorded" ], "type": "object" }, "payment": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "status": { "const": "available", "type": "string" } }, "required": [ "status", "bookingKey", "bookingReference", "booking", "payment", "fulfillment", "customerPortalUrl" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message", "review" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "expired", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "checkoutUrl": { "format": "uri", "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "offer": { "additionalProperties": false, "properties": { "completeTermsBound": { "const": true, "type": "boolean" }, "currency": { "const": "EUR", "type": "string" }, "customerConfirmationRequired": { "const": true, "type": "boolean" }, "expiresAt": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "expiresAt", "customerConfirmationRequired", "completeTermsBound" ], "type": "object" }, "status": { "const": "prepared", "type": "string" }, "termsUrl": { "format": "uri", "type": "string" } }, "required": [ "status", "bookingConfirmed", "checkoutUrl", "termsUrl", "offer", "nextAction" ], "type": "object" } ], "type": "object" }, "title": "Prepare an unpaid chauffeur offer" }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Use to read one existing request with its original submissionId/resumeToken pair within the original 24-hour window. Returns offer state or recorded booking/payment/fulfillment after payment; no pricing call or new business action. For pending, wait retryAfterSeconds and retry that pair. For ambiguous/conflict inspect that intent; not_found denies access and unavailable is not vehicle evidence. Open customerPortalUrl for private login. No locale (original language), history, cancellation or modification.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "resumeToken": { "description": "Private 64-character hexadecimal secret generated for this submission. Reuse its original pair with submissionId for retries and status; never substitute account credentials.", "pattern": "^[a-f0-9]{64}$", "type": "string" }, "submissionId": { "description": "Identifies one offer intent. Generate a UUID for a requested new offer; keep it with the same resumeToken for unchanged retries and status.", "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)$", "type": "string" } }, "required": [ "submissionId", "resumeToken" ], "type": "object" }, "name": "get_offer_status", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "pending", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "enum": [ "conflict", "ambiguous", "not_found" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "booking": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "bookingKey": { "maxLength": 128, "minLength": 1, "type": "string" }, "bookingReference": { "minLength": 1, "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "fulfillment": { "additionalProperties": false, "properties": { "chauffeurAssignmentRecorded": { "type": "boolean" }, "completionRecorded": { "type": "boolean" }, "vehicleAssignmentRecorded": { "type": "boolean" } }, "required": [ "chauffeurAssignmentRecorded", "vehicleAssignmentRecorded", "completionRecorded" ], "type": "object" }, "payment": { "additionalProperties": false, "properties": { "recordedStatus": { "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "recordedStatus" ], "type": "object" }, "status": { "const": "available", "type": "string" } }, "required": [ "status", "bookingKey", "bookingReference", "booking", "payment", "fulfillment", "customerPortalUrl" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message", "review" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "expired", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "checkoutUrl": { "format": "uri", "type": "string" }, "customerPortalUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "offer": { "additionalProperties": false, "properties": { "completeTermsBound": { "const": true, "type": "boolean" }, "currency": { "const": "EUR", "type": "string" }, "customerConfirmationRequired": { "const": true, "type": "boolean" }, "expiresAt": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "expiresAt", "customerConfirmationRequired", "completeTermsBound" ], "type": "object" }, "status": { "const": "prepared", "type": "string" }, "termsUrl": { "format": "uri", "type": "string" } }, "required": [ "status", "bookingConfirmed", "checkoutUrl", "termsUrl", "offer", "nextAction" ], "type": "object" } ], "type": "object" }, "title": "Read prepared offer status" } ], "url": "https://platform-api.samuelz.com/api/v1/mcp/chauffeur/samuelz-chauffeur" }, { "id": "Quote3", "instructions": "Provide anonymous price previews with get_service_options, get_customer_policy and quote_ride. Language defaults to English; pass locale=de for German. Ask for ride facts only. No login or customer contact is required. Quotes never guarantee availability. There are no offer preparation, status, booking, payment or messaging tools on this profile.", "server": { "name": "chauffeur-anonymous-quotes", "version": "1.3.0" }, "tools": [ { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Use first to learn the active location, local timeZone and required transfer/return/hourly facts. Language defaults to English; pass locale=de for German. Use get_customer_policy for preview/booking rules or quote_ride for a price. This gives no price or availability confirmation; no login/contact is needed.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "locale": { "default": "en", "description": "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone.", "enum": [ "de", "en" ], "type": "string" }, "offerKey": { "description": "Optional existing published provider offer key. Selects its configured service location; not booking authority.", "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$", "type": "string" } }, "type": "object" }, "name": "get_service_options", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "hourlyRideFacts": { "items": { "type": "string" }, "type": "array" }, "location": { "additionalProperties": false, "properties": { "countryCode": { "type": "string" }, "key": { "type": "string" }, "label": { "type": "string" } }, "required": [ "key", "countryCode", "label" ], "type": "object" }, "nextAction": { "type": "string" }, "provider": { "type": "string" }, "requiredRideFacts": { "items": { "type": "string" }, "type": "array" }, "returnRideFacts": { "items": { "type": "string" }, "type": "array" }, "services": { "items": { "additionalProperties": false, "properties": { "availability": { "const": "requires_offer_review", "type": "string" }, "key": { "enum": [ "chauffeur_transfer", "chauffeur_hourly" ], "type": "string" }, "tripTypes": { "items": { "enum": [ "one_way", "return" ], "type": "string" }, "type": "array" } }, "required": [ "key", "tripTypes", "availability" ], "type": "object" }, "type": "array" }, "status": { "const": "available", "type": "string" }, "timeZone": { "type": "string" } }, "required": [ "status", "provider", "timeZone", "location", "services", "requiredRideFacts", "returnRideFacts", "hourlyRideFacts", "nextAction" ], "type": "object" } ], "type": "object" }, "title": "Chauffeur service options" }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Use after get_service_options to retrieve anonymous-preview access rules and current terms for a later booking. Preview needs no account or contact; booking lead time does not restrict preview access. observedAt is the read time, not a terms-validity window. On unavailable, report that the rules could not be read. Use quote_ride for a price; this profile cannot create offers, reservations or bookings.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "locale": { "default": "en", "description": "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone.", "enum": [ "de", "en" ], "type": "string" }, "offerKey": { "description": "Optional existing published provider offer key. Selects its configured service location; not booking authority.", "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$", "type": "string" } }, "type": "object" }, "name": "get_customer_policy", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "accountRequired": { "const": false, "type": "boolean" }, "bookingTerms": { "additionalProperties": false, "properties": { "accountRequired": { "type": "boolean" }, "bookerForGuestAllowed": { "type": "boolean" }, "bookingConfirmation": { "const": "after_confirmed_full_payment", "type": "string" }, "minimumLeadTimeMinutes": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "serviceSpecificTerms": { "const": "review_the_current_offer_before_confirmation", "type": "string" } }, "required": [ "minimumLeadTimeMinutes", "accountRequired", "bookerForGuestAllowed", "bookingConfirmation", "serviceSpecificTerms" ], "type": "object" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "type": "string" }, "observedAt": { "type": "string" }, "scope": { "const": "anonymous_price_preview", "type": "string" }, "status": { "const": "available", "type": "string" }, "timeZone": { "type": "string" } }, "required": [ "status", "scope", "timeZone", "accountRequired", "customerContactRequired", "observedAt", "nextAction", "bookingTerms" ], "type": "object" } ], "type": "object" }, "title": "Published customer terms" }, { "annotations": { "destructiveHint": false, "idempotentHint": false, "openWorldHint": true, "readOnlyHint": true }, "description": "Use after get_service_options to calculate an anonymous price preview for complete ride facts in the provider timeZone. No account or contact is needed. Resolve missing return or hourly facts before quoting. Revalidate the calculatedAt preview before booking; no price-validity window is guaranteed. For rate_limited wait retryAfterSeconds; follow review_required guidance without inferring vehicle unavailability. No offer, reservation, payment or message is created; this profile has no offer/status tools.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "locale": { "default": "en", "description": "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone.", "enum": [ "de", "en" ], "type": "string" }, "offerKey": { "description": "Optional existing published provider offer key. Selects its configured service location; not booking authority.", "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$", "type": "string" }, "ride": { "additionalProperties": false, "description": "Ride facts with distinct pickup/destination and valid local dates/times. Return requires returnDate/returnTime after pickup; one_way omits both. Hourly requires one_way and hours; transfers omit hours.", "properties": { "date": { "description": "Service date as YYYY-MM-DD in the provider timeZone returned by get_service_options; resolve relative dates first.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "destination": { "description": "Destination distinct from pickup, with city/municipality or postcode; e.g. München Hauptbahnhof, 80335 München. For hourly service describe the planned route or As directed.", "maxLength": 240, "minLength": 2, "type": "string" }, "flightNumber": { "description": "Flight number for an airport pickup, such as LH123; omit when not applicable.", "maxLength": 240, "minLength": 1, "type": "string" }, "hours": { "description": "Booked duration for hourly service; omit for transfers.", "maximum": 24, "minimum": 1, "type": "integer" }, "luggage": { "description": "Luggage count/type or fit requirements; unusual luggage may require review.", "maxLength": 240, "minLength": 1, "type": "string" }, "passengers": { "description": "Total people travelling; determines vehicle requirements, not availability or acceptance.", "maximum": 60, "minimum": 1, "type": "integer" }, "pickup": { "description": "Pickup address or named place with city/municipality or postcode; e.g. Flughafen München (MUC), 85356 München-Flughafen.", "maxLength": 240, "minLength": 2, "type": "string" }, "returnDate": { "description": "Return pickup date in the same local format as date, in the provider timeZone; provide only for return trips, after the outbound pickup.", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "type": "string" }, "returnTime": { "description": "Return pickup time in the same local format as time and the same provider timeZone; provide only for return trips.", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$", "type": "string" }, "serviceType": { "description": "Set hourly for service booked by duration; omit for transfers.", "enum": [ "hourly" ], "type": "string" }, "time": { "description": "Local pickup time in 24-hour HH:mm format, in the provider timeZone (Samuelz: Europe/Berlin); not UTC or an offset timestamp.", "pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$", "type": "string" }, "tripType": { "description": "one_way for a single transfer or hourly service; return for outbound plus a separate later return transfer.", "enum": [ "one_way", "return" ], "type": "string" }, "vehiclePreference": { "description": "Volunteered vehicle preference only; no class, price or availability guarantee. Additional requirements may require review.", "maxLength": 240, "minLength": 1, "type": "string" } }, "required": [ "pickup", "destination", "date", "time", "passengers", "tripType" ], "type": "object" }, "specialRequests": { "description": "Optional ride requirements, at most 500 characters. Additional stops or unusual requirements may require review; do not include contact details in a quote.", "maxLength": 500, "minLength": 1, "type": "string" } }, "required": [ "ride" ], "type": "object" }, "name": "quote_ride", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "retryAfterSeconds": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" }, "status": { "const": "rate_limited", "type": "string" } }, "required": [ "status", "bookingUrl", "retryAfterSeconds" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingUrl": { "format": "uri", "type": "string" }, "message": { "type": "string" }, "review": { "additionalProperties": false, "properties": { "availabilityConfirmed": { "const": false, "type": "boolean" }, "code": { "enum": [ "additional_requirements_review", "model_guarantee_review", "address_review", "service_scope_review", "booking_window_review", "route_review" ], "type": "string" }, "customerContactRequired": { "const": false, "type": "boolean" }, "nextAction": { "const": "review_requirements", "type": "string" } }, "required": [ "code", "customerContactRequired", "availabilityConfirmed", "nextAction" ], "type": "object" }, "status": { "const": "review_required", "type": "string" } }, "required": [ "status", "bookingUrl", "message" ], "type": "object" }, { "additionalProperties": false, "properties": { "bookingConfirmed": { "const": false, "type": "boolean" }, "bookingUrl": { "format": "uri", "type": "string" }, "nextAction": { "type": "string" }, "quote": { "additionalProperties": false, "properties": { "billableHoursPerServiceLine": { "exclusiveMinimum": 0, "type": "number" }, "calculatedAt": { "type": "string" }, "currency": { "type": "string" }, "grossTotalCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "parkingIncluded": { "type": "boolean" }, "pricesIncludeVat": { "type": "boolean" }, "revalidationRequired": { "const": true, "type": "boolean" }, "serviceLines": { "items": { "additionalProperties": false, "properties": { "direction": { "enum": [ "outbound", "return" ], "type": "string" }, "grossAmountCents": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" } }, "required": [ "direction", "grossAmountCents" ], "type": "object" }, "type": "array" }, "tollsIncluded": { "type": "boolean" }, "vatRateBasisPoints": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "vehicleCount": { "exclusiveMinimum": 0, "maximum": 9007199254740991, "type": "integer" } }, "required": [ "currency", "grossTotalCents", "pricesIncludeVat", "vatRateBasisPoints", "parkingIncluded", "tollsIncluded", "vehicleCount", "billableHoursPerServiceLine", "serviceLines", "calculatedAt", "revalidationRequired" ], "type": "object" }, "status": { "const": "quoted", "type": "string" } }, "required": [ "status", "bookingUrl", "bookingConfirmed", "quote", "nextAction" ], "type": "object" } ], "type": "object" }, "title": "Chauffeur price preview" } ], "url": "https://platform-api.samuelz.com/api/v1/mcp/chauffeur/samuelz-chauffeur/quote-only" }, { "id": "Info2", "instructions": "Provide published chauffeur service and customer policy information only. Language defaults to English; pass locale=de for German. This server has no live prices, offers, reservations, checkout or booking tools.", "server": { "name": "chauffeur-service-information", "version": "1.1.0" }, "tools": [ { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Read published chauffeur service scope and required trip facts. Language defaults to English; pass locale=de for German. TimeZone remains the provider local time zone. This tool cannot quote, offer, reserve or book.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "locale": { "default": "en", "description": "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone.", "enum": [ "de", "en" ], "type": "string" }, "offerKey": { "description": "Optional existing published provider offer key. Selects its configured service location; not booking authority.", "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$", "type": "string" } }, "type": "object" }, "name": "get_service_options", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "nextAction": { "type": "string" }, "provider": { "type": "string" }, "requiredRideFacts": { "items": { "type": "string" }, "type": "array" }, "returnRideFacts": { "items": { "type": "string" }, "type": "array" }, "services": { "items": { "additionalProperties": false, "properties": { "availability": { "const": "requires_offer_review", "type": "string" }, "key": { "type": "string" }, "tripTypes": { "items": { "enum": [ "one_way", "return" ], "type": "string" }, "type": "array" } }, "required": [ "key", "tripTypes", "availability" ], "type": "object" }, "type": "array" }, "status": { "const": "available", "type": "string" }, "timeZone": { "type": "string" } }, "required": [ "status", "provider", "timeZone", "services", "requiredRideFacts", "returnRideFacts", "nextAction" ], "type": "object" } ], "type": "object" }, "title": "Chauffeur service options" }, { "annotations": { "destructiveHint": false, "idempotentHint": true, "openWorldHint": false, "readOnlyHint": true }, "description": "Read published customer policy. Language defaults to English; pass locale=de for German. TimeZone remains the provider local time zone. This tool cannot quote, offer, reserve or book.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "locale": { "default": "en", "description": "Use the customer's requested language for text and booking links: en by default, de for German. Preserve it on retries; pickup times stay in the provider time zone.", "enum": [ "de", "en" ], "type": "string" }, "offerKey": { "description": "Optional existing published provider offer key. Selects its configured service location; not booking authority.", "pattern": "^[a-z0-9][a-z0-9_-]{0,79}$", "type": "string" } }, "type": "object" }, "name": "get_customer_policy", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "oneOf": [ { "additionalProperties": false, "properties": { "status": { "const": "invalid_request", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "unavailable", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "additionalProperties": false, "properties": { "status": { "const": "available", "type": "string" }, "terms": { "additionalProperties": false, "properties": { "accountRequired": { "type": "boolean" }, "bookerForGuestAllowed": { "type": "boolean" }, "bookingConfirmation": { "const": "after_confirmed_full_payment", "type": "string" }, "minimumLeadTimeMinutes": { "maximum": 9007199254740991, "minimum": 0, "type": "integer" }, "serviceSpecificTerms": { "const": "review_the_current_offer_before_confirmation", "type": "string" } }, "required": [ "minimumLeadTimeMinutes", "accountRequired", "bookerForGuestAllowed", "bookingConfirmation", "serviceSpecificTerms" ], "type": "object" }, "timeZone": { "type": "string" } }, "required": [ "status", "timeZone", "terms" ], "type": "object" } ], "type": "object" }, "title": "Published customer terms" } ], "url": "https://platform-api.samuelz.com/api/v1/mcp/chauffeur/samuelz-chauffeur/info-only" } ], "provenance": { "contractSha256": "c14264d57b880096325adb58a78e7ad669701023a05ac1c2317a0049ade5d3b7", "sources": { "apps/backend/src/customer-api/chauffeur/customer-portal-link.ts": "c3981a029f06b8f3a8ff7b973169f2f7522856e9bba04f6b4d5fa66d02b1e1f0", "apps/backend/src/customer-api/chauffeur/module.ts": "75ff1b40f14b20f142bfbe9350e65095a92d64c051dc7bafe8f4d537149a6679", "apps/backend/src/customer-api/chauffeur/offer-details.ts": "3ab665b2f8e36259afca0eda078b1840739c9d2502b699af298f9c616a19cbe5", "apps/backend/src/customer-api/chauffeur/offer-preparation.ts": "38d6ff00badfaa1eeb2f7cf0b158ae4d5dcf7be746e475468beaa1298502535d", "apps/backend/src/customer-api/chauffeur/offer.ts": "aa69a643bac48ee4960d4ed8c77859f703125c1e1c6faeeef672f63d6fdef3cd", "apps/backend/src/customer-api/chauffeur/quote-module.ts": "4a6ab9fcbffccb40d376dfbb824c570e42d37735d63f00c61d70a5834b0b0c54", "apps/backend/src/customer-api/chauffeur/review.ts": "5e869ddf2912cd761c3632132b52cc59df95ff827c4155e8258a770aa49f54d3", "apps/backend/src/customer-api/chauffeur/ride-intent.ts": "545b83a73b024a3646f1f9a954ffc9e7cc269e97c3bea343ba329afed7c60cd2", "apps/backend/src/customer-api/chauffeur/schemas.ts": "f00e84f983ee813b23a56d339298b7204edb7884f75d1230a96d29cea3ce5f17", "apps/backend/src/customer-api/contract.ts": "f251ff01ebc546c3cedbf816f3c6a0d9043ad5693c81116170c6c08b273148c5", "apps/backend/src/customer-api/customer-booking-read.ts": "ef827754af9bfbf23e65227879b3021825bf4ac458dc203b08a9dbd5db87a00f", "apps/backend/src/customer-api/customer-submission-booking-read.ts": "23cd13cc8361ce16059891fe9f75ae3d58c51e0dca5c6148e10b395eeaffafe6", "apps/backend/src/customer-api/openapi.ts": "a522d1539e598927970e44c6bf50e21fbdd0399ce961353afc817f9287d97cf4", "apps/backend/src/mcp/chauffeur/quote-profile-schemas.ts": "c12e6387776629ae09daca169254770da024a7f41696a5f29be73c76698fcae9", "apps/backend/src/mcp/chauffeur/quote.ts": "dd56d5740ca3961c09eeccce33112ad2d16f6d99ce128aacd38cb5d63f085451", "apps/backend/src/mcp/chauffeur/server.ts": "7571aa3252487e36059d555363ce105a8b3e29acb9e01e8367ef76ee80c4763f", "apps/backend/src/mcp/chauffeur/tool-input.ts": "fbd6152eb78a508ff947de07abc6b408517c8db825f8b7baabf94eea32960bc0", "apps/backend/src/mcp/chauffeur/tool-result-guidance.ts": "988204d8a1f8324cc59ede48f1b6463898bc1bc110c6801b3158731e4701cf5b", "apps/backend/src/routes/app-session-routes.ts": "8adb2e2e8f55b87536d297c601de8a103f7c3e30df0726630c3168c71d8a6099", "apps/backend/src/routes/chauffeur-mcp.ts": "031e1a5260dbbac2bf845cfdd505398c9e5a9ce61420ce92758b97b5f84dab47", "apps/backend/src/routes/customer-booking-client.ts": "f06b26f621e4672f4d38fddaecf9aeaaa4f743195ca3b3ac01faf11d2dfdb70c", "apps/backend/src/routes/customer-booking-page.ts": "45360b1cf1a2282d4fa53dcd2519dd745964d6d22a54338f8cabb74089d40bbe", "apps/backend/src/routes/customer-booking.ts": "9ba05ceb6d12d580fbd7823bbfe27b8489a215b49af97bee1c81eb55e6b1e8f8", "apps/backend/src/routes/index.ts": "dfe79e2356e853d0bf7fca37843241753356eaaa73dae84e2a8279b92704b815", "apps/backend/src/services/request-form-submission-resume-capability.ts": "a24f7c47cdef55548e3fdd152d05a30b02bb3af79cf49d2b12f1782bd0cbd685", "apps/backend/src/web/booking-read-authority.ts": "647bec086b14ab8e37b94a9fc3c2ed68fde20ecc8770eca3dbab4d6c22ab3d97", "packages/ui/brand-runtime-urls.ts": "9ac02aa84d08442648869a6a12dbfcf91fca6195e6d3d06810cd39d916442922", "scripts/customer-api-docs.mjs": "5e66e3cdd586de66ffae22f71ada85a44f61025df40206836247e823404eeb37", "scripts/lib/customer-api-docs-contract.ts": "f5096924cffebc7d4d221b88625d0c73c5b739e486d0c1c42e0b106356dbcdff", "scripts/lib/customer-api-docs-provenance.mjs": "f887b8701ad8d741d362de2a8037b57fe40f69511d8f4e1a32e519fb6ed6ef7a", "scripts/lib/customer-api-docs-render.mjs": "763a0efa83967d63485575b3ea20e1a99689427c6922825e01631b98ab4c7a55", "server.json": "3b86a5a7f4557aa4b32abab3ce5abfb21947ba35399fe92167ceec414b58599d" } }, "registry": { "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json", "description": "Public chauffeur prices, policy and consent-led offers for travel bookers and AI assistants.", "name": "io.github.samuelzcom/chauffeur-booking", "remotes": [ { "type": "streamable-http", "url": "https://platform-api.samuelz.com/api/v1/mcp/chauffeur/samuelz-chauffeur" } ], "title": "Samuelz Chauffeur Booking", "version": "1.0.0", "websiteUrl": "https://samuelz.com/en/integrations" }, "restUrl": "https://platform-api.samuelz.com/api/v1/public/chauffeur/samuelz-chauffeur", "resumeCapabilityTtlSeconds": 86400, "schemaVersion": 1 }