Overview
Covers about 228 countries and territories. Passport validity is normalized to a rule and a number, such as 6 months after arrival, 3 months after departure or valid for the whole stay, with a one-line summary and plain-English guidance alongside. Send trip dates and a passport expiry date and the API works out the date the passport must be valid until and whether it passes. Rules come from UK FCDO travel advice, published for British passport holders; passport validity, blank page and vaccination rules are usually the same for every foreign visitor, while visa rules are not (see the Visa Requirements API). US advisory levels come from the State Department. Data is checked daily. Confirm with the destination's official source before travel.
Live Test Travel Entry Requirements Source →
The tool
Once your client is connected to the VerveContext server, this appears in its tool list as TravelEntryRequirements. It is read-only and open-world — it fetches and never mutates anything on your side — so most clients call it without asking you to confirm.
{
"name": "TravelEntryRequirements",
"arguments": {
"destination": "TH"
}
}You do not name the tool yourself; the model picks it. Asking about TH in the terms this source covers is enough for it to reach for TravelEntryRequirements on its own — naming it explicitly also works, and is the way to force the call.
Connecting
One server URL covers every source in the catalog, including this one. Authorization is OAuth: the client opens a browser once, and there is no key to paste into a config file.
{
"mcpServers": {
"vervecontext": {
"url": "https://api.vervecontext.com/v1/mcp"
}
}
}https://api.vervecontext.com/v1/mcpPer-client setup — Claude, Cursor, VS Code, ChatGPT — is on the MCP setup page.
Arguments
These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made. Premium arguments are accepted on every plan but only take effect on plans that include them.
| Argument | Type | Description |
|---|---|---|
destinationRequired | string | The destination country or territory: a two-letter ISO code such as TH, or an English name such as Thailand length 0–60 |
arrivalDateOptionalPremium | string | Trip arrival date (YYYY-MM-DD), for passportCheck date |
departureDateOptionalPremium | string | Trip departure date (YYYY-MM-DD), for passportCheck date |
passportExpiryOptionalPremium | string | The traveler's passport expiry date (YYYY-MM-DD); passportCheck says whether it meets the destination's rule date |
What the model gets back
The result carries a structuredContent object matching the tool's declared outputSchema, so a client reads fields without parsing prose. status is "ok" and error is null on success; a null field means the value was not available for that input, not that the call failed.
{
"status": "ok",
"error": null,
"data": {
"destination": "TH",
"destinationName": "Thailand",
"passportValidity": {
"rule": "months_after_arrival",
"months": 6,
"days": null,
"summary": "Valid for at least 6 months after arrival",
"issuedWithinYears": null,
"guidance": "Your passport must be valid for at least 6 months after the day you arrive. It needs at least 1 blank page."
},
"blankPagesRequired": 1,
"passportCheck": null,
"yellowFever": {
"certificate": "from_risk_countries",
"certificateLabel": "Certificate required only when arriving from, or transiting, a country with yellow fever risk",
"guidance": "A yellow fever vaccination certificate is required only if you are arriving from, or have transited through, a country with a risk of yellow fever transmission. Travelers coming directly from elsewhere do not need one."
},
"advisories": {
"uk": {
"level": "avoid_all_but_essential_travel_to_parts",
"label": "Advises against all but essential travel to parts of the country",
"url": "https://www.gov.uk/foreign-travel-advice/thailand"
},
"us": {
"level": 1,
"label": "Exercise normal precautions",
"url": "https://travel.state.gov/content/tsg_aem/us/en/home/international-travel/travel-advisories/destination.tha.html"
}
},
"rulesUpdatedAt": "2026-10-12T10:20:34+01:00",
"updatedAt": "2026-11-14T08:32:16.103Z"
}
}
Response fields
Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.
| Field | Type | Example | Description |
|---|---|---|---|
destination | string | TH | Destination, ISO 3166 two-letter code |
destinationName | string | Thailand | Destination name |
passportValidity | object | {…} | |
passportValidity.rule | string | months_after_arrival | months_after_arrival, months_after_departure, days_after_arrival, days_after_departure, months_after_visa_application, months_after_visa_expiry, duration_of_stay, valid_on_arrival, or null when no rule is published |
passportValidity.months | number | 6 | Minimum months of passport validity the rule requires, or null |
passportValidity.days | object | null | Minimum days of passport validity the rule requires, when the rule is stated in days, or null |
passportValidity.summary | string | Valid for at least 6 months after arrival | The rule as one sentence, e.g. Valid for at least 6 months after arrival |
passportValidity.issuedWithinYearsPremium | object | null | 10 when the passport must have been issued within the last 10 years (Schengen area rules), else null |
passportValidity.guidancePremium | string | Your passport must be valid for at least 6 months after the day you arrive. It needs at least 1 blan… | Plain-English guidance combining the validity rule, the issue-date limit and blank pages, e.g. Your passport must be valid for at least 6 months after the day you arrive. It needs at least 1 blank page. |
blankPagesRequiredPremium | number | 1 | Minimum blank passport pages required on entry, or null when none is stated |
passportCheck | object | null | |
yellowFever | object | {…} | |
yellowFever.certificate | string | from_risk_countries | all_travellers, from_risk_countries, not_listed or see_text |
yellowFever.certificateLabel | string | Certificate required only when arriving from, or transiting, a country with yellow fever risk | Readable form of yellowFever.certificate |
yellowFever.guidancePremium | string | A yellow fever vaccination certificate is required only if you are arriving from, or have transited… | Plain-English guidance on the yellow fever certificate requirement |
advisories | object | {…} | |
advisories.uk | object | {…} | |
advisories.uk.levelPremium | string | avoid_all_but_essential_travel_to_parts | UK travel advice level: no_warnings, avoid_all_but_essential_travel_to_parts, avoid_all_travel_to_parts, avoid_all_but_essential_travel or avoid_all_travel |
advisories.uk.labelPremium | string | Advises against all but essential travel to parts of the country | Readable form of the UK advice level |
advisories.uk.urlPremium | string | https://www.gov.uk/foreign-travel-advice/thailand | UK travel advice page for the destination |
advisories.us | object | {…} | |
advisories.us.levelPremium | number | 1 | US State Department advisory level, 1 (exercise normal precautions) to 4 (do not travel); advisories.us is null when none is published |
advisories.us.labelPremium | string | Exercise normal precautions | Readable form of the US advisory level |
advisories.us.urlPremium | string | https://travel.state.gov/content/tsg_aem/us/en/home/international-travel/travel-advisories/destinati… | US State Department advisory page for the destination |
rulesUpdatedAt | string | 2026-10-12T10:20:34+01:00 | When this destination's entry rules were last revised (ISO 8601) |
updatedAt | string | 2026-11-14T08:32:16.103Z | When the dataset was last refreshed (ISO 8601) |
Why ground on it
A model can produce something that looks like this answer from its training data, and be confidently out of date or simply wrong. This source returns the current value in a shape you can check, which is the difference between an answer you can cite and one you have to hedge.
Point an evaluation at destinationName: it is the field most worth pinning a claim to, and it is either present and current or absent — never plausibly invented.
Failure modes
Errors come back as tool errors carrying a sentence the model can act on, not a bare status code. Error handling covers the full list.
| Status | What it means |
|---|---|
400 / 422 | The arguments did not validate. The message names the offending one. |
401 | The OAuth session is invalid or expired — reconnect the server. |
403 | Blocked by a key restriction or an IP allow-list. Never a bad identity. |
404 | This source is not part of VerveContext. Check the catalog. |
429 | Out of credits, or a brief rate limit. The message tells them apart. |
A call costs 20 credits each time the tool actually runs; a model that reasons about the tool without calling it costs nothing.
Use cases
- Booking Checkout Checks
- Booking sites compare the traveler's passport expiry date with the destination's validity rule and warn before payment when it falls short.
- Corporate Travel Risk
- Travel management tools show the UK and US advisory levels for each trip and route level 3 and 4 destinations for approval.
- Travel Agency Itineraries
- Agencies print passport validity, blank page and yellow fever requirements on every itinerary instead of researching each country by hand.
- Trip Planning Apps
- Itinerary apps list what each stop needs, such as a yellow fever certificate after a stop in a risk country, so travelers prepare before they leave.
Other ways to use Travel Entry Requirements
Set up Travel Entry Requirements on VerveContext, or reach the same source a different way. Your VerveContext account and credits work on all of them — one key, one balance.
Related
More in Transportation: