Skip to main content
Glama
README.md
# esimgomobile MCP Server

<img src="assets/logo.png" alt="esimgomobile" width="420">

**Travel eSIM tools, plan catalog and trip planning for agents and developers.**

- **Live MCP endpoint:** `https://mcp.esimgomobile.com/mcp` (Streamable HTTP, stateless, no API key)
- **Official MCP Registry:** `com.esimgomobile/esimgomobile`
- **REST API:** https://mcp.esimgomobile.com/api · **OpenAPI:** https://mcp.esimgomobile.com/openapi.json · **Health:** https://mcp.esimgomobile.com/health
- **Website:** https://esimgomobile.com/ · **Support:** support@esimgomobile.com
- **Privacy:** https://esimgomobile.com/privacy/ · **Terms:** https://esimgomobile.com/terms/

Plan data is read live from esimgomobile's published catalog (5-minute cache) with a labeled, versioned-snapshot fallback. [esimgomobile.com/pricing](https://esimgomobile.com/pricing) is authoritative. Read-only: order validation is a dry-run — no order is placed and nothing is charged. Supplier-backed operations (order creation, provisioning, QR delivery) are intentionally not exposed.

## Tools (36)

| Tool | Title | What it does |
|---|---|---|
| `run_speed_test` | Speed Test | Use when the user wants to measure their current internet speed. |
| `get_public_ip` | What's My IP | Use when the user asks for their public IP address. |
| `check_roaming_status` | Am I Roaming? | Use when the user wants to know whether they are currently roaming. |
| `measure_latency` | Latency to Destination | Use when the user wants the network latency to a host. |
| `grade_connection_quality` | Connection Quality | Use when the user gives you download/upload speed and ping numbers and wants a verdict. |
| `detect_captive_portal` | Captive Portal / Public Wi-Fi Detector | Use when the user is on hotel/airport/cafe Wi-Fi and suspects a login page is blocking them. |
| `check_dns_leaks` | DNS Leak Test | Use when the user wants to check whether their DNS queries leak outside their VPN. |
| `get_wifi_security_checklist` | Wi-Fi Security Checklist | Use when the user is about to use public, hotel, or airport Wi-Fi. |
| `lookup_speed_requirements` | Speed Needed For | Use when the user asks how much bandwidth an activity needs (video calls, 4K streaming, gaming). |
| `check_coverage` | Coverage Checker | Use when the user asks whether a country is covered by esimgomobile plans. |
| `estimate_data_usage` | Data Usage Estimator | Use when the user is planning a trip and asks how much mobile data they need. |
| `calculate_roaming_cost` | Roaming Cost Calculator | Use when the user wants to compare their home carrier's roaming fees against a travel eSIM. |
| `plan_multi_country_esim` | Multi-Country Guide | Use when the user has a multi-country itinerary and asks which eSIM plan type fits. |
| `check_device_compatibility` | Device Compatibility | Use when the user asks whether their phone supports eSIM. |
| `check_carrier_lock` | Carrier-Lock Check | Use when the user needs to check whether their phone is carrier-unlocked (required for travel eSIMs). |
| `find_best_network` | Best Network by City | Use when the user asks which mobile network is best in a specific city. |
| `get_airport_connectivity` | Airport Connectivity | Use when the user asks about connectivity at an airport (Wi-Fi, SIM vendors, eSIM tips). |
| `find_free_wifi` | Free Wi-Fi Finder | Use when the user asks where to find free Wi-Fi in a city. |
| `get_country_fact_sheet` | Country Connectivity Fact Sheet | Use when the user asks about mobile networks, eSIM support, or Wi-Fi in a country. |
| `check_internet_freedom` | Internet Freedom Check | Use when the user asks about internet restrictions in a country (VoIP blocks, firewalls). |
| `get_installation_guide` | Installation Guide | Use when the user needs step-by-step eSIM installation instructions. |
| `troubleshoot_esim` | Troubleshooter | Use when the user's eSIM isn't working. |
| `lookup_apn_settings` | APN Lookup | Use when the user needs APN settings for a carrier after installing an eSIM. |
| `setup_dual_sim` | Dual-SIM Helper | Use when the user runs a home line plus a travel eSIM and needs the right configuration. |
| `setup_data_saver` | Data-Saver Setup | Use when the user wants to stretch a travel data plan. |
| `format_international_number` | Dialing Helper | Use when the user needs to dial a local number internationally. |
| `calculate_data_budget` | Data Budget Calculator | Use when the user asks how much of their plan data is left or how to ration it over a trip. |
| `list_available_plans` | Available Plans | Use when the user asks what esimgomobile plans exist or what an eSIM costs. |
| `recommend_plan` | Plan Recommender | Use when the user says where they're going, for how long, and roughly how much they'll use data, and wants a concrete plan pick. |
| `get_travel_data_checklist` | Travel Data Checklist | Use when the user is preparing a trip and wants one pass over everything data-related for a country: networks, eSIM support, internet freedom, device check and install steps. |
| `search_plans` | Search Plans | Use when the user wants to browse or filter esimgomobile plans - by type (data packs, monthly, day passes), max price, minimum GB, coverage scope, or cheapest per-GB. |
| `get_plan_details` | Plan Details | Use when the user asks about one specific esimgomobile plan by id - price, data allowance, validity, coverage scope, per-GB unit price, and where to buy. |
| `compare_plans` | Compare Plans | Use when the user is choosing between 2-4 esimgomobile plans. |
| `validate_order_draft` | Validate Order (Dry Run) | Use when the user is about to buy and wants everything checked first - the eSIM Go validate-style dry run. |
| `plan_trip` | Trip Planner | Use when the user gives an itinerary (countries + days + usage) and wants the full answer in one call: estimated data need, best published plan pick with an alternative, and a per-country networks/eSIM/freedom brief. |
| `list_country_networks` | Country Networks | Use when the user asks which mobile networks operate in a country, or for eSIM support / Wi-Fi / internet-freedom facts for one country - the eSIM Go /networks parity endpoint, from esimgomobile's built-in reference. |

## Connect

### Claude Code
```bash
claude mcp add --transport http esimgomobile https://mcp.esimgomobile.com/mcp
```

### Claude Desktop / Cursor / Windsurf (`mcp.json`)
```json
{
  "mcpServers": {
    "esimgomobile": {
      "url": "https://mcp.esimgomobile.com/mcp"
    }
  }
}
```

### VS Code (`mcp.json`)
```json
{
  "servers": {
    "esimgomobile": {
      "type": "http",
      "url": "https://mcp.esimgomobile.com/mcp"
    }
  }
}
```

### Continue (`config.yaml`)
```yaml
mcpServers:
  - name: esimgomobile
    type: streamable-http
    url: https://mcp.esimgomobile.com/mcp
```

### LibreChat (`librechat.yaml`)
```yaml
mcpServers:
  esimgomobile:
    type: streamable-http
    url: https://mcp.esimgomobile.com/mcp
```

No environment variables, API keys, or accounts are required.

## Registry metadata
`server.json` in this repo is the exact file published to the Official MCP Registry as `com.esimgomobile/esimgomobile` v0.1.0 (domain-authenticated via DNS proof at esimgomobile.com).

## License
MIT — see [LICENSE](LICENSE). This repository contains listing, documentation and install configuration for the hosted esimgomobile MCP server; the server itself is operated at mcp.esimgomobile.com.