Hungry eSIM

Working · 1.6 s

com.hungry-esim/esimv1.1.0 Domain verified

Travel eSIMs: unlimited data, pick your days, top up existing eSIMs, card checkout, no API key.

Maps & Travel Commerce

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.hungry-esim.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

check_destination_coverage Read-only

Check whether we cover a destination before choosing a plan — answers "do you work in X?", "can I get mobile data / a SIM card in X?", "is X supported?". Returns yes/no, how many plans cover it, and the cheapest unlimited and fixed-data plan as examples. Use search_esim_plans or find_cheapest_plan for the full list.

countrystring, required

ISO 3166-1 alpha-2 country code of the destination, e.g. 'JP', 'US'

currencystring

ISO currency for prices, default the store currency

Tools (10)

check_destination_coverage

read-only

Argument	Type	Description
country*	string	ISO 3166-1 alpha-2 country code of the destination, e.g. 'JP', 'US'
currency	string	ISO currency for prices, default the store currency

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "country"
  ],
  "properties": {
    "country": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "ISO 3166-1 alpha-2 country code of the destination, e.g. 'JP', 'US'"
    },
    "currency": {
      "type": "string",
      "maxLength": 3,
      "minLength": 3,
      "description": "ISO currency for prices, default the store currency"
    }
  }
}

create_checkout

Buy the chosen eSIM data plan: builds a cart and returns a checkout URL the traveller opens to pay by credit card on hungry-esim.com — no crypto wallet and no API key needed. Use once a plan is picked. Does NOT charge — the user completes payment on the website. For unlimited plans, period_num (how many days of data the traveller wants) is required. If the customer is signed in, the order is linked to their account automatically.

Argument	Type	Description
count	integer	Number of eSIMs, default 1
email	string	Guest email — prefills checkout so it skips the details step. Ignored when the customer is signed in (their account email is used). Never determines which account the order belongs to.
country*	string	Customer's CHECKOUT country (ISO alpha-2) — sets checkout region/currency and URL locale. NOT the eSIM's coverage country. If the store doesn't serve it, the store's default region is used.
period_num	integer	Days for unlimited plans (1-90; each plan states its own maximum). Required for unlimited, ignored otherwise.
variant_id*	string	Variant id from search_esim_plans

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "variant_id",
    "country"
  ],
  "properties": {
    "count": {
      "type": "integer",
      "maximum": 20,
      "minimum": 1,
      "description": "Number of eSIMs, default 1"
    },
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Guest email — prefills checkout so it skips the details step. Ignored when the customer is signed in (their account email is used). Never determines which account the order belongs to."
    },
    "country": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "Customer's CHECKOUT country (ISO alpha-2) — sets checkout region/currency and URL locale. NOT the eSIM's coverage country. If the store doesn't serve it, the store's default region is used."
    },
    "period_num": {
      "type": "integer",
      "maximum": 90,
      "minimum": 1,
      "description": "Days for unlimited plans (1-90; each plan states its own maximum). Required for unlimited, ignored otherwise."
    },
    "variant_id": {
      "type": "string",
      "description": "Variant id from search_esim_plans"
    }
  }
}

find_cheapest_plan

Find the lowest-priced eSIM data plan for a destination — for "what's the cheapest", "budget option", "cheapest SIM / data plan for X". Pass days (trip length) to rank by what the traveller actually pays for the whole trip: unlimited plans are priced per day with a multi-day discount, fixed-data plans by their sticker price, and plans that expire before the trip ends are dropped. Without days it ranks by daily rate. Returns up to 3 options with variant_id for create_checkout.

read-only

Argument	Type	Description
days	integer	Trip length in days. When given, plans are ranked by total trip cost.
limit	integer	How many options to return, default 3
country*	string	ISO 3166-1 alpha-2 country code of the destination, e.g. 'JP', 'US'
currency	string	ISO currency for prices, default the store currency
min_data_gb	number	Minimum data in GB (applies to fixed-data plans; unlimited always qualifies)

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "country"
  ],
  "properties": {
    "days": {
      "type": "integer",
      "maximum": 365,
      "minimum": 1,
      "description": "Trip length in days. When given, plans are ranked by total trip cost."
    },
    "limit": {
      "type": "integer",
      "maximum": 3,
      "minimum": 1,
      "description": "How many options to return, default 3"
    },
    "country": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "ISO 3166-1 alpha-2 country code of the destination, e.g. 'JP', 'US'"
    },
    "currency": {
      "type": "string",
      "maxLength": 3,
      "minLength": 3,
      "description": "ISO currency for prices, default the store currency"
    },
    "min_data_gb": {
      "type": "number",
      "description": "Minimum data in GB (applies to fixed-data plans; unlimited always qualifies)",
      "exclusiveMinimum": 0
    }
  }
}

get_order_status

Look up an eSIM order and return its status plus the SIM install details: install link, LPA activation code, QR image URL, and ICCID. Use for "where is my eSIM", "resend my QR code", or "did my order go through" when an order number is known. Signed-in customers can look up their own orders by number without an email. Otherwise, a short order number MUST be paired with the email used for the order — the eSIM install details are only returned to the buyer.

read-only

Argument	Type	Description
email	string	Email used for the order. Required when 'order' is a short order number and the customer is not signed in.
order*	string	Order number (e.g. '32') or Medusa order id (order_01K...) from the confirmation email

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "order"
  ],
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "pattern": "^(?!\\.)(?!.*\\.\\.)([A-Za-z0-9_'+\\-\\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
      "description": "Email used for the order. Required when 'order' is a short order number and the customer is not signed in."
    },
    "order": {
      "type": "string",
      "description": "Order number (e.g. '32') or Medusa order id (order_01K...) from the confirmation email"
    }
  }
}

get_plan_details

Get everything about one eSIM data plan: which countries the SIM roams in, data volume, validity in days, speed and fair-use throttling, and price. Use after search_esim_plans or find_cheapest_plan when the traveller asks what exactly a plan includes before buying.

read-only

Argument	Type	Description
currency	string	ISO currency, default USD
variant_id*	string	Variant id from search_esim_plans

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "variant_id"
  ],
  "properties": {
    "currency": {
      "type": "string",
      "maxLength": 3,
      "minLength": 3,
      "description": "ISO currency, default USD"
    },
    "variant_id": {
      "type": "string",
      "description": "Variant id from search_esim_plans"
    }
  }
}

list_esim_topups

List the data top-up (recharge / refill) packages that can be added to an eSIM the customer already owns. Use when the traveller ran out of mobile data or wants more days on a SIM they already bought — topping up reuses the installed SIM, so no new QR code is needed. Pass the ICCID from my_esims. Returns package_code values to pass to topup_esim.

read-only

Argument	Type	Description
iccid*	string	ICCID of the eSIM, from my_esims

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "iccid"
  ],
  "properties": {
    "iccid": {
      "type": "string",
      "description": "ICCID of the eSIM, from my_esims"
    }
  }
}

my_esims

List the SIM cards (eSIMs) already on the signed-in Hungry eSIM account: ICCID, status, data package, expiry, and install link. Use for "my eSIM", "my SIM card", "how much data do I have left", or before topping up a SIM the traveller already owns. Requires connecting the Hungry eSIM account (OAuth) — no API key.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

my_orders

List the signed-in customer's recent eSIM purchases with payment and provisioning status. Use for "what did I buy" or "did my order go through" when no order number is at hand. For the install QR and activation code of one order, use get_order_status.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

search_esim_plans

Search prepaid travel eSIM data plans for a destination — the SIM card / mobile data / roaming option for a trip. Use this first for any "data plan for my trip to X" request. Includes unlimited plans where the traveller picks the number of days, and fixed-data plans. Filter by unlimited vs fixed-data, minimum data, and validity. Unlimited plans are quoted per day, fixed-data plans as a one-off total — never compare those two numbers directly. The unlimited total is the per-day price × days, with a volume discount from 7 days, so pass days (trip length) to get that total quoted alongside the daily rate. Price differences between similar plans come from the routing IP country (routing_ip_country) and the supported networks (speed) — quote both when comparing plans. Results are grouped: fixed-data plans first, then unlimited; each group sorted by price. Returns variant_id values to pass to create_checkout.

read-only

Argument	Type	Description
days	integer	Trip length in days (1-90; each unlimited plan states its own maximum). When given, unlimited plans also quote the total for that many days.
limit	integer	Max results, default 10
country*	string	ISO 3166-1 alpha-2 country code, e.g. 'JP', 'US'
currency	string	ISO currency for prices, default USD
unlimited	boolean	If set, return only unlimited (true) or only fixed-data (false) plans

topup_esim

Recharge an eSIM the customer already owns with more data: builds a cart and returns a checkout URL to pay by credit card on hungry-esim.com. The installed SIM keeps working — no new QR code is issued. Use this instead of create_checkout when the traveller already has one of our eSIMs. Does NOT charge — the user completes payment on the website. Get iccid from my_esims and package_code from list_esim_topups.

Argument	Type	Description
iccid*	string	ICCID of the eSIM to top up, from my_esims
country	string	Customer's CHECKOUT country (ISO alpha-2) — sets checkout region/currency and URL locale. Defaults to US.
package_code*	string	Top-up package code from list_esim_topups

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "iccid",
    "package_code"
  ],
  "properties": {
    "iccid": {
      "type": "string",
      "description": "ICCID of the eSIM to top up, from my_esims"
    },
    "country": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "Customer's CHECKOUT country (ISO alpha-2) — sets checkout region/currency and URL locale. Defaults to US."
    },
    "package_code": {
      "type": "string",
      "description": "Top-up package code from list_esim_topups"
    }
  }
}