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.