Samuelz Chauffeur Booking

Chauffeur service options

get_service_options

Read-onlyIdempotent

Read supported ride services, required facts and the selected service location's timeZone. Call before collecting a new ride; follow with get_customer_policy for eligibility, quote_ride for price, then prepare_offer only for an explicitly requested offer.

Omitting offerKey selects the published default. Otherwise retain the same known published key across policy, pricing and preparation; a key must still match the current publication/catalog. locale selects translated labels and links independently: changing de to en keeps the location, whereas changing offerKey requires rereading timeZone before interpreting a clock time.

available reports capabilities and collection requirements, not vehicle inventory or held capacity. This uncached read consumes no quote admission; reread before quoting. Correct invalid_request facts; unavailable leaves service scope unverified.

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.

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": {
-      "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"
-  }
-]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": {
+      "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"
+      },
+      "hourlyRideFacts": {
+        "description": "Additional hourly-service fields and required service/trip-type values.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "location": {
+        "additionalProperties": false,
+        "description": "Location configured for the supplied published offerKey; omitted for the default service scope.",
+        "properties": {
+          "countryCode": {
+            "description": "Country code configured for this service location.",
+            "type": "string"
+          },
+          "key": {
+            "description": "Configured service-location key selected by the published supplier offerKey.",
+            "type": "string"
+          },
+          "label": {
+            "description": "Location label in the requested language.",
+            "type": "string"
+          }
+        },
+        "required": [
+          "key",
+          "countryCode",
+          "label"
+        ],
+        "type": "object"
+      },
+      "nextAction": {
+        "description": "Guidance to collect complete ride facts and request a price preview; no contact details are required for quoting.",
+        "type": "string"
+      },
+      "provider": {
+        "description": "Published display name of the service provider.",
+        "type": "string"
+      },
+      "requiredRideFacts": {
+        "description": "Ride fields to collect before quoting a transfer.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "returnRideFacts": {
+        "description": "Additional return-trip fields to collect for an outbound and later return pickup.",
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "services": {
+        "description": "Published service definitions and supported trip types.",
+        "items": {
+          "additionalProperties": false,
+          "properties": {
+            "availability": {
+              "const": "requires_offer_review",
+              "description": "Availability/acceptance still require review of an actual offer.",
+              "type": "string"
+            },
+            "key": {
+              "description": "Published service identifier, such as transfer or hourly service.",
+              "type": "string"
+            },
+            "tripTypes": {
+              "description": "Trip types supported by this service definition; not confirmed availability.",
+              "items": {
+                "enum": [
+                  "one_way",
+                  "return"
+                ],
+                "type": "string"
+              },
+              "type": "array"
+            }
+          },
+          "required": [
+            "key",
+            "tripTypes",
+            "availability"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "status": {
+        "const": "available",
+        "description": "Published service information is readable; no price, acceptance or availability is confirmed.",
+        "type": "string"
+      },
+      "timeZone": {
+        "description": "Configured local provider time zone for ride dates and pickup times.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "provider",
+      "timeZone",
+      "bookingUrl",
+      "services",
+      "requiredRideFacts",
+      "returnRideFacts",
+      "hourlyRideFacts",
+      "nextAction"
+    ],
+    "type": "object"
+  }
+]

Changed2 schema fields 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"
+}

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": {
-      "bookingUrl": {
-        "format": "uri",
-        "type": "string"
-      },
-      "hourlyRideFacts": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "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"
-  }
-]New 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": {
+      "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"
+  }
+]

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."

Changed2 schema fields changedOct 2, 2026

addedInput schema / properties / locale / description

Added value: +"Response language: de (German, default) or en (English)."

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": {
-      "bookingUrl": {
-        "format": "uri",
-        "type": "string"
-      },
-      "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",
-      "nextAction"
-    ],
-    "type": "object"
-  }
-]New 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": {
+      "bookingUrl": {
+        "format": "uri",
+        "type": "string"
+      },
+      "hourlyRideFacts": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "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"
+  }
+]

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?