Samuelz Chauffeur Booking

Review cancellation of this booking

prepare_booking_cancellation

Read-onlyIdempotent

Return a private cancellation-review link for the OAuth-selected existing booking. Choose this to cancel that booking, prepare_booking_change for an amendment, or prepare_offer for a new ride; get_booking_status only reads stored state.

bookingKey must identify the selected booking and cannot switch OAuth selection. Generate onceKey once for this booking/cancellation intent, retain it for unchanged retries, and never substitute an amendment's key. The key travels with the booking/action in the URL for later consent; retrieving the link does not persist or execute cancellation.

consent_required returns consentUrl. Open it in the original signed-in session; the customer reviews amount/terms and separately consents/confirms there. Then read get_booking_status and get_booking_history; recorded events are not fresh refund proof. Correct invalid_request; not_found denies access; unavailable leaves review unverified. Authority is checked before/after. No cancellation, refund, payment or message occurs in this call.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`onceKey`	Yes	Caller-chosen retry key: 16–128 characters from A–Z, a–z, 0–9, underscore or hyphen. Reuse it for the same booking, action and unchanged request facts; use a fresh key for changed facts. The caller creates it; this handoff assigns it no independent expiry or execution authority. Later review still requires a current original session, object, offer and separate action consent.
`bookingKey`	Yes	Internal booking ID or visible bookingReference of the one booking already selected by this OAuth connection. Copy the same booking's bookingKey or bookingReference from an available get_offer_status/prepare_offer or authorized booking-read result; prepared returns links, not IDs. Never substitute the supplier offerKey. It grants no access to another booking.

Output Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedOct 7, 2026

changedInput schema / properties / bookingKey / description

Previous value: -"Internal booking ID or visible bookingReference of the one booking already selected by this OAuth connection. Copy a returned ID or reference for that same booking; it grants no access to another booking."New value: +"Internal booking ID or visible bookingReference of the one booking already selected by this OAuth connection. Copy the same booking's bookingKey or bookingReference from an available get_offer_status/prepare_offer or authorized booking-read result; prepared returns links, not IDs. Never substitute the supplier offerKey. It grants no access to another booking."

changedInput schema / properties / onceKey / description

Previous value: -"Caller-chosen retry key: 16–128 characters from A–Z, a–z, 0–9, underscore or hyphen. Reuse it for the same booking, action and unchanged request facts; use a fresh key for changed facts. It grants no execution authority."New value: +"Caller-chosen retry key: 16–128 characters from A–Z, a–z, 0–9, underscore or hyphen. Reuse it for the same booking, action and unchanged request facts; use a fresh key for changed facts. The caller creates it; this handoff assigns it no independent expiry or execution authority. Later review still requires a current original session, object, offer and separate action consent."

changedOutput schema / oneOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "consentUrl": {
-        "pattern": "^https:\\/\\/platform-api\\.samuelz\\.com\\/app\\/customer-booking\\/manage#request=",
-        "type": "string"
-      },
-      "status": {
-        "const": "consent_required",
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "consentUrl"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "status": {
-        "enum": [
-          "invalid_request",
-          "not_found",
-          "unavailable"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "status"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "consentUrl": {
+        "description": "Open this exact private proposal link in the original signed-in session. Its fragment contains the selected object, action, onceKey and proposed facts. Current authority is rechecked, then the existing flow requires separate visible action consent and confirmation; the link itself grants no authority.",
+        "pattern": "^https:\\/\\/platform-api\\.samuelz\\.com\\/app\\/customer-booking\\/manage#request=",
+        "type": "string"
+      },
+      "status": {
+        "const": "consent_required",
+        "description": "A private proposal link is ready for review; no action consent or execution grant has been issued.",
+        "type": "string"
+      }
+    },
+    "required": [
+      "status",
+      "consentUrl"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "status": {
+        "description": "invalid_request rejects malformed selection/action facts; not_found denies access to the currently selected booking; unavailable means the handoff could not be supplied safely. No booking action has occurred.",
+        "enum": [
+          "invalid_request",
+          "not_found",
+          "unavailable"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "status"
+    ],
+    "type": "object"
+  }
+]

Changed2 schema fields changedOct 7, 2026

addedInput schema / properties / bookingKey / description

Added value: +"Internal booking ID or visible bookingReference of the one booking already selected by this OAuth connection. Copy a returned ID or reference for that same booking; it grants no access to another booking."

addedInput schema / properties / onceKey / description

Added value: +"Caller-chosen retry key: 16–128 characters from A–Z, a–z, 0–9, underscore or hyphen. Reuse it for the same booking, action and unchanged request facts; use a fresh key for changed facts. It grants no execution authority."

AddedOct 7, 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?