Skip to main content
Glama

Samuelz Chauffeur Booking

This connector has been deprecated

Duplicate of the verified Samuelz Chauffeur Booking connector: https://glama.ai/mcp/connectors/com.samuelz.platform-api/samuelz-chauffeur-booking

Published service options

get_service_options
Read-onlyIdempotent

Use this when discovering Samuelz Chauffeur services, areas and time zones. Do not use for terms (use get_customer_policy instead). Keep offerKey and locale across policy/price calls so location and language agree; omit the key for discovery. Returns available or unavailable. Anonymous stored read; no price, availability confirmation or writes.

Input Schema

NameRequiredDescriptionDefault
localeNoCustomer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility.en
offerKeyNoOptional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / locale / description
      Previous value: -"Language for text and links: en, or de."New value: +"Customer-requested language for text and links: en (default) or de. Preserve it on retries and related calls; it changes presentation, never price or eligibility."
    • changedInput schema / properties / offerKey / description
      Previous value: -"Published supplier offer key, not a booking id."New value: +"Optional published supplier offer key, for example service_airport. Pass only a key supplied by the provider’s published context; otherwise omit to use the configured default. Preserve it across related calls and retries. It selects a service location and terms, not a booking ID or access grant."
  2. Changed3 schema fields changed
    • changedInput schema / properties / locale / description
      Previous 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."New value: +"Language for text and links: en, or de."
    • changedInput schema / properties / offerKey / description
      Previous 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."New value: +"Published supplier offer key, not a booking id."
    • 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": {
      -      "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"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "status": {
      +        "const": "invalid_request",
      +        "description": "Input does not match this operation.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "bookingUrl": {
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "status": {
      +        "const": "unavailable",
      +        "description": "This read could not be completed safely.",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "bookingUrl": {
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "hourlyRideFacts": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "languages": {
      +        "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"
      +      },
      +      "serviceAreas": {
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "areas": {
      +              "items": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "id": {
      +                    "type": "string"
      +                  },
      +                  "label": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "id",
      +                  "label"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "countryCode": {
      +              "type": "string"
      +            },
      +            "key": {
      +              "type": "string"
      +            },
      +            "label": {
      +              "type": "string"
      +            },
      +            "timeZone": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "key",
      +            "countryCode",
      +            "timeZone",
      +            "label",
      +            "areas"
      +          ],
      +          "type": "object"
      +        },
      +        "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",
      +        "description": "Published services are readable.",
      +        "type": "string"
      +      },
      +      "timeZone": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "status",
      +      "provider",
      +      "timeZone",
      +      "bookingUrl",
      +      "services",
      +      "languages",
      +      "requiredRideFacts",
      +      "returnRideFacts",
      +      "hourlyRideFacts",
      +      "nextAction"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed2 schema fields changed
    • 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"
      +  }
      +]
  4. Changed2 schema fields changed
    • 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"
      +  }
      +]
  5. Changed1 schema field changed
    • 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."
  6. Changed2 schema fields changed
    • 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."
  7. Changed2 schema fields changed
    • 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"
      +  }
      +]
  8. First observed

TDQS

A4.4/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnly, idempotent, non-destructive and closed-world, so the safety profile is covered. The description adds context the annotations cannot: this is an anonymous (no auth) stored read of published data, it returns an available/unavailable state, and it does not confirm availability or return price — useful for knowing the data is a snapshot rather than a live check.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Four short clauses, each doing distinct work: when to use, when not to use and the alternative, cross-call parameter persistence, and the return/negative-scope statement. Front-loaded with the usage condition and zero filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Output schema covers the return shape and annotations cover safety, so the description only needs routing, parameter persistence and scope limits — all of which it provides, including the explicit note that neither price nor availability confirmation is returned.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3; the description goes beyond it by stating to persist offerKey and locale across related calls and to omit offerKey for discovery, which is cross-parameter usage guidance the schema does not spell out. It does not add much about locale switching beyond what the schema already says.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a concrete verb (discovering) and concrete resources (services, areas, time zones) for a named provider, and explicitly excludes terms retrieval. An agent can tell it apart from get_customer_policy without opening either schema, though the phrasing is slightly list-like rather than a single crisp statement of purpose.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives an explicit when-to-use clause ('when discovering Samuelz Chauffeur services, areas and time zones'), an explicit when-not clause naming the correct alternative ('Do not use for terms (use get_customer_policy instead)'), plus a cross-call rule to carry offerKey/locale into policy/price calls and omit the key for pure discovery.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources