161 countries and territories138 of 193 UN membersmonthly to 2026-09back to 1926
Documentation / Guides / Start here / 05 of 26

MCP tools

Every tool the MCP server offers, what it answers and its inputs.

Guide

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.

InputTypeRequiredDescription
monthly_onlybooleannoOnly countries with monthly figures

country_profile

One country: what is held by measure, frequency and breakdown, and which statistics it carries.

InputTypeRequiredDescription
countrystringyesISO 3166 two-letter country code, such as JP

latest_figures

A country's newest headline figure with its change on a year before.

InputTypeRequiredDescription
countrystringyesISO 3166 two-letter country code, such as JP

get_measure

Monthly (or quarterly, yearly) figures of one measure for up to ten countries.

InputTypeRequiredDescription
measurestring: arrivals, nights, spend, departures, occupancy, capacityyesWhat is counted
countrystringyesOne or more ISO codes, comma separated, such as JP,TH,FR
freqstring: M, Q, Ano
fromstringnoFirst period: a year (2019), month (2024-01) or date
tostringnoLast period: a year, month or date

compare_countries

Two to ten countries side by side, month by month, for one measure.

InputTypeRequiredDescription
countrystringyesOne or more ISO codes, comma separated, such as JP,TH,FR
measurestring: arrivals, nights, spend, departures, occupancy, capacitynoWhat is counted
fromstringnoFirst period: a year (2019), month (2024-01) or date
tostringnoLast period: a year, month or date

rank_countries

Countries ranked by one measure in one month, with the change on a year before.

InputTypeRequiredDescription
measurestring: arrivals, nights, spend, departures, occupancy, capacitynoWhat is counted
periodstringnoA month such as 2025-08; empty for each country's latest
limitintegerno

growth

Change on a year before, and year to date, for up to 25 countries.

InputTypeRequiredDescription
countrystringyesOne or more ISO codes, comma separated, such as JP,TH,FR
measurestring: arrivals, nights, spend, departures, occupancy, capacitynoWhat is counted
periodstringnoA month (2025-08) or a year (2025)

search_series

Find series by words in their names, optionally in one country.

InputTypeRequiredDescription
qstringyesWords, such as hotel nights foreign
countrystringnoISO 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).

InputTypeRequiredDescription
idstringyes
fromstringnoFirst period: a year (2019), month (2024-01) or date
tostringnoLast 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.

InputTypeRequiredDescription
countrystringyesISO 3166 two-letter country code, such as JP
levelstring: region, nuts3, cityno
placestringnoPart of a place name, such as Barcelona
freqstring: M, Ano
periodstringnoA 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.

InputTypeRequiredDescription
countrystringyesISO 3166 two-letter country code, such as JP
kindstringnoPart of the kind, such as museum or theme park
yearstringnoA 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.

InputTypeRequiredDescription
countrystringnoISO 3166 two-letter country code, such as JP
kindstring: country, region, nuts, city, airport, venueno
parentstringnoA place code, such as FR10 or AT-3
qstringnoWords in the name
wikidatastringnoA 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.

InputTypeRequiredDescription
countrystringyesISO 3166 two-letter country code, such as JP
placestringnoA region code (DK01) or part of its name (Hovedstaden)
freqstring: D, Mno
fromstringnoFirst period: a year (2019), month (2024-01) or date
tostringnoLast 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.

InputTypeRequiredDescription
countrystringyesOne or more ISO codes, comma separated, such as JP,TH,FR
itemstringnohotels, air, air_international or package_holidays; comma separated, empty for all
fromstringnoFirst period: a year (2019), month (2024-01) or date
tostringnoLast 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.

InputTypeRequiredDescription
countrystringyesISO 3166 two-letter country code, such as JP
metricstringnoadr, revpar or occupancy; comma separated, empty for all
placestringnoPart of a place name, such as Benidorm
levelstring: country, province, zone, pointno
fromstringnoFirst period: a year (2019), month (2024-01) or date
tostringnoLast 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.

InputTypeRequiredDescription
countrystringyesISO 3166 two-letter country code, such as JP
groupstring: pair, country, totalno
airportstringnoFour-letter airport code, such as LEMD
partnerstringnoPartner country code, such as GB
fromstringnoFirst period: a year (2019), month (2024-01) or date
tostringnoLast period: a year, month or date

air_fares

US domestic average air fares by airport, quarterly, with daily passengers; airport US for the country.

InputTypeRequiredDescription
airportstringnoThree-letter US airport code such as LAX, or US
fromstringnoFirst period: a year (2019), month (2024-01) or date
tostringnoLast 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.

InputTypeRequiredDescription
countrystringyesISO 3166 two-letter country code, such as JP
issuerstringnoThe 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.

InputTypeRequiredDescription
countrystringyesISO 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.

InputTypeRequiredDescription
countrystringyesISO 3166 two-letter country code, such as JP
issuerstringnoAdvising government code, such as GB
categorystringnosecurity, terrorism, conflict, civil_unrest, crime, health, natural_hazard, weather, entry_requirements, visas, transport, insurance, laws_and_customs, money, consular or editorial
impactstring: none, low, medium, highno
fromstringnoFirst period: a year (2019), month (2024-01) or date
tostringnoLast period: a year, month or date

origin_markets

A country's arrivals split by where visitors come from, largest first.

InputTypeRequiredDescription
countrystringyesISO 3166 two-letter country code, such as JP
periodstringno

statistic

A worked statistic for one country: trend, recovery, benchmark, stay-length, forecast, nowcast, anomalies, origin-shift or concentration.

InputTypeRequiredDescription
statstring: trend, recovery, benchmark, stay-length, forecast, nowcast, anomalies, origin-shift, concentrationyes
countrystringyesISO 3166 two-letter country code, such as JP

holidays

Public holidays for one or more countries in a date range.

InputTypeRequiredDescription
countrystringyesOne or more ISO codes, comma separated, such as JP,TH,FR
fromstringnoFirst period: a year (2019), month (2024-01) or date
tostringnoLast period: a year, month or date

exchange_rates

Daily rates of one currency against the euro.

InputTypeRequiredDescription
currencystringyesISO 4217, such as THB
fromstringnoFirst period: a year (2019), month (2024-01) or date
tostringnoLast 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.

InputTypeRequiredDescription
countrystringyesISO 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).

InputTypeRequiredDescription
countrystringyesISO 3166 two-letter country code, such as JP
yearintegerno

holidays_on_date

Every country with a public holiday on one day.

InputTypeRequiredDescription
datestringnoA 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.

InputTypeRequiredDescription
countrystringyesISO 3166 two-letter country code, such as JP
yearintegerno

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.

InputTypeRequiredDescription
countrystringnoOne or more ISO codes, comma separated, such as JP,TH,FR
regionstringnoA region or zone, such as noord or Zone A; empty for all
fromstringnoFirst period: a year (2019), month (2024-01) or date
tostringnoLast period: a year, month or date

seasons

A country's busy and quiet months: an index by month where 100 is an average month.

InputTypeRequiredDescription
countrystringyesISO 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.

InputTypeRequiredDescription
countrystringyesISO 3166 two-letter country code, such as JP

release_calendar

When each country's next month of figures is expected.

InputTypeRequiredDescription
countrystringnoOne 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.