Tools
get_destination
What a destination offers: networks, data sizes, validity options, unlimited day passes, top ups and the starting price.
- Read only
- Idempotent
- Closed world
A summary of one destination, for the question "what can I get there?" before looking at individual plans. It returns the same fields as one entry of search_destinations, plus what the plans add up to.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
destination_id | string | Yes | Destination id from search_destinations, e.g. "jp" or "eu-42".1 to 40 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
- The summary counts fixed plans and unlimited day passes separately:
data_optionsandvalidity_options_daysdescribe the fixed plans only, andunlimited_durations_daysthe unlimited ones. how_it_worksis a short, fixed explanation an assistant can pass on to a traveler who has never used an eSIM.- An id that is not a destination, or has no plans on sale, returns a tool error that tells the model to call
search_destinations.
Response
The fields of a search_destinations entry (id, name, type, country_code, countries_covered, from_price, networks, buy_url), and:
| Field | Type | Meaning |
|---|---|---|
plans_available | number | Plans on sale for the destination |
data_options | string array | Data sizes of the fixed plans, such as 1 GB, 20 GB |
validity_options_days | number array | Durations of the fixed plans, in days, ascending |
has_unlimited | boolean | Whether unlimited day passes exist |
unlimited_durations_days | number array | Durations of the unlimited passes, in days |
can_top_up | boolean | Whether at least one plan can be topped up with more data |
how_it_works | string | What a data eSIM is, what the phone needs, when validity starts |
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":"get_destination","arguments":{"destination_id":"jp"}}}'{
"id": "jp",
"name": "Japan",
"type": "country",
"country_code": "JP",
"countries_covered": 1,
"from_price": { "amount": 2.49, "currency": "USD", "formatted": "$2.49" },
"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",
"plans_available": 9,
"data_options": ["1 GB", "3 GB", "5 GB", "10 GB", "20 GB"],
"validity_options_days": [7, 30],
"has_unlimited": true,
"unlimited_durations_days": [3, 7, 15, 30],
"can_top_up": true,
"how_it_works": "A data eSIM: the usual SIM and phone number keep working alongside it. It needs an eSIM compatible, carrier unlocked phone. Install it before the trip; the validity starts when it first connects to a network at the destination."
}Next
list_plans shows each plan behind these numbers.