Samuelz Chauffeur Booking
Public chauffeur prices, policy and consent-led offers for travel bookers and AI assistants.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"chauffeur-booking": {
"url": "https://platform-api.samuelz.com/api/v1/mcp/chauffeur/samuelz-chauffeur"
}
}
}원격 엔드포인트
https://platform-api.samuelz.com/api/v1/mcp/chauffeur/samuelz-chauffeurstreamable-http할 수 있는 일
도구 목록
도구 (5)
🟢get_service_options(locale)
Read this provider's public service, required ride facts and booking link.
입력 스키마
{
"type": "object",
"properties": {
"locale": {
"default": "de",
"type": "string",
"enum": [
"de",
"en"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"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.
입력 스키마
{
"type": "object",
"properties": {
"locale": {
"default": "de",
"type": "string",
"enum": [
"de",
"en"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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.
입력 스키마
{
"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
}출력 스키마
{
"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
}
]
}커뮤니티
증거