Skip to main content
Glama

Trip brief

get_trip_brief
Read-onlyIdempotent

Whole-trip brief for 1-5 destinations: per destination, in order, entry (as check_entry_requirements, if passport given), power verdict from home_country, currency, emergency numbers, driving side, tipping and holidays between from and to. Use it to summarise a trip; for one fact use check_entry_requirements, check_power_compatibility, get_emergency_numbers, get_tipping_norms or get_public_holidays, and get_country_facts for one country without dates. No passport: entry null, no advisory. If one destination's entry can't be answered (outside pilot, no data, same country) it is {unavailable: reason} and the rest still returns. power is null at home or without plug data; a category without data is {}. An unknown home or destination code, over 5 destinations or a bad date range fails the call. Each fact is cited: sources[] (url, license), last_verified, confidence. Show the advisory. Parameters: passport = nationality (optional); home_country = where traveller and devices come from; destinations in travel order, home only if it is a stop; from/to = whole trip, inclusive. Example: {"passport":"US","home_country":"US","destinations":["JP","KR"],"from":"2026-12-28","to":"2027-01-05"}. Read-only; free API key or x402, charged per call, not per destination (https://citedtravel.com/pricing/); errors RFC 9457.

Input Schema

NameRequiredDescriptionDefault
toYesTrip end (inclusive), on or after from and at most two years later. Calendar date, YYYY-MM-DD.
fromYesTrip start (inclusive). Calendar date, YYYY-MM-DD.
langNoLanguage for localized names (BCP 47). Supported: en, ja, zh-Hans, zh-Hant; aliases such as zh, zh-CN, zh-TW and zh-HK are mapped, and anything else falls back to English. Only names are localized; verbatim official quotes stay in their original language.en
passportNoPassport (nationality) country as an ISO 3166-1 alpha-2 or alpha-3 code. Optional: omit to skip entry requirements.
destinationsYesDestination countries, in travel order.
home_countryYesCountry the traveller starts from; used for the adapter/converter verdict as an ISO 3166-1 alpha-2 or alpha-3 code, case-insensitive (e.g. JP, jp or JPN). Names are not accepted: resolve them with resolve_country first.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed21 schema fields changed
    • addedInput schema / properties / destinations / description
      Added value: +"Destination countries, in travel order."
    • addedInput schema / properties / destinations / examples
      Added value: +[
      +  [
      +    "JP",
      +    "KR"
      +  ]
      +]
    • changedInput schema / properties / destinations / items / description
      Previous value: -"Country as ISO 3166-1 alpha-2 or alpha-3 code, e.g. JP or JPN. Use resolve_country for names."New value: +"Destination country as an ISO 3166-1 alpha-2 or alpha-3 code, case-insensitive (e.g. JP, jp or JPN). Names are not accepted: resolve them with resolve_country first."
    • addedInput schema / properties / destinations / items / examples
      Added value: +[
      +  "JP",
      +  "GB",
      +  "USA"
      +]
    • addedInput schema / properties / destinations / items / pattern
      Added value: +"^[A-Za-z]{2,3}$"
    • changedInput schema / properties / from / description
      Previous value: -"Trip start"New value: +"Trip start (inclusive). Calendar date, YYYY-MM-DD."
    • addedInput schema / properties / from / examples
      Added value: +[
      +  "2026-12-28"
      +]
    • addedInput schema / properties / from / format
      Added value: +"date"
    • changedInput schema / properties / home_country / description
      Previous value: -"Country as ISO 3166-1 alpha-2 or alpha-3 code, e.g. JP or JPN. Use resolve_country for names."New value: +"Country the traveller starts from; used for the adapter/converter verdict as an ISO 3166-1 alpha-2 or alpha-3 code, case-insensitive (e.g. JP, jp or JPN). Names are not accepted: resolve them with resolve_country first."
    • addedInput schema / properties / home_country / examples
      Added value: +[
      +  "JP",
      +  "GB",
      +  "USA"
      +]
    • addedInput schema / properties / home_country / pattern
      Added value: +"^[A-Za-z]{2,3}$"
    • addedInput schema / properties / lang / default
      Added value: +"en"
    • changedInput schema / properties / lang / description
      Previous value: -"Response language (BCP 47). Supported: en, ja, zh-Hans, zh-Hant; falls back to English. Verbatim official quotes always stay in their original language."New value: +"Language for localized names (BCP 47). Supported: en, ja, zh-Hans, zh-Hant; aliases such as zh, zh-CN, zh-TW and zh-HK are mapped, and anything else falls back to English. Only names are localized; verbatim official quotes stay in their original language."
    • addedInput schema / properties / lang / examples
      Added value: +[
      +  "en",
      +  "ja",
      +  "zh-Hans",
      +  "zh-Hant"
      +]
    • changedInput schema / properties / passport / description
      Previous value: -"Country as ISO 3166-1 alpha-2 or alpha-3 code, e.g. JP or JPN. Use resolve_country for names."New value: +"Passport (nationality) country as an ISO 3166-1 alpha-2 or alpha-3 code. Optional: omit to skip entry requirements."
    • addedInput schema / properties / passport / examples
      Added value: +[
      +  "JP",
      +  "GB",
      +  "USA"
      +]
    • addedInput schema / properties / passport / pattern
      Added value: +"^[A-Za-z]{2,3}$"
    • changedInput schema / properties / to / description
      Previous value: -"Trip end"New value: +"Trip end (inclusive), on or after from and at most two years later. Calendar date, YYYY-MM-DD."
    • addedInput schema / properties / to / examples
      Added value: +[
      +  "2027-01-05"
      +]
    • addedInput schema / properties / to / format
      Added value: +"date"
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "anyOf": [
      +    {
      +      "properties": {
      +        "advisory": {
      +          "description": "Present when a passport is given: show it to the user.",
      +          "type": "string"
      +        },
      +        "dataset_version": {
      +          "description": "Version of the dataset that answered.",
      +          "type": "string"
      +        },
      +        "destinations": {
      +          "description": "One section per destination, in request order.",
      +          "items": {
      +            "properties": {
      +              "currency": {
      +                "additionalProperties": {
      +                  "description": "One cited fact.",
      +                  "properties": {
      +                    "attribution": {
      +                      "description": "Attribution strings required by the source licenses.",
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "confidence": {
      +                      "description": "Deterministic confidence: score from 0 to 1, a level, and the reasons (source kind, cross-checks, staleness...).",
      +                      "properties": {
      +                        "level": {
      +                          "examples": [
      +                            "high",
      +                            "medium",
      +                            "low"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        "reasons": {
      +                          "description": "Why the score is what it is.",
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        "score": {
      +                          "maximum": 1,
      +                          "minimum": 0,
      +                          "type": "number"
      +                        }
      +                      },
      +                      "required": [
      +                        "score",
      +                        "level"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "cross_checks": {
      +                      "description": "Independent datasets the value was checked against, with the result.",
      +                      "type": "array"
      +                    },
      +                    "field": {
      +                      "type": "string"
      +                    },
      +                    "id": {
      +                      "type": "string"
      +                    },
      +                    "last_verified": {
      +                      "description": "Date the value was last verified (YYYY-MM-DD).",
      +                      "type": "string"
      +                    },
      +                    "localization": {
      +                      "type": "object"
      +                    },
      +                    "next_review_due": {
      +                      "description": "Date of the next scheduled review (YYYY-MM-DD).",
      +                      "type": "string"
      +                    },
      +                    "sources": {
      +                      "description": "Cited sources for this fact.",
      +                      "items": {
      +                        "description": "One cited source.",
      +                        "properties": {
      +                          "license": {
      +                            "description": "License of the source, e.g. CC0-1.0, OGL-UK-3.0, MIT.",
      +                            "type": "string"
      +                          },
      +                          "publisher": {
      +                            "type": "string"
      +                          },
      +                          "quote": {
      +                            "description": "Verbatim text from the source, when quoted.",
      +                            "type": "string"
      +                          },
      +                          "retrieved_at": {
      +                            "description": "When the source was fetched (ISO 8601).",
      +                            "type": "string"
      +                          },
      +                          "source_id": {
      +                            "type": "string"
      +                          },
      +                          "source_value": {
      +                            "description": "The raw value as given by the source, when not quoted."
      +                          },
      +                          "url": {
      +                            "type": "string"
      +                          }
      +                        },
      +                        "required": [
      +                          "publisher",
      +                          "url",
      +                          "license"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "unit": {
      +                      "type": "string"
      +                    },
      +                    "value": {
      +                      "description": "The fact value; its shape depends on the field."
      +                    }
      +                  },
      +                  "required": [
      +                    "value",
      +                    "sources",
      +                    "last_verified",
      +                    "confidence"
      +                  ],
      +                  "type": "object"
      +                },
      +                "description": "Currency facts. Keys are field names, each value is a cited fact.",
      +                "properties": {
      +                  "currencies": {
      +                    "description": "Currencies in use: ISO 4217 code, name and symbols.",
      +                    "properties": {
      +                      "attribution": {
      +                        "description": "Attribution strings required by the source licenses.",
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "confidence": {
      +                        "description": "Deterministic confidence: score from 0 to 1, a level, and the reasons (source kind, cross-checks, staleness...).",
      +                        "properties": {
      +                          "level": {
      +                            "examples": [
      +                              "high",
      +                              "medium",
      +                              "low"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "reasons": {
      +                            "description": "Why the score is what it is.",
      +                            "items": {
      +                              "type": "string"
      +                            },
      +                            "type": "array"
      +                          },
      +                          "score": {
      +                            "maximum": 1,
      +                            "minimum": 0,
      +                            "type": "number"
      +                          }
      +                        },
      +                        "required": [
      +                          "score",
      +                          "level"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "cross_checks": {
      +                        "description": "Independent datasets the value was checked against, with the result.",
      +                        "type": "array"
      +                      },
      +                      "field": {
      +                        "type": "string"
      +                      },
      +                      "id": {
      +                        "type": "string"
      +                      },
      +                      "last_verified": {
      +                        "description": "Date the value was last verified (YYYY-MM-DD).",
      +                        "type": "string"
      +                      },
      +                      "localization": {
      +                        "type": "object"
      +                      },
      +                      "next_review_due": {
      +                        "description": "Date of the next scheduled review (YYYY-MM-DD).",
      +                        "type": "string"
      +                      },
      +                      "sources": {
      +                        "description": "Cited sources for this fact.",
      +                        "items": {
      +                          "description": "One cited source.",
      +                          "properties": {
      +                            "license": {
      +                              "description": "License of the source, e.g. CC0-1.0, OGL-UK-3.0, MIT.",
      +                              "type": "string"
      +                            },
      +                            "publisher": {
      +                              "type": "string"
      +                            },
      +                            "quote": {
      +                              "description": "Verbatim text from the source, when quoted.",
      +                              "type": "string"
      +                            },
      +                            "retrieved_at": {
      +                              "description": "When the source was fetched (ISO 8601).",
      +                              "type": "string"
      +                            },
      +                            "source_id": {
      +                              "type": "string"
      +                            },
      +                            "source_value": {
      +                              "description": "The raw value as given by the source, when not quoted."
      +                            },
      +                            "url": {
      +                              "type": "string"
      +                            }
      +                          },
      +                          "required": [
      +                            "publisher",
      +                            "url",
      +                            "license"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "unit": {
      +                        "type": "string"
      +                      },
      +                      "value": {
      +                        "description": "The fact value; its shape depends on the field."
      +                      }
      +                    },
      +                    "required": [
      +                      "value",
      +                      "sources",
      +                      "last_verified",
      +                      "confidence"
      +                    ],
      +                    "type": "object"
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "destination": {
      +                "description": "Country (ISO codes and name, localized to lang).",
      +                "properties": {
      +                  "iso2": {
      +                    "type": "string"
      +                  },
      +                  "iso3": {
      +                    "type": "string"
      +                  },
      +                  "name": {
      +                    "type": "string"
      +                  },
      +                  "name_lang": {
      +                    "type": "string"
      +                  }
      +                },
      +                "required": [
      +                  "iso2"
      +                ],
      +                "type": "object"
      +              },
      +              "driving": {
      +                "additionalProperties": {
      +                  "description": "One cited fact.",
      +                  "properties": {
      +                    "attribution": {
      +                      "description": "Attribution strings required by the source licenses.",
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "confidence": {
      +                      "description": "Deterministic confidence: score from 0 to 1, a level, and the reasons (source kind, cross-checks, staleness...).",
      +                      "properties": {
      +                        "level": {
      +                          "examples": [
      +                            "high",
      +                            "medium",
      +                            "low"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        "reasons": {
      +                          "description": "Why the score is what it is.",
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        "score": {
      +                          "maximum": 1,
      +                          "minimum": 0,
      +                          "type": "number"
      +                        }
      +                      },
      +                      "required": [
      +                        "score",
      +                        "level"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "cross_checks": {
      +                      "description": "Independent datasets the value was checked against, with the result.",
      +                      "type": "array"
      +                    },
      +                    "field": {
      +                      "type": "string"
      +                    },
      +                    "id": {
      +                      "type": "string"
      +                    },
      +                    "last_verified": {
      +                      "description": "Date the value was last verified (YYYY-MM-DD).",
      +                      "type": "string"
      +                    },
      +                    "localization": {
      +                      "type": "object"
      +                    },
      +                    "next_review_due": {
      +                      "description": "Date of the next scheduled review (YYYY-MM-DD).",
      +                      "type": "string"
      +                    },
      +                    "sources": {
      +                      "description": "Cited sources for this fact.",
      +                      "items": {
      +                        "description": "One cited source.",
      +                        "properties": {
      +                          "license": {
      +                            "description": "License of the source, e.g. CC0-1.0, OGL-UK-3.0, MIT.",
      +                            "type": "string"
      +                          },
      +                          "publisher": {
      +                            "type": "string"
      +                          },
      +                          "quote": {
      +                            "description": "Verbatim text from the source, when quoted.",
      +                            "type": "string"
      +                          },
      +                          "retrieved_at": {
      +                            "description": "When the source was fetched (ISO 8601).",
      +                            "type": "string"
      +                          },
      +                          "source_id": {
      +                            "type": "string"
      +                          },
      +                          "source_value": {
      +                            "description": "The raw value as given by the source, when not quoted."
      +                          },
      +                          "url": {
      +                            "type": "string"
      +                          }
      +                        },
      +                        "required": [
      +                          "publisher",
      +                          "url",
      +                          "license"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "unit": {
      +                      "type": "string"
      +                    },
      +                    "value": {
      +                      "description": "The fact value; its shape depends on the field."
      +                    }
      +                  },
      +                  "required": [
      +                    "value",
      +                    "sources",
      +                    "last_verified",
      +                    "confidence"
      +                  ],
      +                  "type": "object"
      +                },
      +                "description": "Driving facts. Keys are field names, each value is a cited fact.",
      +                "properties": {
      +                  "side": {
      +                    "description": "\"left\" or \"right\".",
      +                    "properties": {
      +                      "attribution": {
      +                        "description": "Attribution strings required by the source licenses.",
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "confidence": {
      +                        "description": "Deterministic confidence: score from 0 to 1, a level, and the reasons (source kind, cross-checks, staleness...).",
      +                        "properties": {
      +                          "level": {
      +                            "examples": [
      +                              "high",
      +                              "medium",
      +                              "low"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "reasons": {
      +                            "description": "Why the score is what it is.",
      +                            "items": {
      +                              "type": "string"
      +                            },
      +                            "type": "array"
      +                          },
      +                          "score": {
      +                            "maximum": 1,
      +                            "minimum": 0,
      +                            "type": "number"
      +                          }
      +                        },
      +                        "required": [
      +                          "score",
      +                          "level"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "cross_checks": {
      +                        "description": "Independent datasets the value was checked against, with the result.",
      +                        "type": "array"
      +                      },
      +                      "field": {
      +                        "type": "string"
      +                      },
      +                      "id": {
      +                        "type": "string"
      +                      },
      +                      "last_verified": {
      +                        "description": "Date the value was last verified (YYYY-MM-DD).",
      +                        "type": "string"
      +                      },
      +                      "localization": {
      +                        "type": "object"
      +                      },
      +                      "next_review_due": {
      +                        "description": "Date of the next scheduled review (YYYY-MM-DD).",
      +                        "type": "string"
      +                      },
      +                      "sources": {
      +                        "description": "Cited sources for this fact.",
      +                        "items": {
      +                          "description": "One cited source.",
      +                          "properties": {
      +                            "license": {
      +                              "description": "License of the source, e.g. CC0-1.0, OGL-UK-3.0, MIT.",
      +                              "type": "string"
      +                            },
      +                            "publisher": {
      +                              "type": "string"
      +                            },
      +                            "quote": {
      +                              "description": "Verbatim text from the source, when quoted.",
      +                              "type": "string"
      +                            },
      +                            "retrieved_at": {
      +                              "description": "When the source was fetched (ISO 8601).",
      +                              "type": "string"
      +                            },
      +                            "source_id": {
      +                              "type": "string"
      +                            },
      +                            "source_value": {
      +                              "description": "The raw value as given by the source, when not quoted."
      +                            },
      +                            "url": {
      +                              "type": "string"
      +                            }
      +                          },
      +                          "required": [
      +                            "publisher",
      +                            "url",
      +                            "license"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "unit": {
      +                        "type": "string"
      +                      },
      +                      "value": {
      +                        "description": "The fact value; its shape depends on the field."
      +                      }
      +                    },
      +                    "required": [
      +                      "value",
      +                      "sources",
      +                      "last_verified",
      +                      "confidence"
      +                    ],
      +                    "type": "object"
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "emergency": {
      +                "additionalProperties": {
      +                  "description": "One cited fact.",
      +                  "properties": {
      +                    "attribution": {
      +                      "description": "Attribution strings required by the source licenses.",
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "confidence": {
      +                      "description": "Deterministic confidence: score from 0 to 1, a level, and the reasons (source kind, cross-checks, staleness...).",
      +                      "properties": {
      +                        "level": {
      +                          "examples": [
      +                            "high",
      +                            "medium",
      +                            "low"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        "reasons": {
      +                          "description": "Why the score is what it is.",
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        "score": {
      +                          "maximum": 1,
      +                          "minimum": 0,
      +                          "type": "number"
      +                        }
      +                      },
      +                      "required": [
      +                        "score",
      +                        "level"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "cross_checks": {
      +                      "description": "Independent datasets the value was checked against, with the result.",
      +                      "type": "array"
      +                    },
      +                    "field": {
      +                      "type": "string"
      +                    },
      +                    "id": {
      +                      "type": "string"
      +                    },
      +                    "last_verified": {
      +                      "description": "Date the value was last verified (YYYY-MM-DD).",
      +                      "type": "string"
      +                    },
      +                    "localization": {
      +                      "type": "object"
      +                    },
      +                    "next_review_due": {
      +                      "description": "Date of the next scheduled review (YYYY-MM-DD).",
      +                      "type": "string"
      +                    },
      +                    "sources": {
      +                      "description": "Cited sources for this fact.",
      +                      "items": {
      +                        "description": "One cited source.",
      +                        "properties": {
      +                          "license": {
      +                            "description": "License of the source, e.g. CC0-1.0, OGL-UK-3.0, MIT.",
      +                            "type": "string"
      +                          },
      +                          "publisher": {
      +                            "type": "string"
      +                          },
      +                          "quote": {
      +                            "description": "Verbatim text from the source, when quoted.",
      +                            "type": "string"
      +                          },
      +                          "retrieved_at": {
      +                            "description": "When the source was fetched (ISO 8601).",
      +                            "type": "string"
      +                          },
      +                          "source_id": {
      +                            "type": "string"
      +                          },
      +                          "source_value": {
      +                            "description": "The raw value as given by the source, when not quoted."
      +                          },
      +                          "url": {
      +                            "type": "string"
      +                          }
      +                        },
      +                        "required": [
      +                          "publisher",
      +                          "url",
      +                          "license"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "unit": {
      +                      "type": "string"
      +                    },
      +                    "value": {
      +                      "description": "The fact value; its shape depends on the field."
      +                    }
      +                  },
      +                  "required": [
      +                    "value",
      +                    "sources",
      +                    "last_verified",
      +                    "confidence"
      +                  ],
      +                  "type": "object"
      +                },
      +                "description": "Emergency-number facts. Keys are field names, each value is a cited fact.",
      +                "properties": {
      +                  "numbers": {
      +                    "description": "police, ambulance, fire, general (null when there is no separate number) and all_numbers.",
      +                    "properties": {
      +                      "attribution": {
      +                        "description": "Attribution strings required by the source licenses.",
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "confidence": {
      +                        "description": "Deterministic confidence: score from 0 to 1, a level, and the reasons (source kind, cross-checks, staleness...).",
      +                        "properties": {
      +                          "level": {
      +                            "examples": [
      +                              "high",
      +                              "medium",
      +                              "low"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "reasons": {
      +                            "description": "Why the score is what it is.",
      +                            "items": {
      +                              "type": "string"
      +                            },
      +                            "type": "array"
      +                          },
      +                          "score": {
      +                            "maximum": 1,
      +                            "minimum": 0,
      +                            "type": "number"
      +                          }
      +                        },
      +                        "required": [
      +                          "score",
      +                          "level"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "cross_checks": {
      +                        "description": "Independent datasets the value was checked against, with the result.",
      +                        "type": "array"
      +                      },
      +                      "field": {
      +                        "type": "string"
      +                      },
      +                      "id": {
      +                        "type": "string"
      +                      },
      +                      "last_verified": {
      +                        "description": "Date the value was last verified (YYYY-MM-DD).",
      +                        "type": "string"
      +                      },
      +                      "localization": {
      +                        "type": "object"
      +                      },
      +                      "next_review_due": {
      +                        "description": "Date of the next scheduled review (YYYY-MM-DD).",
      +                        "type": "string"
      +                      },
      +                      "sources": {
      +                        "description": "Cited sources for this fact.",
      +                        "items": {
      +                          "description": "One cited source.",
      +                          "properties": {
      +                            "license": {
      +                              "description": "License of the source, e.g. CC0-1.0, OGL-UK-3.0, MIT.",
      +                              "type": "string"
      +                            },
      +                            "publisher": {
      +                              "type": "string"
      +                            },
      +                            "quote": {
      +                              "description": "Verbatim text from the source, when quoted.",
      +                              "type": "string"
      +                            },
      +                            "retrieved_at": {
      +                              "description": "When the source was fetched (ISO 8601).",
      +                              "type": "string"
      +                            },
      +                            "source_id": {
      +                              "type": "string"
      +                            },
      +                            "source_value": {
      +                              "description": "The raw value as given by the source, when not quoted."
      +                            },
      +                            "url": {
      +                              "type": "string"
      +                            }
      +                          },
      +                          "required": [
      +                            "publisher",
      +                            "url",
      +                            "license"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "unit": {
      +                        "type": "string"
      +                      },
      +                      "value": {
      +                        "description": "The fact value; its shape depends on the field."
      +                      }
      +                    },
      +                    "required": [
      +                      "value",
      +                      "sources",
      +                      "last_verified",
      +                      "confidence"
      +                    ],
      +                    "type": "object"
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "entry": {
      +                "description": "null without a passport; otherwise the check_entry_requirements result, or {unavailable: reason} when there is no entry answer for this destination.",
      +                "type": [
      +                  "object",
      +                  "null"
      +                ]
      +              },
      +              "holidays_during_trip": {
      +                "description": "Public holidays between from and to.",
      +                "items": {
      +                  "properties": {
      +                    "date": {
      +                      "type": "string"
      +                    },
      +                    "fact_id": {
      +                      "type": "string"
      +                    },
      +                    "name": {
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "date",
      +                    "name"
      +                  ],
      +                  "type": "object"
      +                },
      +                "type": "array"
      +              },
      +              "power": {
      +                "description": "check_power_compatibility result from home_country; null for the home country itself or when plug data is missing.",
      +                "type": [
      +                  "object",
      +                  "null"
      +                ]
      +              },
      +              "tipping": {
      +                "additionalProperties": {
      +                  "description": "One cited fact.",
      +                  "properties": {
      +                    "attribution": {
      +                      "description": "Attribution strings required by the source licenses.",
      +                      "items": {
      +                        "type": "string"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "confidence": {
      +                      "description": "Deterministic confidence: score from 0 to 1, a level, and the reasons (source kind, cross-checks, staleness...).",
      +                      "properties": {
      +                        "level": {
      +                          "examples": [
      +                            "high",
      +                            "medium",
      +                            "low"
      +                          ],
      +                          "type": "string"
      +                        },
      +                        "reasons": {
      +                          "description": "Why the score is what it is.",
      +                          "items": {
      +                            "type": "string"
      +                          },
      +                          "type": "array"
      +                        },
      +                        "score": {
      +                          "maximum": 1,
      +                          "minimum": 0,
      +                          "type": "number"
      +                        }
      +                      },
      +                      "required": [
      +                        "score",
      +                        "level"
      +                      ],
      +                      "type": "object"
      +                    },
      +                    "cross_checks": {
      +                      "description": "Independent datasets the value was checked against, with the result.",
      +                      "type": "array"
      +                    },
      +                    "field": {
      +                      "type": "string"
      +                    },
      +                    "id": {
      +                      "type": "string"
      +                    },
      +                    "last_verified": {
      +                      "description": "Date the value was last verified (YYYY-MM-DD).",
      +                      "type": "string"
      +                    },
      +                    "localization": {
      +                      "type": "object"
      +                    },
      +                    "next_review_due": {
      +                      "description": "Date of the next scheduled review (YYYY-MM-DD).",
      +                      "type": "string"
      +                    },
      +                    "sources": {
      +                      "description": "Cited sources for this fact.",
      +                      "items": {
      +                        "description": "One cited source.",
      +                        "properties": {
      +                          "license": {
      +                            "description": "License of the source, e.g. CC0-1.0, OGL-UK-3.0, MIT.",
      +                            "type": "string"
      +                          },
      +                          "publisher": {
      +                            "type": "string"
      +                          },
      +                          "quote": {
      +                            "description": "Verbatim text from the source, when quoted.",
      +                            "type": "string"
      +                          },
      +                          "retrieved_at": {
      +                            "description": "When the source was fetched (ISO 8601).",
      +                            "type": "string"
      +                          },
      +                          "source_id": {
      +                            "type": "string"
      +                          },
      +                          "source_value": {
      +                            "description": "The raw value as given by the source, when not quoted."
      +                          },
      +                          "url": {
      +                            "type": "string"
      +                          }
      +                        },
      +                        "required": [
      +                          "publisher",
      +                          "url",
      +                          "license"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "type": "array"
      +                    },
      +                    "unit": {
      +                      "type": "string"
      +                    },
      +                    "value": {
      +                      "description": "The fact value; its shape depends on the field."
      +                    }
      +                  },
      +                  "required": [
      +                    "value",
      +                    "sources",
      +                    "last_verified",
      +                    "confidence"
      +                  ],
      +                  "type": "object"
      +                },
      +                "description": "Tipping facts. Keys are field names, each value is a cited fact.",
      +                "properties": {
      +                  "norms": {
      +                    "description": "overall_context and situations: {<situation>: {display, expectation, guidance_type, percent_min, percent_max}}.",
      +                    "properties": {
      +                      "attribution": {
      +                        "description": "Attribution strings required by the source licenses.",
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "confidence": {
      +                        "description": "Deterministic confidence: score from 0 to 1, a level, and the reasons (source kind, cross-checks, staleness...).",
      +                        "properties": {
      +                          "level": {
      +                            "examples": [
      +                              "high",
      +                              "medium",
      +                              "low"
      +                            ],
      +                            "type": "string"
      +                          },
      +                          "reasons": {
      +                            "description": "Why the score is what it is.",
      +                            "items": {
      +                              "type": "string"
      +                            },
      +                            "type": "array"
      +                          },
      +                          "score": {
      +                            "maximum": 1,
      +                            "minimum": 0,
      +                            "type": "number"
      +                          }
      +                        },
      +                        "required": [
      +                          "score",
      +                          "level"
      +                        ],
      +                        "type": "object"
      +                      },
      +                      "cross_checks": {
      +                        "description": "Independent datasets the value was checked against, with the result.",
      +                        "type": "array"
      +                      },
      +                      "field": {
      +                        "type": "string"
      +                      },
      +                      "id": {
      +                        "type": "string"
      +                      },
      +                      "last_verified": {
      +                        "description": "Date the value was last verified (YYYY-MM-DD).",
      +                        "type": "string"
      +                      },
      +                      "localization": {
      +                        "type": "object"
      +                      },
      +                      "next_review_due": {
      +                        "description": "Date of the next scheduled review (YYYY-MM-DD).",
      +                        "type": "string"
      +                      },
      +                      "sources": {
      +                        "description": "Cited sources for this fact.",
      +                        "items": {
      +                          "description": "One cited source.",
      +                          "properties": {
      +                            "license": {
      +                              "description": "License of the source, e.g. CC0-1.0, OGL-UK-3.0, MIT.",
      +                              "type": "string"
      +                            },
      +                            "publisher": {
      +                              "type": "string"
      +                            },
      +                            "quote": {
      +                              "description": "Verbatim text from the source, when quoted.",
      +                              "type": "string"
      +                            },
      +                            "retrieved_at": {
      +                              "description": "When the source was fetched (ISO 8601).",
      +                              "type": "string"
      +                            },
      +                            "source_id": {
      +                              "type": "string"
      +                            },
      +                            "source_value": {
      +                              "description": "The raw value as given by the source, when not quoted."
      +                            },
      +                            "url": {
      +                              "type": "string"
      +                            }
      +                          },
      +                          "required": [
      +                            "publisher",
      +                            "url",
      +                            "license"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "unit": {
      +                        "type": "string"
      +                      },
      +                      "value": {
      +                        "description": "The fact value; its shape depends on the field."
      +                      }
      +                    },
      +                    "required": [
      +                      "value",
      +                      "sources",
      +                      "last_verified",
      +                      "confidence"
      +                    ],
      +                    "type": "object"
      +                  }
      +                },
      +                "type": "object"
      +              }
      +            },
      +            "required": [
      +              "destination",
      +              "currency",
      +              "emergency",
      +              "driving",
      +              "tipping",
      +              "holidays_during_trip"
      +            ],
      +            "type": "object"
      +          },
      +          "type": "array"
      +        },
      +        "disclaimer": {
      +          "description": "Informational-use disclaimer.",
      +          "type": "string"
      +        },
      +        "home": {
      +          "description": "Country (ISO codes and name, localized to lang).",
      +          "properties": {
      +            "iso2": {
      +              "type": "string"
      +            },
      +            "iso3": {
      +              "type": "string"
      +            },
      +            "name": {
      +              "type": "string"
      +            },
      +            "name_lang": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "iso2"
      +          ],
      +          "type": "object"
      +        },
      +        "not_a_verdict": {
      +          "type": "string"
      +        },
      +        "passport": {
      +          "type": [
      +            "string",
      +            "null"
      +          ]
      +        },
      +        "range": {
      +          "properties": {
      +            "from": {
      +              "type": "string"
      +            },
      +            "to": {
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "from",
      +            "to"
      +          ],
      +          "type": "object"
      +        }
      +      },
      +      "required": [
      +        "home",
      +        "range",
      +        "destinations"
      +      ],
      +      "title": "Result",
      +      "type": "object"
      +    },
      +    {
      +      "description": "Only on error results (isError: true): RFC 9457 problem, e.g. unknown country, no data, key required, rate limited, sanctions block.",
      +      "properties": {
      +        "detail": {
      +          "type": "string"
      +        },
      +        "status": {
      +          "type": "integer"
      +        },
      +        "title": {
      +          "type": "string"
      +        },
      +        "type": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "type",
      +        "title",
      +        "status"
      +      ],
      +      "title": "Error (problem details)",
      +      "type": "object"
      +    },
      +    {
      +      "description": "Only on error results (isError: true): x402 v2 payment requirements. Pay and retry with _meta[\"x402/payment\"].",
      +      "properties": {
      +        "accepts": {
      +          "type": "array"
      +        },
      +        "error": {
      +          "type": "string"
      +        },
      +        "extensions": {
      +          "type": "object"
      +        },
      +        "resource": {
      +          "type": "object"
      +        },
      +        "x402Version": {
      +          "type": "integer"
      +        }
      +      },
      +      "required": [
      +        "x402Version",
      +        "accepts"
      +      ],
      +      "title": "Error (x402 payment request)",
      +      "type": "object"
      +    }
      +  ],
      +  "type": "object"
      +}
  2. 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 read-only/idempotent/non-destructive, but the description adds substantial context beyond them: null entry without passport, per-destination failure isolation via {unavailable: reason}, null power at home, {} for missing categories, the exact failure conditions (unknown code, >5 destinations, bad date range), citation metadata (sources[], last_verified, confidence), auth (API key or x402), per-call pricing, and RFC 9457 errors.

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 tool's scope, then alternatives, then edge cases, then parameter semantics and operational meta. It is dense and largely earns its length, but a few clauses restate schema content (the destinations ordering note, the worked example) and the parenthetical nesting makes it a single run-on block.

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?

Even though an output schema exists, the description covers the response shape at a high level (citations, confidence), all null/partial-result cases, error conditions, auth and billing. For a 6-parameter aggregate tool with per-destination degradation, this is complete enough to invoke correctly.

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 description coverage is 100%, so the baseline is 3. The description still adds meaning beyond the schema: passport is framed as nationality rather than a generic country code, home_country is where traveller and devices come from, destinations must be in travel order with home included only if it is a stop, and from/to are inclusive over the whole trip.

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+resource (whole-trip brief for 1-5 destinations) and enumerates exactly what it returns: entry, power verdict, currency, emergency numbers, driving side, tipping, holidays. It explicitly contrasts itself with siblings (check_entry_requirements, check_power_compatibility, get_emergency_numbers, get_tipping_norms, get_public_holidays, get_country_facts), so an agent can route 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?

Gives an explicit when-to-use rule ('Use it to summarise a trip') and a when-not-to-use rule with named alternatives for each single-fact case, plus a scoping distinction for get_country_facts ('one country without dates'). Nothing about tool selection is left to inference.

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