Tools
list_plans
The plans on sale for a destination, with data, validity, networks and price in the requested currency.
- Read only
- Idempotent
- Closed world
Every plan Wigoo sells for one destination. Use it to compare sizes and durations, and to get the plan_id that get_quote needs.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
destination_id | string | Yes | Destination id from search_destinations, e.g. "jp" or "eu-42".1 to 40 characters |
type | string | No | Only fixed data plans, only unlimited day passes, or all. Defaults to all.One of all, fixed, unlimited |
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
- There are two kinds of plan. Fixed plans have a data amount and a validity, such as 5 GB for 30 days. Unlimited plans are day passes: a daily amount at full speed, then a reduced speed until the next day.
typefilters the list. Without it you get both kinds.- An unlimited plan's
datastring says what the daily allowance is and what happens after it:Unlimited: 2 GB per day at full speed, then 1 Mbps. - A fixed plan's
datais the amount, such as1 GB. - An id that is not a destination, or has no plans on sale, returns a tool error.
Response
| Field | Type | Meaning |
|---|---|---|
destination.id | string | The destination id |
destination.name | string | The destination's name |
plans | array | The plans, as below |
plans[].plan_id | string | The id to pass to get_quote |
plans[].name | string | The plan's name |
plans[].type | fixed or unlimited | The kind of plan |
plans[].data | string | The data amount, or the unlimited description |
plans[].validity_days | number | How many days the plan lasts, from first connection |
plans[].price | price | The list price in the requested currency |
plans[].networks | string array | Networks, at most eight, then and N more |
plans[].supports_top_up | boolean | Whether more data can be added to the same eSIM |
buy_url | string | The destination page on getwigoo.com, with every plan |
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":"list_plans","arguments":{"destination_id":"jp","type":"unlimited","currency":"EUR"}}}'{
"destination": { "id": "jp", "name": "Japan" },
"plans": [
{
"plan_id": "JP_2_Daily_1Mbps-3d",
"name": "Japan 2GB/Day FUP1Mbps",
"type": "unlimited",
"data": "Unlimited: 2 GB per day at full speed, then 1 Mbps",
"validity_days": 3,
"price": { "amount": 7.99, "currency": "EUR", "formatted": "€7.99" },
"networks": ["KDDI/au (5G)", "NTT docomo (5G)", "Rakuten Mobile (5G)", "SoftBank (5G)"],
"supports_top_up": true
}
],
"buy_url": "https://getwigoo.com/en/buy/jp?utm_source=mcp&utm_medium=agent"
}The real response lists every unlimited plan for Japan, one per duration.
Next
get_quote turns a plan_id into a price and a link that opens its purchase.