MCP tools | Tourism API documentation

The MCP server at https://tourismapi.com/mcp offers 14 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

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

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.