Hungry eSIM MCP Server

Hungry eSIM speaks the Model Context Protocol. Connect an AI assistant and it can search data plans for any destination, build a cart and hand you a checkout link — in one conversation.

Endpoint

How to connect

1. Open your assistant's connector settings (Claude or ChatGPT).
2. Add a custom connector and paste the endpoint above.
3. Ask for what you need — for example, "find me a 7-day eSIM for Japan".

No installation and no API key. The server is read-only apart from creating a cart. Step-by-step setup for Claude, Cursor and VS Code.

Buying in a chat

Once connected, a traveler just asks — no sign-in needed to buy:

1. Ask — e.g. "find me a 5-day eSIM for Japan". The assistant lists plans with prices.
2. Get a checkout link — pick one and the assistant returns a link. It never charges the card.
3. Pay on the web — you finish payment on hungry-esim.com; the eSIM QR is emailed and you get an order number.
4. Get the QR back in chat — say "check order 32" and the assistant fetches the QR and install link.

Account features (your eSIMs and top-ups) trigger a one-time sign-in the first time they're used.

Tools

Available to anyone, no sign-in:

• search_esim_plans — Find eSIM data plans for a destination — filter by unlimited vs fixed data, minimum data and validity.
• check_destination_coverage — Whether a destination is covered at all, plus the cheapest unlimited and fixed-data plan as examples.
• find_cheapest_plan — The lowest-priced plan for a destination — ranked by total trip cost when the trip length is known.
• get_plan_details — Coverage, data volume, validity, throttle policy and price for a single plan.
• create_checkout — Build a cart for the chosen plan and return a checkout link. A connected account gets the order; otherwise it is a guest cart. It never charges the card.
• get_order_status — Provisioning status plus the issued eSIM: QR code, LPA activation code and ICCID.

Need your Hungry eSIM account — the assistant walks you through a one-time sign-in the first time it calls one of these:

• my_esims — The eSIMs on your account: ICCID, status, data package, expiry and install link.
• my_orders — Your recent orders with payment and eSIM provisioning status.
• list_esim_topups — The data top-up packages available for one of your eSIMs, by ICCID.
• topup_esim — Build a cart for a top-up on one of your eSIMs and return a checkout link. Like create_checkout, it never charges the card.

How payment works

The assistant never sees or handles your card. It builds the cart and gives you a link; you complete payment on hungry-esim.com. Once the order is placed your eSIM QR code is emailed to you, and the assistant can fetch it again with get_order_status.