Skip to main content
Glama

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": {
      +        "description": "Booking page for this locale.",
      +        "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": {
      +        "description": "Booking page for this locale.",
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "hourlyRideFacts": {
      +        "description": "Extra fields for hourly service.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "languages": {
      +        "description": "Languages in the current settings.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "location": {
      +        "additionalProperties": false,
      +        "description": "Location for the supplied offer key.",
      +        "properties": {
      +          "countryCode": {
      +            "description": "Country code for this location.",
      +            "type": "string"
      +          },
      +          "key": {
      +            "description": "Service-location key for this offer.",
      +            "type": "string"
      +          },
      +          "label": {
      +            "description": "Location label for this locale.",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "key",
      +          "countryCode",
      +          "label"
      +        ],
      +        "type": "object"
      +      },
      +      "nextAction": {
      +        "description": "Collect the ride facts, then request a price.",
      +        "type": "string"
      +      },
      +      "provider": {
      +        "description": "Published provider name.",
      +        "type": "string"
      +      },
      +      "requiredRideFacts": {
      +        "description": "Fields required before a transfer quote.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "returnRideFacts": {
      +        "description": "Extra fields for a return trip.",
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "serviceAreas": {
      +        "description": "Published areas. Outside requests have no price.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "areas": {
      +              "description": "Areas that can be quoted.",
      +              "items": {
      +                "additionalProperties": false,
      +                "properties": {
      +                  "id": {
      +                    "description": "Published area id.",
      +                    "type": "string"
      +                  },
      +                  "label": {
      +                    "description": "Area label for the locale.",
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "id",
      +                  "label"
      +                ],
      +                "type": "object"
      +              },
      +              "type": "array"
      +            },
      +            "countryCode": {
      +              "description": "Country code, when set.",
      +              "type": "string"
      +            },
      +            "key": {
      +              "description": "Service-location key.",
      +              "type": "string"
      +            },
      +            "label": {
      +              "description": "Location label for the locale.",
      +              "type": "string"
      +            },
      +            "timeZone": {
      +              "description": "Time zone of this location.",
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "key",
      +            "countryCode",
      +            "timeZone",
      +            "label",
      +            "areas"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "services": {
      +        "description": "Published service definitions.",
      +        "items": {
      +          "additionalProperties": false,
      +          "properties": {
      +            "availability": {
      +              "const": "requires_offer_review",
      +              "description": "An offer still needs review.",
      +              "type": "string"
      +            },
      +            "key": {
      +              "description": "Published service key.",
      +              "type": "string"
      +            },
      +            "tripTypes": {
      +              "description": "Trip types this service defines.",
      +              "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": {
      +        "description": "Local time zone for ride dates.",
      +        "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.8/5.0
Behavior5/5

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

Annotations already declare readOnly/idempotent/non-destructive, and the description adds context annotations cannot: it is an anonymous (no-auth) stored read, and it explicitly does not return pricing, does not confirm availability, and performs no writes. That bound on what the result can be trusted for is exactly the behavioral signal an agent needs before chaining a quote.

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

Conciseness4/5

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

Front-loaded with the use-when clause and no filler; the trailing telegraphic fragments ("Anonymous stored read; no price, availability confirmation or writes") are dense and take a second read, but every clause carries information.

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?

An output schema exists, so return values need not be narrated; the description still flags the key caveat (available vs unavailable, no price/confirmation). With only two optional, fully documented params and covered annotations, nothing needed to call it correctly is missing.

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 further by framing offerKey and locale as carry-forward state across policy/price calls and by saying to omit offerKey for discovery. Some of this duplicates the offerKey schema text, so it is reinforcement rather than pure added meaning.

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

Purpose5/5

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

States a specific verb (discovering) and resource (services, areas, time zones) and immediately scopes out the one adjacent thing an agent might confuse it with (terms, routed to get_customer_policy). An agent can distinguish it from get_customer_policy and the prepare_* siblings without opening any schema.

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?

"Use this when…" plus an explicit negative ("Do not use for terms — use get_customer_policy instead") and cross-call guidance ("Keep offerKey and locale across policy/price calls… omit the key for discovery"). When-to-use, when-not-to-use, and an alternative are all enumerated.

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