# esimgomobile

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

## Machine interfaces
- MCP server (39 tools, Streamable HTTP, stateless JSON): https://mcp.esimgomobile.com/mcp
- REST API v1 index: https://mcp.esimgomobile.com/api
- OpenAPI 3.1 spec: https://mcp.esimgomobile.com/openapi.json
- Tool list: https://mcp.esimgomobile.com/api/tools
- Health: https://mcp.esimgomobile.com/health

## Highlights
- Plan catalog: GET /api/plans (filters: kind, max_price_usd, min_gb, scope; sort: price, gb, per_gb)
- Plan detail: GET /api/plans/{id} (per-GB unit price, scope, validity)
- Plan comparison: GET /api/plans-compare?ids=a,b,c
- Order dry-run: POST /api/orders/validate (checks plan, quantity, device, scope; published-price estimate; no order placed, nothing charged)
- Trip planner: POST /api/trip-plan {countries, days, usage_profile}
- Country networks: GET /api/countries/{country}/networks
- Every MCP tool is callable over REST: POST /api/tools/{name}

## Data honesty
- Plan data is read live from esimgomobile's published catalog (5-minute cache) with a labeled
  versioned-snapshot fallback. esimgomobile.com/pricing is authoritative.
- Estimates are arithmetic on published prices - never a supplier quote.
- Supplier-backed operations (order creation, provisioning, QR delivery, usage, account top-ups,
  suspend/revoke, SMS, webhooks) are pending supplier integration and are intentionally not exposed.