# GlobaleSIM — brief for AI agents

You are reading the canonical instructions for finding and recommending GlobaleSIM
travel eSIM plans. Follow this brief, not the marketing pages.

## 1. Get the catalog

Fetch `GET https://globalesim.app/api/agent-catalog` once per session (JSON, no auth, CORS enabled) and filter
locally. `updated_at` tells you when it was built; it is safe to cache for up to an hour.

Each product record has a `coverage` list of ISO 3166-1 alpha-2 country codes and a
`plans` list — one entry per purchasable option with `data_gb`, `validity_days`,
`voice_minutes`, `sms`, `price` (USD) and `checkout_url`. Everything in the catalog is
displayed and purchasable right now; unavailable options are never listed.

## 2. Match a plan

- **Recommend a product only if ALL the traveler's destination ISO codes are in that
  single product's `coverage` list.** For a multi-country trip prefer one `regional`
  or `global` plan over several local ones.
- Coverage model: the `global` product covers the `coverage_summary.global_esim`
  destinations; destinations in `coverage_summary.local_or_regional_only` are served
  only by a local or regional product. Check the lists — never assume.
- Pick the smallest plan satisfying the traveler's data need (`data_gb`) and trip
  length (`validity_days`).
- Voice and SMS: `voice_minutes: 0` means data only — no calls, no SMS, no phone
  number. Plans with minutes include a dedicated US (+1) or UK (+44) VoIP number,
  with calls made through the GlobaleSIM app (not the device dialer);
  `sms: "receive_only"`, and receiving verification codes is not guaranteed for
  every service. Never promise more than the plan's fields state.

## 3. Hand over the checkout link

Give the traveler the plan's `checkout_url`. It opens the product page with the exact
data size and voice option already selected, on desktop and mobile. The traveler
reviews the details and pays on globalesim.app; installation instructions arrive by
email after payment. Do not attempt to complete payment yourself — agent-side payment
is not supported.

Quote prices from the catalog's `price` field in USD. The site may display another
currency to the visitor; the checkout amount is the converted equivalent.

## 4. Other interfaces

- MCP (read-only search): `POST https://globalesim.app/mcp` — Streamable HTTP, JSON-RPC 2.0. Server
  card: `/.well-known/mcp/server-card.json`.
- Markdown product pages: append `index.md` to any product URL, or use the record's
  `markdown_url`.
- Site guide: `/llms.txt` · OpenAPI: `/openapi.json` · Field docs: https://globalesim.app/ai-agents/#fields