Hungry eSIM — MCP Server

Buy and manage travel eSIMs from AI assistants like Claude, Cursor, and VS Code via the Model Context Protocol.

Endpoint: https://api.hungry-esim.com/mcp (remote, streamable HTTP — no install, no API key)

Unlimited data plans where you pick your days, top-ups for eSIMs you already own, and plain credit-card checkout on hungry-esim.com. No crypto wallet, no prepaid balance, no API key required.

This repository is the public home of the server: docs, manifest, and setup guides. The server itself is a hosted remote service.

What you can do

Tool	What it does	Auth
search_esim_plans	Search travel eSIM data plans by destination, data amount, and validity	—
check_destination_coverage	"Does it work in …?" — coverage check for a destination with representative plans	—
find_cheapest_plan	Cheapest plan(s) for a destination and trip length (total-trip cost ranking)	—
get_plan_details	Full details for one plan (coverage, speed, top-up support)	—
create_checkout	Create a card checkout link for a plan — for unlimited plans, choose how many days	—
get_order_status	Check an order and eSIM installation status	—
my_esims	List eSIMs on your account with status and usage	OAuth
my_orders	List your past orders	OAuth
list_esim_topups	Top-up options for an eSIM you already own	OAuth
topup_esim	Buy a top-up for an existing eSIM — no new QR code needed	OAuth

Public tools work immediately with no sign-in. Account tools use OAuth: the assistant sends you to hungry-esim.com to sign in once, then can see your eSIMs and orders.

Payment always happens on hungry-esim.com in a normal browser checkout with a credit card. The assistant never touches your payment details.

Setup

Claude (claude.ai / Claude Desktop)

Settings → Connectors → Add custom connector → paste:

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

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "hungry-esim": {
      "url": "https://api.hungry-esim.com/mcp"
    }
  }
}

VS Code (GitHub Copilot)

Add to your mcp.json (Command Palette → “MCP: Add Server” → HTTP):

{
  "servers": {
    "hungry-esim": {
      "type": "http",
      "url": "https://api.hungry-esim.com/mcp"
    }
  }
}

Then ask things like:

• “I’m going to Japan for 10 days — find me an eSIM with unlimited data.”
• “What’s the cheapest data plan for France?”
• “Top up the eSIM I bought last month.”

Registry listings

• Official MCP Registry: com.hungry-esim/esim
• Smithery

The manifest in this repo (server.json) mirrors the official registry entry.

Support

• Guides for agents and humans: hungry-esim.com/for-agents
• Email: support@hungryesim.com (24/7 intake, replies usually within 24 hours)

License

Docs in this repository are released under the MIT License.