Skip to main content
Glama
Sign In

esimfly-mcp

by io.github.eSimfly-Official
OverviewDiscussionsAdmin

Server Details

eSIMfly Business API: search eSIM plans, check usage, diagnose eSIMs, optionally order (confirmed)

Ownership verified
Status
Healthy
Uptime
100.0% over the last 24 hours
OAuth
Works in Glama
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
eSimfly-Official/esimfly-mcp
GitHub Stars
0
Server Listing
esimfly-mcp
ChatGPT
–
Claude
–

TDQS

A3.9/5.0

Scored across 18 tools

Disambiguation4/5

Most tools target distinct resources and actions, but the four usage/status tools (get_esim_live_status, get_esim_usage, get_network_events, get_usage_report) have overlapping surface areas. Their descriptions do enough to differentiate them, so confusion is possible but unlikely.

Naming Consistency5/5

All tool names follow a consistent snake_case verb_noun pattern with clear actions like get_, list_, create_, set_, and send_. The only minor deviation is get_webhook_settings versus set_webhook, but the pattern remains predictable and readable.

Tool Count4/5

At 18 tools, the server is slightly above the ideal compact range, but the eSIM reseller domain has genuinely distinct operations: orders, eSIM lifecycle, diagnostics, usage reporting, SMS, top-ups, and webhooks. Each tool appears to serve a real purpose, so the count is reasonable rather than excessive.

Completeness5/5

The tool surface covers the full customer-facing lifecycle: discovering packages, ordering, listing orders and eSIMs, managing eSIM state, monitoring usage and network issues, topping up, sending SMS, and configuring webhooks. No obvious dead ends or missing critical operations are apparent.

Publisher details

Operator
eSIMfly · Publisher source
Operator website
https://esimfly.net
Vendor relationship
First-party · Publisher source
Documentation
https://docs.esimfly.net/docs/mcp-server
Trust center
Not available
Restrictions
Requires a free eSIMfly business account (sign up at https://esimfly.net/esim-api). Standard OAuth 2.1 with dynamic client registration, no custom OAuth app needed. Read access by default; ordering and top-ups are opt-in on the consent screen and use the account's prepaid balance. No regional limits. Usage counts against the account's normal API rate limits. Requires a free eSIMfly business account (sign up at https://esimfly.net/esim-api). Standard OAuth 2.1 with dynamic client registration, no custom OAuth app needed. Read access by default; ordering and top-ups are opt-in on the consent screen and use the account's prepaid balance. No regional limits. Usage counts against the account's normal API rate limits.

Available Tools

18 tools
activate_esimRe-activate a suspended eSIMAInspect

Restore network access after suspend_esim. Two-step: confirm: true to execute.

Inputs: iccid (required), confirm.

cancel_esimCancel an unused eSIM (refund to balance)A
DestructiveIdempotent
Inspect

Cancel an eSIM that has never been installed / activated and refund it to the balance. Cancels EVERY eligible eSIM in the same order. Two-step: confirm: true to execute.

Inputs: iccid (required), confirm.

create_orderCreate eSIM order (spends balance)AInspect

Buy one or more eSIMs of a package from the account balance. Two-step: first call returns a preview with the current balance and a generated idempotency_key; call again with confirm: true AND that idempotency_key to execute. Tell the user the cost before confirming.

Inputs: package_code (required), confirm, quantity, idempotency_key.

get_balanceGet account balanceA
Read-onlyIdempotent
Inspect

Current prepaid balance (or enterprise balance) and currency.

Inputs: no named parameters.

get_esim_live_statusGet live eSIM status (network query)A
Read-onlyIdempotent
Inspect

LIVE status straight from the mobile network: lifecycle status, profile install state, last network (operator, country, MCC/MNC, 4G/5G), device model and IMEI, activation and last-usage dates, data used. Expensive — use for diagnosis ("no data", "is it installed?"), not routinely.

Inputs: iccid (required).

get_esim_usageGet eSIM usageA
Read-onlyIdempotent
Inspect

Stored data usage and validity for one eSIM (cheap; fresh as of the last sync). Identify by ICCID or order reference.

Inputs: iccid, order_reference.

get_network_eventsGet network events (last 7 days)A
Read-onlyIdempotent
Inspect

Attach and data-session events for one eSIM, newest first, each flagged is_allowed. wrong_network_count > 0 means the device latched onto a network outside the plan — the usual cause of "connected but no data" (fix: airplane-mode toggle or manual network selection).

Inputs: iccid (required).

get_orderGet orderA
Read-onlyIdempotent
Inspect

One order by reference, including its eSIM (ICCID, install links, pending state).

Inputs: order_reference (required).

get_topup_packagesGet top-up packages for an eSIMB
Read-onlyIdempotent
Inspect

Top-up options for ONE eSIM (they depend on its provider and location), with your price. Returns ESIM_NOT_TOPPABLE when the eSIM state does not allow top-ups.

Inputs: iccid (required), limit.

get_usage_reportGet daily usage reportA
Read-onlyIdempotent
Inspect

Daily data usage for one eSIM over the last N days (default 7, max 90) with per-country and per-operator breakdown.

Inputs: iccid (required), days.

get_webhook_settingsGet webhook settingsB
Read-onlyIdempotent
Inspect

Configured webhook URL, subscribed events, available events and the last deliveries.

Inputs: no named parameters.

list_esimsList eSIMsB
Read-onlyIdempotent
Inspect

eSIMs on the account with status, data left and validity. Search by ICCID, package name or code; filter by status.

Inputs: page, limit, search, status.

list_ordersList ordersB
Read-onlyIdempotent
Inspect

Order history with filters (status, date range ISO 8601, search by reference / package) and a revenue summary.

Inputs: page, limit, search, status, +2 more.

search_packagesSearch eSIM packagesA
Read-onlyIdempotent
Inspect

Find eSIM data packages you can sell, with your wholesale price. Filter by destination name (search), type (local / regional / global) and page. Returns compact rows; use limit up to 100.

Inputs: page, type, limit, search.

send_smsSend an SMS to an eSIMAInspect

Send a text (max 500 characters) to the device holding the eSIM. Two-step: confirm: true to send.

Inputs: iccid (required), message (required), confirm.

set_webhookSet webhook URL and eventsAInspect

Configure (or rotate) the webhook URL and subscribed events. The response contains the signing secret — shown once. Two-step: confirm: true to apply.

Inputs: webhook_url (required), events, confirm.

suspend_esimSuspend an eSIM (block network access)A
DestructiveIdempotent
Inspect

Block network access for an eSIMfly-network eSIM (reversible with activate_esim). Two-step: confirm: true to execute.

Inputs: iccid (required), confirm.

topup_esimTop up an eSIM (spends balance)AInspect

Add a package to an existing eSIM. Two-step: without confirm returns the package name, cost and current balance; with confirm: true executes.

Inputs: iccid (required), package_code (required), confirm.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    Try in Browser
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources