MCP tools
Every tool the MCP server offers, what it answers and its inputs.
The MCP server at https://tourismapi.com/mcp offers 32 tools. An assistant reads this list itself (the tools/list call) and picks the tool that answers the question; each call counts against your key like any other request, and your plan decides what it can read.
list_countries
Every country held, with its region, depth, latest month and measures.
| Input | Type | Required | Description |
|---|---|---|---|
monthly_only | boolean | no | Only countries with monthly figures |
country_profile
One country: what is held by measure, frequency and breakdown, and which statistics it carries.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
latest_figures
A country's newest headline figure with its change on a year before.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
get_measure
Monthly (or quarterly, yearly) figures of one measure for up to ten countries.
| Input | Type | Required | Description |
|---|---|---|---|
measure | string: arrivals, nights, spend, departures, occupancy, capacity | yes | What is counted |
country | string | yes | One or more ISO codes, comma separated, such as JP,TH,FR |
freq | string: M, Q, A | no | |
from | string | no | First period: a year (2019), month (2024-01) or date |
to | string | no | Last period: a year, month or date |
compare_countries
Two to ten countries side by side, month by month, for one measure.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | One or more ISO codes, comma separated, such as JP,TH,FR |
measure | string: arrivals, nights, spend, departures, occupancy, capacity | no | What is counted |
from | string | no | First period: a year (2019), month (2024-01) or date |
to | string | no | Last period: a year, month or date |
rank_countries
Countries ranked by one measure in one month, with the change on a year before.
| Input | Type | Required | Description |
|---|---|---|---|
measure | string: arrivals, nights, spend, departures, occupancy, capacity | no | What is counted |
period | string | no | A month such as 2025-08; empty for each country's latest |
limit | integer | no |
growth
Change on a year before, and year to date, for up to 25 countries.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | One or more ISO codes, comma separated, such as JP,TH,FR |
measure | string: arrivals, nights, spend, departures, occupancy, capacity | no | What is counted |
period | string | no | A month (2025-08) or a year (2025) |
search_series
Find series by words in their names, optionally in one country.
| Input | Type | Required | Description |
|---|---|---|---|
q | string | yes | Words, such as hotel nights foreign |
country | string | no | ISO 3166 two-letter country code, such as JP |
series_figures
Every figure of one series by its id (sr_...) or readable name (jp.arrivals.total.m).
| Input | Type | Required | Description |
|---|---|---|---|
id | string | yes | |
from | string | no | First period: a year (2019), month (2024-01) or date |
to | string | no | Last period: a year, month or date |
destinations
Places inside a country (regions, NUTS 3 regions, named cities) with their nights and the country's own nights for the same period.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
level | string: region, nuts3, city | no | |
place | string | no | Part of a place name, such as Barcelona |
freq | string: M, A | no | |
period | string | no | A year (2024) or a month (2025-08); empty for each place's newest |
venues
Museums, attractions, parks and heritage sites in a country with their yearly visitor counts, largest first, each with its kind, coordinates, change on the year before and every year held.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
kind | string | no | Part of the kind, such as museum or theme park |
year | string | no | A year, such as 2024; empty for each venue's latest |
places
The place register: countries, regions, NUTS regions, EU cities, airports and venues with their codes, parent place and Wikidata id, to join figures across datasets. Name a country, a kind, a parent code, words in the name or a Wikidata id.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | no | ISO 3166 two-letter country code, such as JP |
kind | string: country, region, nuts, city, airport, venue | no | |
parent | string | no | A place code, such as FR10 or AT-3 |
q | string | no | Words in the name |
wikidata | string | no | A Wikidata id, such as Q90 |
weather
Daily or monthly weather (mean, high and low temperature, rain, wind, sunshine) for each region of a country, keyed by the same region codes as destinations.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
place | string | no | A region code (DK01) or part of its name (Hovedstaden) |
freq | string: D, M | no | |
from | string | no | First period: a year (2019), month (2024-01) or date |
to | string | no | Last period: a year, month or date |
prices
Monthly consumer prices of hotels, air fares and package holidays in European countries (index 2025 = 100, change on a year), beside each country's nights.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | One or more ISO codes, comma separated, such as JP,TH,FR |
item | string | no | hotels, air, air_international or package_holidays; comma separated, empty for all |
from | string | no | First period: a year (2019), month (2024-01) or date |
to | string | no | Last period: a year, month or date |
hotel_rates
Hotel average daily rate, revenue per available room and occupancy by place (provinces, tourist zones, tourist points, regions), monthly: Spain, Singapore, Thailand, Sint Maarten.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
metric | string | no | adr, revpar or occupancy; comma separated, empty for all |
place | string | no | Part of a place name, such as Benidorm |
level | string: country, province, zone, point | no | |
from | string | no | First period: a year (2019), month (2024-01) or date |
to | string | no | Last period: a year, month or date |
seat_capacity
Seats offered by air each month on a European country's routes: by airport pair, by partner country, or in total beside its arrivals.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
group | string: pair, country, total | no | |
airport | string | no | Four-letter airport code, such as LEMD |
partner | string | no | Partner country code, such as GB |
from | string | no | First period: a year (2019), month (2024-01) or date |
to | string | no | Last period: a year, month or date |
air_fares
US domestic average air fares by airport, quarterly, with daily passengers; airport US for the country.
| Input | Type | Required | Description |
|---|---|---|---|
airport | string | no | Three-letter US airport code such as LAX, or US |
from | string | no | First period: a year (2019), month (2024-01) or date |
to | string | no | Last period: a year, month or date |
travel_advice
The travel advice governments give their citizens about a destination now, on one scale (0 normal precautions to 3 avoid all travel), with each government's own wording, the day the level was set, a plain English summary of its advice and the places it names.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
issuer | string | no | The advising government's country code, such as GB; empty for all |
travel_advice_summary
One destination's travel advice in full: a headline and a summary combining every government's advice, the places they name, how the governments split across the levels, and each government's own summary, strongest first.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
travel_advice_changes
Dated changes to governments' travel advice about a destination, newest first, with categories, a one-sentence summary and the likely impact on travel.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
issuer | string | no | Advising government code, such as GB |
category | string | no | security, terrorism, conflict, civil_unrest, crime, health, natural_hazard, weather, entry_requirements, visas, transport, insurance, laws_and_customs, money, consular or editorial |
impact | string: none, low, medium, high | no | |
from | string | no | First period: a year (2019), month (2024-01) or date |
to | string | no | Last period: a year, month or date |
origin_markets
A country's arrivals split by where visitors come from, largest first.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
period | string | no |
statistic
A worked statistic for one country: trend, recovery, benchmark, stay-length, forecast, nowcast, anomalies, origin-shift or concentration.
| Input | Type | Required | Description |
|---|---|---|---|
stat | string: trend, recovery, benchmark, stay-length, forecast, nowcast, anomalies, origin-shift, concentration | yes | |
country | string | yes | ISO 3166 two-letter country code, such as JP |
holidays
Public holidays for one or more countries in a date range.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | One or more ISO codes, comma separated, such as JP,TH,FR |
from | string | no | First period: a year (2019), month (2024-01) or date |
to | string | no | Last period: a year, month or date |
exchange_rates
Daily rates of one currency against the euro.
| Input | Type | Required | Description |
|---|---|---|---|
currency | string | yes | ISO 4217, such as THB |
from | string | no | First period: a year (2019), month (2024-01) or date |
to | string | no | Last period: a year, month or date |
population
A country's population: women and men, age groups, towns, density, growth, births, deaths, life expectancy and migration, with its latest census.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
age_pyramid
A country's women and men in five-year age bands for a year (the newest when left out).
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
year | integer | no |
holidays_on_date
Every country with a public holiday on one day.
| Input | Type | Required | Description |
|---|---|---|---|
date | string | no | A day such as 2026-12-25; today when left out |
long_weekends
A country's long weekends in a year, and the single days off that make longer breaks.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
year | integer | no |
school_holidays
School holidays by region (France by zone and academy, the Netherlands by north, middle and south), each with its first and last day off, days and school year; the next twelve months when no dates are given.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | no | One or more ISO codes, comma separated, such as JP,TH,FR |
region | string | no | A region or zone, such as noord or Zone A; empty for all |
from | string | no | First period: a year (2019), month (2024-01) or date |
to | string | no | Last period: a year, month or date |
seasons
A country's busy and quiet months: an index by month where 100 is an average month.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
how_counted
How a country counts its visitors (border records, accommodation registers, a survey or airport counts), how often and how late it publishes, and what changed.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | yes | ISO 3166 two-letter country code, such as JP |
release_calendar
When each country's next month of figures is expected.
| Input | Type | Required | Description |
|---|---|---|---|
country | string | no | One or more ISO codes, comma separated, such as JP,TH,FR |
A call, as the assistant sends it
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "latest_figures",
"arguments": {
"country": "JP"
}
}
}The answer carries the same JSON the REST endpoint returns, as the tool result's text. Connecting a client is on MCP server for Claude and ChatGPT.