Search / com.esimker/esim
esimker eSIM store
R0· no sign-inPrepaid travel data eSIMs: checkout links for people, autonomous purchases from a prepaid wallet.
v1.0.0 · active · website · descriptor JSON · versions
Search / com.esimker/esim
R0· no sign-inPrepaid travel data eSIMs: checkout links for people, autonomous purchases from a prepaid wallet.
v1.0.0 · active · website · descriptor JSON · versions
{
"mcpServers": {
"esim": {
"type": "http",
"url": "https://esimker.com/api/mcp",
"headers": {
"Authorization": "Bearer ${ESIM_TOKEN}"
}
}
}
}claude mcp add --transport http esim https://esimker.com/api/mcp --header "Authorization: Bearer ${ESIM_TOKEN}"[mcp_servers.esim]
url = "https://esimker.com/api/mcp"
bearer_token_env_var = "ESIM_TOKEN"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"esim": {
"type": "remote",
"url": "https://esimker.com/api/mcp",
"enabled": true,
"headers": {
"Authorization": "Bearer {env:ESIM_TOKEN}"
}
}
}
}{
"mcpServers": {
"esim": {
"type": "http",
"url": "https://esimker.com/api/mcp",
"headers": {
"Authorization": "Bearer ${ESIM_TOKEN}"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=esim&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vZXNpbWtlci5jb20vYXBpL21jcCIsImhlYWRlcnMiOnsiQXV0aG9yaXphdGlvbiI6IkJlYXJlciAke0VTSU1fVE9LRU59In19"
}{
"servers": {
"esim": {
"type": "http",
"url": "https://esimker.com/api/mcp",
"headers": {
"Authorization": "Bearer ${ESIM_TOKEN}"
}
}
}
}{
"mcpServers": {
"esim": {
"httpUrl": "https://esimker.com/api/mcp",
"headers": {
"Authorization": "Bearer ${ESIM_TOKEN}"
}
}
}
}extensions:
"esim":
enabled: true
name: "esim"
type: streamable_http
uri: "https://esimker.com/api/mcp"
headers:
"Authorization": "Bearer ${ESIM_TOKEN}"
timeout: 300
Placeholders to fill from your own secret store: ${ESIM_TOKEN}. The registry never accepts secret values.
protocol.modernsupports 2026-07-28 (server/discover)protocol.statelessanswers without a sessionprotocol.transportstreamable HTTPprotocol.list_ttltools/list declares ttlMs 0, so clients re-fetch it on every useauth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptionsevery tool has a descriptiontools.description_lengthdescriptions are concisetools.schemasevery tool has an object input schematools.annotations12 of 12 tools declare readOnlyHint or destructiveHinttools.directory_hints4 of 12 tools declare all four hints; missing: get_usage (destructiveHint); get_plans (destructiveHint); get_order (destructiveHint); …tools.token_costabout 2,248 tokens to load every tooltools.api_dumptools are not a one-to-one API dumpstability.changes2 tool changes in 30 daysstability.rug_pullno tool changed its meaning under the same namedeps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI packageget_depositchangeddescriptionOne deposit of the wallet by its token: status pending → paid (credited, bonus included) | underpaid (nothing credited yet, the rest can still arrive) | expired. Poll every ~30 s after sending; crypto needs the network's confirmations. Needs the wallet code.
One deposit of the wallet by its token: status pending → paid (credited, bonus included) | underpaid (nothing credited yet, the rest can still arrive) | payment_held (the payment processor's compliance check stopped the payment and holds it: nothing is credited, do not pay again, the person should write to support) | expired. Poll every ~30 s after sending; crypto needs the network's confirmations. Needs the wallet code.
get_orderchangeddescriptionAn order by its token. status goes pending (unpaid) → paid → provisioning → ready; also expired, underpaid, failed_provisioning, gift_waiting. When ready, esim.activation_code is the LPA string (render it as a QR code), with iccid, smdp and matching_id. After payment poll every ~10 s; delivery usually takes under a minute.
An order by its token. status goes pending (unpaid) → paid → provisioning → ready; also expired, underpaid, failed_provisioning, gift_waiting, and payment_held — the payment processor's compliance check stopped the payment and holds the money: nothing is issued, the person must not pay again and should write to support. When ready, esim.activation_code is the LPA string (render it as a QR code), with iccid, smdp and matching_id. After payment poll every ~10 s; delivery usually takes under a minute.
Full history: list_changes · trend: quality JSON.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+dns-namespace +website +reachable +uptime-95% ~updated-45d-ago -no-repository
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
| remote | auth | reachable | uptime 30d | p50 | protocol | last ok |
|---|---|---|---|---|---|---|
https://esimker.com/api/mcp streamable-http | none | yes | 95% | 513 ms | 2026-07-28 | 2026-10-19 |
create_checkout | Create an order for a person to pay. Returns token, checkout_url (the gateway's page: hand it to the person) and order_url (the order page in `lang`, with the QR code once paid: show it to the buyer only, the token is a secret). Confirm the plan and the price first: every call creates a new unpaid order, so do not retry while a checkout is open. `email` (optional) also gets the eSIM by mail. `period_num` (1–365) only for daily_unlimited plans. `topup_iccid` with a plan_id from list_topups tops up an existing eSIM. A 403 means the caller's jurisdiction is embargoed. To pay from a wallet use purchase_esim. |
create_deposit | Open a top-up of the wallet and get what is needed to pay it. Floors: $10 for a wallet's first deposit, $1 after that; cap $1000 per deposit. Crypto deposits earn a bonus (+2% from $25, +3% from $50, +5% from $100, capped at $25); every purchase returns 3% cashback. With payment_method "crypto" pass a currency from: BTC, ETH, TRX, USDTTRC, USDTETH, USDTBSC — the answer then carries `pay`: the address, the exact amount in the coin (network fee included) and expires_at (about 15 minutes; after that open a new deposit). Send exactly `pay.amount` to `pay.address` on `pay.network`, then poll get_deposit(token) until status is paid. checkout_url is the hosted pay page for a person; card deposits have only that. Needs the wallet code. |
create_wallet | Mint a prepaid wallet with no account behind it and get its secret ONCE: `code` (32 hex characters) and the same secret as a 12-word `phrase`. Save the code before doing anything else and send it as `Authorization: Bearer <code>` on every wallet call; there is no recovery and no identity to prove. The balance is spent on eSIMs (retail price, cashback on every purchase) and never paid back out. accept_terms must be true (https://esimker.com/terms). Then create_deposit to fund it. Rate-limited and geo-blocked like checkout. |
get_depositread-only | One deposit of the wallet by its token: status pending → paid (credited, bonus included) | underpaid (nothing credited yet, the rest can still arrive) | payment_held (the payment processor's compliance check stopped the payment and holds it: nothing is credited, do not pay again, the person should write to support) | expired. Poll every ~30 s after sending; crypto needs the network's confirmations. Needs the wallet code. |
get_orderread-only | An order by its token. status goes pending (unpaid) → paid → provisioning → ready; also expired, underpaid, failed_provisioning, gift_waiting, and payment_held — the payment processor's compliance check stopped the payment and holds the money: nothing is issued, the person must not pay again and should write to support. When ready, esim.activation_code is the LPA string (render it as a QR code), with iccid, smdp and matching_id. After payment poll every ~10 s; delivery usually takes under a minute. |
get_payment_methodsread-only | Checkout methods open right now: "crypto" (a hosted invoice: BTC, ETH, TRX, USDT), "card", and "wallet" (a prepaid balance, see create_wallet). `gateways` names the providers behind each method; a checkout that does not ask for one by name goes to the first, which is what these tools do. |
get_plansread-only | The plans of one destination (slug from search_destinations). Each plan: id (the plan_id for an order), name, gb, days, retail (USD; per day when daily_unlimited is true), daily_unlimited, location_codes (the countries it covers), networks, speed, supports_topup. Also the published rating. |
get_usageread-only | Remaining data and status of an eSIM we issued. |
get_walletread-only | The wallet behind the code: ref (a public handle for support), balance_usd, cashback_percent, the deposit rules that apply to it now (min_usd, max_usd, first, bonus tiers), the last 50 transactions, orders (with their tokens — the wallet is where a buyer's order links are kept) and deposits. Needs the wallet code. |
list_topupsread-only | Top-up plans that fit an eSIM we issued: plan_id, name, gb, days, retail. Order one with create_checkout(plan_id, topup_iccid=iccid) or, from a wallet, purchase_esim(plan_id, client_ref, topup_iccid=iccid). |
purchase_esim | Charge the wallet and issue an eSIM, no checkout. `client_ref` (1–64 chars) is your own reference for this purchase and makes the call idempotent: a retry with the same value returns the existing order without a second charge, so reuse it after a timeout and never invent a new one for the same purchase. `period_num` (1–365, default 7) only for daily_unlimited plans; the charge is price × days. `topup_iccid` with a plan_id from list_topups tops up an eSIM. Returns the order (status paid) with order_url; poll get_order(token) for ready and the activation code. A 402 is a short balance: create_deposit first. A wallet pays for at most 50 orders in 24 hours (429 beyond that; a retry answered from client_ref does not count). Needs the wallet code. |
search_destinationsread-only | Destinations on sale. `query` matches the name in any of 18 languages, the slug or the ISO code; empty lists everything. Each item: dest_code, slug, name, min_retail (USD, the cheapest fixed plan), unlimited_from (USD per day of a Daily Unlimited pass, or null), plan_count. Continue with get_plans(slug). |
Schemas: list_tools.
{
"name": "com.esimker/esim",
"icons": [
{
"src": "https://esimker.com/icons/icon-192.png",
"sizes": [
"192x192"
],
"mimeType": "image/png"
},
{
"src": "https://esimker.com/icons/icon-512.png",
"sizes": [
"512x512"
],
"mimeType": "image/png"
}
],
"title": "esimker eSIM store",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"remotes": [
{
"url": "https://esimker.com/api/mcp",
"type": "streamable-http",
"headers": [
{
"name": "Authorization",
"isSecret": true,
"description": "Bearer <wallet code>: the prepaid wallet's secret from create_wallet. Only the four wallet tools (get_wallet, create_deposit, get_deposit, purchase_esim) need it; the catalogue and the checkout flow work without it."
}
]
}
],
"version": "1.0.0",
"websiteUrl": "https://esimker.com/agents",
"description": "Prepaid travel data eSIMs: checkout links for people, autonomous purchases from a prepaid wallet."
}