Samuelz Chauffeur Booking
Public chauffeur prices, policy and consent-led offers for travel bookers and AI assistants.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"chauffeur-booking": {
"url": "https://platform-api.samuelz.com/api/v1/mcp/chauffeur/samuelz-chauffeur"
}
}
}Puntos de conexión remotos
https://platform-api.samuelz.com/api/v1/mcp/chauffeur/samuelz-chauffeurstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (5)
🟢get_service_options(locale)
Read this provider's public service, required ride facts and booking link.
Esquema de entrada
{
"type": "object",
"properties": {
"locale": {
"default": "de",
"type": "string",
"enum": [
"de",
"en"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"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.
Esquema de entrada
{
"type": "object",
"properties": {
"locale": {
"default": "de",
"type": "string",
"enum": [
"de",
"en"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"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.
Esquema de entrada
{
"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$"
},
"flightNumber": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"luggage": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"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
}Esquema de salida
{
"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, firstTouchTrackingToken, distributionPartnerCapability, ...)
Prepare exactly one unpaid reservation and binding offer for an authorized transfer, return 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.
Esquema de entrada
{
"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}$"
},
"firstTouchTrackingToken": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
},
"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}$"
}
},
"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$"
},
"flightNumber": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"luggage": {
"type": "string",
"minLength": 1,
"maxLength": 240
},
"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": [
"submissionId",
"resumeToken",
"contact",
"ride"
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}Esquema de salida
{
"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.
Esquema de entrada
{
"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
}Esquema de salida
{
"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
}
]
}Comunidad
Evidencia