Samuelz Chauffeur Booking

Published customer terms

get_customer_policy

Read-onlyIdempotent

Read current account/guest eligibility and pickup lead-time rules for a new offer. Call after get_service_options and before quote_ride or prepare_offer. This tool answers purchase eligibility, not price, capacity, or authority to amend/cancel an existing booking.

Selection and timing:

Retain the selected offerKey across the workflow; locale changes language without changing location. A different offerKey requires a fresh policy read.
Interpret intended pickup in returned timeZone; compare the interval from now with terms.minimumLeadTimeMinutes. A fictional 120-minute minimum excludes pickup 90 minutes away without implying vehicle unavailability.

available returns account requirements, guest-booking rules, lead-time terms, timeZone and observedAt. observedAt dates this policy read, not an expiry or capacity hold. Revalidate before preparation; unavailable leaves eligibility unverified. The customer reviews bound offer terms and confirms in checkout; confirmation requires provider-confirmed full payment. Reading policy creates no booking.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`locale`	No	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.	en
`offerKey`	No	Optional existing published provider/supplier offer key. Selects its configured service location; it is not a customer bookingKey or bookingReference and grants no booking access.

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 8, 2026

changedOutput schema / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "status": {
-        "const": "invalid_request",
-        "description": "Input does not match this operation's contract; correct the facts before retrying.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "status"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "bookingUrl": {
-        "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
-        "format": "uri",
-        "type": "string"
-      },
-      "status": {
-        "const": "unavailable",
-        "description": "The requested information could not be supplied safely; this is not vehicle-unavailability evidence.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "status"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "bookingConfirmed": {
-        "const": false,
-        "description": "Reading policy does not create or confirm a booking.",
-        "type": "boolean"
-      },
-      "bookingUrl": {
-        "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
-        "format": "uri",
-        "type": "string"
-      },
-      "observedAt": {
-        "description": "Observation timestamp of the minimum-lead-time policy read; no validity window is promised.",
-        "type": "string"
-      },
-      "revalidationRequired": {
-        "const": true,
-        "description": "Re-read and revalidate current policy before offer preparation/confirmation.",
-        "type": "boolean"
-      },
-      "scope": {
-        "const": "booking_preparation",
-        "description": "These rules cover preparation of a customer offer/booking, not action authority.",
-        "type": "string"
-      },
-      "status": {
-        "const": "available",
-        "description": "Current booking-preparation policy was read; no booking is confirmed.",
-        "type": "string"
-      },
-      "terms": {
-        "additionalProperties": false,
-        "description": "Current published account, guest-booking, lead-time and confirmation rules.",
-        "properties": {
-          "accountRequired": {
-            "description": "Whether current purchase policy requires an account.",
-            "type": "boolean"
-          },
-          "bookerForGuestAllowed": {
-            "description": "Whether current policy allows a booker to request service for another guest.",
-            "type": "boolean"
-          },
-          "bookingConfirmation": {
-            "const": "after_confirmed_full_payment",
-            "description": "Confirmation requires provider-confirmed full payment; an offer link alone is insufficient.",
-            "type": "string"
-          },
-          "minimumLeadTimeMinutes": {
-            "description": "Current minimum time before pickup, expressed in minutes.",
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "serviceSpecificTerms": {
-            "const": "review_the_current_offer_before_confirmation",
-            "description": "Review the complete terms bound to the current offer before confirming.",
-            "type": "string"
-          }
-        },
-        "required": [
-          "minimumLeadTimeMinutes",
-          "accountRequired",
-          "bookerForGuestAllowed",
-          "bookingConfirmation",
-          "serviceSpecificTerms"
-        ],
-        "type": "object"
-      },
-      "timeZone": {
-        "description": "Configured local time zone for the selected provider/service location.",
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "bookingUrl",
-      "timeZone",
-      "observedAt",
-      "scope",
-      "revalidationRequired",
-      "terms",
-      "bookingConfirmed"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "status": {
+        "const": "invalid_request",
+        "description": "Input does not match this operation's contract; correct the facts before retrying.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "status"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "bookingUrl": {
+        "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+        "format": "uri",
+        "type": "string"
+      },
+      "status": {
+        "const": "unavailable",
+        "description": "The requested information could not be supplied safely; this is not vehicle-unavailability evidence.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "status"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "bookingConfirmed": {
+        "const": false,
+        "description": "Reading policy does not create or confirm a booking.",
+        "type": "boolean"
+      },
+      "bookingUrl": {
+        "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+        "format": "uri",
+        "type": "string"
+      },
+      "observedAt": {
+        "description": "ISO 8601 UTC timestamp when the current minimum-lead-time policy was read, not its expiry or a guarantee of future validity.",
+        "type": "string"
+      },
+      "revalidationRequired": {
+        "const": true,
+        "description": "Re-read and revalidate current policy before offer preparation/confirmation.",
+        "type": "boolean"
+      },
+      "scope": {
+        "const": "booking_preparation",
+        "description": "These rules cover preparation of a customer offer/booking, not action authority.",
+        "type": "string"
+      },
+      "status": {
+        "const": "available",
+        "description": "Current booking-preparation policy was read; no booking is confirmed.",
+        "type": "string"
+      },
+      "terms": {
+        "additionalProperties": false,
+        "description": "Current published account, guest-booking, lead-time and confirmation rules.",
+        "properties": {
+          "accountRequired": {
+            "description": "Whether current purchase policy requires an account.",
+            "type": "boolean"
+          },
+          "bookerForGuestAllowed": {
+            "description": "Whether current policy allows a booker to request service for another guest.",
+            "type": "boolean"
+          },
+          "bookingConfirmation": {
+            "const": "after_confirmed_full_payment",
+            "description": "Confirmation requires provider-confirmed full payment; an offer link alone is insufficient.",
+            "type": "string"
+          },
+          "minimumLeadTimeMinutes": {
+            "description": "Current minimum time before pickup, expressed in minutes.",
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "serviceSpecificTerms": {
+            "const": "review_the_current_offer_before_confirmation",
+            "description": "Review the complete terms bound to the current offer before confirming.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "minimumLeadTimeMinutes",
+          "accountRequired",
+          "bookerForGuestAllowed",
+          "bookingConfirmation",
+          "serviceSpecificTerms"
+        ],
+        "type": "object"
+      },
+      "timeZone": {
+        "description": "Configured local time zone for the selected provider/service location.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "bookingUrl",
+      "timeZone",
+      "observedAt",
+      "scope",
+      "revalidationRequired",
+      "terms",
+      "bookingConfirmed"
+    ],
+    "type": "object"
+  }
+]

Changed2 schema fields changedOct 7, 2026

changedInput schema / properties / offerKey / description

Previous value: -"Optional existing published provider offer key. Selects its configured service location; not booking authority."New value: +"Optional existing published provider/supplier offer key. Selects its configured service location; it is not a customer bookingKey or bookingReference and grants no booking access."

changedOutput schema / oneOf

Previous value: -[
-  {
-    "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"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "status": {
+        "const": "invalid_request",
+        "description": "Input does not match this operation's contract; correct the facts before retrying.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "status"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "bookingUrl": {
+        "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+        "format": "uri",
+        "type": "string"
+      },
+      "status": {
+        "const": "unavailable",
+        "description": "The requested information could not be supplied safely; this is not vehicle-unavailability evidence.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "status"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "bookingConfirmed": {
+        "const": false,
+        "description": "Reading policy does not create or confirm a booking.",
+        "type": "boolean"
+      },
+      "bookingUrl": {
+        "description": "Published customer booking page for this provider and locale; the URL does not grant private booking access or confirm availability.",
+        "format": "uri",
+        "type": "string"
+      },
+      "observedAt": {
+        "description": "Observation timestamp of the minimum-lead-time policy read; no validity window is promised.",
+        "type": "string"
+      },
+      "revalidationRequired": {
+        "const": true,
+        "description": "Re-read and revalidate current policy before offer preparation/confirmation.",
+        "type": "boolean"
+      },
+      "scope": {
+        "const": "booking_preparation",
+        "description": "These rules cover preparation of a customer offer/booking, not action authority.",
+        "type": "string"
+      },
+      "status": {
+        "const": "available",
+        "description": "Current booking-preparation policy was read; no booking is confirmed.",
+        "type": "string"
+      },
+      "terms": {
+        "additionalProperties": false,
+        "description": "Current published account, guest-booking, lead-time and confirmation rules.",
+        "properties": {
+          "accountRequired": {
+            "description": "Whether current purchase policy requires an account.",
+            "type": "boolean"
+          },
+          "bookerForGuestAllowed": {
+            "description": "Whether current policy allows a booker to request service for another guest.",
+            "type": "boolean"
+          },
+          "bookingConfirmation": {
+            "const": "after_confirmed_full_payment",
+            "description": "Confirmation requires provider-confirmed full payment; an offer link alone is insufficient.",
+            "type": "string"
+          },
+          "minimumLeadTimeMinutes": {
+            "description": "Current minimum time before pickup, expressed in minutes.",
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "serviceSpecificTerms": {
+            "const": "review_the_current_offer_before_confirmation",
+            "description": "Review the complete terms bound to the current offer before confirming.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "minimumLeadTimeMinutes",
+          "accountRequired",
+          "bookerForGuestAllowed",
+          "bookingConfirmation",
+          "serviceSpecificTerms"
+        ],
+        "type": "object"
+      },
+      "timeZone": {
+        "description": "Configured local time zone for the selected provider/service location.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "bookingUrl",
+      "timeZone",
+      "observedAt",
+      "scope",
+      "revalidationRequired",
+      "terms",
+      "bookingConfirmed"
+    ],
+    "type": "object"
+  }
+]

Changed1 schema field changedOct 3, 2026

addedInput schema / properties / offerKey

Added value: +{
+  "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"
+}

Changed1 schema field changedOct 3, 2026

changedInput schema / properties / locale / description

Previous value: -"Response language: en (English, default) or de (German). Does not change the provider time zone."New value: +"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."

Changed2 schema fields changedOct 3, 2026

changedInput schema / properties / locale / default
```
Previous value: -"de"New value: +"en"
```

changedInput schema / properties / locale / description

Previous value: -"Response language: de (German, default) or en (English)."New value: +"Response language: en (English, default) or de (German). Does not change the provider time zone."

Changed1 schema field changedOct 2, 2026
- addedInput schema / properties / locale / description
```
Added value: +"Response language: de (German, default) or en (English)."
```
First observedSep 22, 2026

TDQS

Score is being calculated.

All Samuelz Chauffeur Booking tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?