Samuelz Chauffeur Booking
Public chauffeur prices, policy and consent-led offers for travel bookers and AI assistants.
Should I use this
Quality & Safety
A
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~3,474Tokens (tool definitions)
~7.2 KBTypical response size
Significant attention impact (2.71% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"chauffeur-booking": {
"url": "https://platform-api.samuelz.com/api/v1/mcp/chauffeur/samuelz-chauffeur"
}
}
}Remote endpoints
https://platform-api.samuelz.com/api/v1/mcp/chauffeur/samuelz-chauffeurstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢get_service_options(locale)
Read this provider's public service, required ride facts and booking link.
Input Schema
{
"type": "object",
"properties": {
"locale": {
"default": "de",
"type": "string",
"enum": [
"de",
"en"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "invalid_request"
}
},
"required": [
"status"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "unavailable"
},
"bookingUrl": {
"type": "string",
"format": "uri"
}
},
"required": [
"status"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "available"
},
"provider": {
"type": "string"
},
"timeZone": {
"type": "string"
},
"bookingUrl": {
"type": "string",
"format": "uri"
},
"services": {
"type": "array",
"items": {
"type": "object",
"properties": {
"key": {
"type": "string"
},
"tripTypes": {
"type": "array",
"items": {
"type": "string",
"enum": [
"one_way",
"return"
]
}
},
"availability": {
"type": "string",
"const": "requires_offer_review"
}
},
"required": [
"key",
"tripTypes",
"availability"
],
"additionalProperties": false
}
},
"requiredRideFacts": {
"type": "array",
"items": {
"type": "string"
}
},
"returnRideFacts": {
"type": "array",
"items": {
"type": "string"
}
},
"nextAction": {
"type": "string"
}
},
"required": [
"status",
"provider",
"timeZone",
"bookingUrl",
"services",
"requiredRideFacts",
"returnRideFacts",
"nextAction"
],
"additionalProperties": false
}
]
}🟢get_customer_policy(locale)
Read current booking preparation terms, account requirement, guest booking and minimum lead time. Service-specific cancellation and waiting terms must be checked on the current offer before confirmation. This does not confirm a booking.
Input Schema
{
"type": "object",
"properties": {
"locale": {
"default": "de",
"type": "string",
"enum": [
"de",
"en"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "invalid_request"
}
},
"required": [
"status"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "unavailable"
},
"bookingUrl": {
"type": "string",
"format": "uri"
}
},
"required": [
"status"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "available"
},
"bookingUrl": {
"type": "string",
"format": "uri"
},
"timeZone": {
"type": "string"
},
"observedAt": {
"type": "string"
},
"scope": {
"type": "string",
"const": "booking_preparation"
},
"revalidationRequired": {
"type": "boolean",
"const": true
},
"terms": {
"type": "object",
"properties": {
"minimumLeadTimeMinutes": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"accountRequired": {
"type": "boolean"
},
"bookerForGuestAllowed": {
"type": "boolean"
},
"bookingConfirmation": {
"type": "string",
"const": "after_confirmed_full_payment"
},
"serviceSpecificTerms": {
"type": "string",
"const": "review_the_current_offer_before_confirmation"
}
},
"required": [
"minimumLeadTimeMinutes",
"accountRequired",
"bookerForGuestAllowed",
"bookingConfirmation",
"serviceSpecificTerms"
],
"additionalProperties": false
},
"bookingConfirmed": {
"type": "boolean",
"const": false
}
},
"required": [
"status",
"bookingUrl",
"timeZone",
"observedAt",
"scope",
"revalidationRequired",
"terms",
"bookingConfirmed"
],
"additionalProperties": false
}
]
}🟢quote_ride(locale, ride, specialRequests)
Get a current price preview for complete ride facts, using local service time and addresses with city or postcode. No availability guarantee, booking, charge, message or reservation. Do not include customer contact details.
Input Schema
{
"type": "object",
"properties": {
"locale": {
"default": "de",
"type": "string",
"enum": [
"de",
"en"
]
},
"ride": {
"type": "object",
"properties": {
"pickup": {
"type": "string",
"minLength": 2,
"maxLength": 240
},
"destination": {
"type": "string",
"minLength": 2,
"maxLength": 240
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"time": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
},
"passengers": {
"type": "integer",
"minimum": 1,
"maximum": 60
},
"tripType": {
"type": "string",
"enum": [
"one_way",
"return"
]
},
"returnDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"returnTime": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
},
"serviceType": {
"type": "string",
"enum": [
"hourly"
]
},
"hours": {
"type": "integer",
"minimum": 1,
"maximum": 24
}
},
"required": [
"pickup",
"destination",
"date",
"time",
"passengers",
"tripType"
],
"additionalProperties": false
},
"specialRequests": {
"type": "string",
"minLength": 1,
"maxLength": 500
}
},
"required": [
"ride"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "invalid_request"
}
},
"required": [
"status"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "unavailable"
},
"bookingUrl": {
"type": "string",
"format": "uri"
}
},
"required": [
"status"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "rate_limited"
},
"bookingUrl": {
"type": "string",
"format": "uri"
},
"retryAfterSeconds": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"status",
"bookingUrl",
"retryAfterSeconds"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "review_required"
},
"bookingUrl": {
"type": "string",
"format": "uri"
},
"message": {
"type": "string"
}
},
"required": [
"status",
"bookingUrl",
"message"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "quoted"
},
"bookingUrl": {
"type": "string",
"format": "uri"
},
"bookingConfirmed": {
"type": "boolean",
"const": false
},
"quote": {
"type": "object",
"properties": {
"currency": {
"type": "string"
},
"grossTotalCents": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"pricesIncludeVat": {
"type": "boolean"
},
"vatRateBasisPoints": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"parkingIncluded": {
"type": "boolean"
},
"tollsIncluded": {
"type": "boolean"
},
"vehicleCount": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"billableHoursPerServiceLine": {
"type": "number",
"exclusiveMinimum": 0
},
"serviceLines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"direction": {
"type": "string",
"enum": [
"outbound",
"return"
]
},
"grossAmountCents": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"direction",
"grossAmountCents"
],
"additionalProperties": false
}
},
"calculatedAt": {
"type": "string"
},
"revalidationRequired": {
"type": "boolean",
"const": true
}
},
"required": [
"currency",
"grossTotalCents",
"pricesIncludeVat",
"vatRateBasisPoints",
"parkingIncluded",
"tollsIncluded",
"vehicleCount",
"billableHoursPerServiceLine",
"serviceLines",
"calculatedAt",
"revalidationRequired"
],
"additionalProperties": false
},
"nextAction": {
"type": "string"
}
},
"required": [
"status",
"bookingUrl",
"bookingConfirmed",
"quote",
"nextAction"
],
"additionalProperties": false
}
]
}🟡prepare_offer(locale, submissionId, resumeToken, distributionPartnerCapability, contact, ...)
Prepare exactly one unpaid reservation and binding offer for an authorized one-way transfer or hourly service. Requires real customer contact data and a client-generated submissionId and resumeToken. Approved distribution partners may add their opaque capability for tenant-bound attribution. The customer must review the complete bound terms and confirm on checkoutUrl; this does not charge or confirm the booking.
Input Schema
{
"type": "object",
"properties": {
"locale": {
"default": "de",
"type": "string",
"enum": [
"de",
"en"
]
},
"submissionId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"resumeToken": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"distributionPartnerCapability": {
"type": "string",
"pattern": "^dp_live_[a-f0-9]{64}$"
},
"contact": {
"type": "object",
"properties": {
"fullName": {
"type": "string",
"minLength": 2,
"maxLength": 120
},
"email": {
"type": "string",
"maxLength": 254,
"format": "email",
"pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
},
"phone": {
"type": "string",
"pattern": "^\\+[1-9][0-9]{6,14}$"
}
},
"required": [
"fullName",
"email",
"phone"
],
"additionalProperties": false
},
"ride": {
"type": "object",
"properties": {
"pickup": {
"type": "string",
"minLength": 2,
"maxLength": 240
},
"destination": {
"type": "string",
"minLength": 2,
"maxLength": 240
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"time": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
},
"passengers": {
"type": "integer",
"minimum": 1,
"maximum": 60
},
"tripType": {
"type": "string",
"enum": [
"one_way",
"return"
]
},
"returnDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$"
},
"returnTime": {
"type": "string",
"pattern": "^(?:[01]\\d|2[0-3]):[0-5]\\d$"
},
"serviceType": {
"type": "string",
"enum": [
"hourly"
]
},
"hours": {
"type": "integer",
"minimum": 1,
"maximum": 24
}
},
"required": [
"pickup",
"destination",
"date",
"time",
"passengers",
"tripType"
],
"additionalProperties": false
}
},
"required": [
"submissionId",
"resumeToken",
"contact",
"ride"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "invalid_request"
}
},
"required": [
"status"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "unavailable"
},
"bookingUrl": {
"type": "string",
"format": "uri"
}
},
"required": [
"status"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "pending"
},
"retryAfterSeconds": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"status",
"retryAfterSeconds"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "rate_limited"
},
"retryAfterSeconds": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"status",
"retryAfterSeconds"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"conflict",
"ambiguous",
"not_found"
]
}
},
"required": [
"status"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "prepared"
},
"bookingConfirmed": {
"type": "boolean",
"const": false
},
"checkoutUrl": {
"type": "string",
"format": "uri"
},
"termsUrl": {
"type": "string",
"format": "uri"
},
"offer": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "EUR"
},
"grossTotalCents": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"expiresAt": {
"type": "string"
},
"customerConfirmationRequired": {
"type": "boolean",
"const": true
},
"completeTermsBound": {
"type": "boolean",
"const": true
}
},
"required": [
"currency",
"grossTotalCents",
"expiresAt",
"customerConfirmationRequired",
"completeTermsBound"
],
"additionalProperties": false
},
"nextAction": {
"type": "string"
}
},
"required": [
"status",
"bookingConfirmed",
"checkoutUrl",
"termsUrl",
"offer",
"nextAction"
],
"additionalProperties": false
}
]
}🟢get_offer_status(submissionId, resumeToken)
Read one prepared offer by its submissionId and resumeToken. No quote, booking, payment, message or provider request is created.
Input Schema
{
"type": "object",
"properties": {
"submissionId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
"resumeToken": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
},
"required": [
"submissionId",
"resumeToken"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Output Schema
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "invalid_request"
}
},
"required": [
"status"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "unavailable"
},
"bookingUrl": {
"type": "string",
"format": "uri"
}
},
"required": [
"status"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "pending"
},
"retryAfterSeconds": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"status",
"retryAfterSeconds"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "rate_limited"
},
"retryAfterSeconds": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
},
"required": [
"status",
"retryAfterSeconds"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"conflict",
"ambiguous",
"not_found"
]
}
},
"required": [
"status"
],
"additionalProperties": false
},
{
"type": "object",
"properties": {
"status": {
"type": "string",
"const": "prepared"
},
"bookingConfirmed": {
"type": "boolean",
"const": false
},
"checkoutUrl": {
"type": "string",
"format": "uri"
},
"termsUrl": {
"type": "string",
"format": "uri"
},
"offer": {
"type": "object",
"properties": {
"currency": {
"type": "string",
"const": "EUR"
},
"grossTotalCents": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"expiresAt": {
"type": "string"
},
"customerConfirmationRequired": {
"type": "boolean",
"const": true
},
"completeTermsBound": {
"type": "boolean",
"const": true
}
},
"required": [
"currency",
"grossTotalCents",
"expiresAt",
"customerConfirmationRequired",
"completeTermsBound"
],
"additionalProperties": false
},
"nextAction": {
"type": "string"
}
},
"required": [
"status",
"bookingConfirmed",
"checkoutUrl",
"termsUrl",
"offer",
"nextAction"
],
"additionalProperties": false
}
]
}Community
Evidence
Recent observations
verifiedversion not recorded5 tools