Tools
search_destinations
Find the countries and regions Wigoo sells travel eSIMs for, with the starting price, the networks and a buy link.
- Read only
- Idempotent
- Closed world
Finds destinations by country or region name in English, or by ISO country code. A name in one of the site's languages (Italian, Spanish, French, German, Polish, Portuguese, Turkish) works too, such as Giappone or Allemagne. Without a query it returns the popular destinations, so an assistant can start a conversation with something to offer.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | No | Country or region name in English, or ISO code: "Japan", "JP", "Europe".Up to 80 characters |
currency | string | No | ISO 4217 code for prices, e.g. EUR, GBP, JPY. Defaults to USD.Three letters |
language | string | No | Language of the buy link and of region names: en, it, es, fr, de, pl, pt, tr. Defaults to en.Up to 10 characters |
Behavior
- A query matches country and region names. An exact ISO country code always comes first:
JPreturns Japan before any region whose name merely contains those letters. - With no
query, or an empty one, you get the destinations Wigoo features. - A response holds at most 20 destinations.
more_resultscounts the ones left out, so a larger number means the query should be more precise. - When the English names match nothing, the query is compared with the names in the site's languages, without accents or case:
Giappone,Japón,Europa. - A query that matches nothing is not an error:
destinationsis an empty array, andhintsays how to search instead.
Response
| Field | Type | Meaning |
|---|---|---|
destinations | array | The matches, best first |
destinations[].id | string | The destination id to pass to the other tools |
destinations[].name | string | Country name in English, or region name in the requested language |
destinations[].type | country or region | A single country or a multi-country region |
destinations[].country_code | string or null | ISO country code for a country, null for a region |
destinations[].countries_covered | number | 1 for a country, the number of countries for a region |
destinations[].from_price | price | The cheapest plan on sale |
destinations[].networks | string array | Networks, at most eight, then and N more |
destinations[].buy_url | string | The destination page on getwigoo.com |
more_results | number | Matches left out of this response |
hint | string, only when nothing matched | How to search instead |
Example
curl https://api.getwigoo.com/api/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"search_destinations","arguments":{"query":"JP","currency":"EUR"}}}'{
"destinations": [
{
"id": "jp",
"name": "Japan",
"type": "country",
"country_code": "JP",
"countries_covered": 1,
"from_price": { "amount": 2.19, "currency": "EUR", "formatted": "€2.19" },
"networks": ["KDDI/au (5G)", "NTT docomo (5G)", "Rakuten Mobile (5G)", "SoftBank (5G)"],
"buy_url": "https://getwigoo.com/en/buy/jp?utm_source=mcp&utm_medium=agent"
}
],
"more_results": 0
}Prices, plans and networks change with the catalog; the values here show the shape.
Next
Pass an id to get_destination or list_plans.