Be the first to get access to new connectors. Get early access →
ConnectorBay Early access

ESIM Go (BYOK) — connector documentation

  • MCP endpoint: https://byok-esim-go.connectorbay.com/mcp
  • REST API: POST https://byok-esim-go.connectorbay.com/v1/tools/{tool_name}, described by the OpenAPI 3.1 spec at https://byok-esim-go.connectorbay.com/openapi.json
  • Transport: Streamable HTTP, stateless, MCP specification 2025-06-18 or later
  • Authentication: your own ESIM Go eSIM Go API key, sent in the X-Upstream-Key header of every request (never stored, logged or cached)
  • Health: https://byok-esim-go.connectorbay.com/health · Tool schemas: https://byok-esim-go.connectorbay.com/tools.json
  • Publisher: Unify Dynamics LLC · connectorbay.com/byok-esim-go · agent@connectorbay.com

What ESIM Go (BYOK) is for

ESIM Go (BYOK) lets an AI assistant read your own ESIM Go data through the ESIM Go API with a key you supply (eSIM Go API key). Read-only: 11 tools (get_organisation, list_bundle_groups, list_catalogue, get_catalogue_bundle, list_esims, get_esim, list_esim_bundles, get_esim_history, get_bundle_inventory, list_networks, get_order). The BYOK key travels with each request, is used for that one call only and is never stored, logged or cached; it is only ever sent to api.esim-go.com. Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by ESIM Go. ESIM Go and its logos are trademarks of their owners and are used only to say which service the connector works with.

Ask your assistant things like:

  • "How much prepaid balance does my eSIM Go account have left?"
  • "Which eSIM Go bundle groups are available to my account?"
  • "Which eSIM Go bundles cover Japan?"
  • "Which networks does the bundle esim_1GB_7D_IM_U use?"
  • "Which of my eSIMs are suspended?"
  • "Has the eSIM with ICCID 8944123456789012000 been installed yet?"

What it does

  • get_organisation: Show your eSIM Go organisation: name, currency, prepaid balance (which includes any test credit), test credit and its expiry, and bundle groups.
  • list_bundle_groups: List the bundle groups your organisation can order from, with description and the URL of each group's price list.
  • list_catalogue: List bundles your organisation can order, with data amount, duration, speed and price. The vendor asks that the catalogue be fetched only when needed and kept for reuse rather than polled.
  • get_catalogue_bundle: Get one catalogue bundle by its case-sensitive name, with the countries it covers and the mobile networks in each (name, TADIG, MCC-MNC, speeds).
  • list_esims: List the eSIMs assigned to your organisation with ICCID, your reference, last action, state (active, suspended, deactivated) and assignment date.
  • get_esim: Get one eSIM's install status (Released, Installed, Downloaded, Unavailable or Deactivated), first install time, your reference and branding. PIN and PUK are not returned by this tool.
  • list_esim_bundles: List the bundles applied to one eSIM with their data, voice and SMS allowances, remaining amounts, start and end times.
  • get_esim_history: List the lifecycle events of one eSIM (bundle applied, revoked and similar) with bundle name and time.
  • get_bundle_inventory: List the bundles your organisation has bought but not yet applied, with remaining counts, expiry, countries and allowances.
  • list_networks: List mobile networks per country (name, brand, MCC, MNC, TADIG, speeds). Set return_all or give countries or ISO codes.
  • get_order: Get one order by its reference: status, total, currency, creation time and whether the bundle was assigned.

BYOK key

You bring your own ESIM Go eSIM Go API key (https://docs.esim-go.com/guides/authentication/). Your assistant sends it in the X-Upstream-Key header with each request. ConnectorBay uses it for that one call only: it is never stored, logged or cached, never shown in an answer, and it is only sent to api.esim-go.com over https, with no redirects followed. Create a key with the fewest permissions the tools need (read-only if the provider offers it), and revoke it at the provider whenever you like.

Data sources

Live from the ESIM Go API (api.esim-go.com) with a BYOK key; documentation: https://docs.esim-go.com/api/v2_5/. Endpoints checked against that documentation on 2026-10-16.

What it is not

Unofficial connector by Unify Dynamics LLC: not affiliated with, endorsed by or sponsored by ESIM Go. ESIM Go and its logos are trademarks of their owners and are used only to say which service the connector works with. It is read-only: it never creates, changes, sends or deletes anything in your ESIM Go account.

Built for: Worldwide. Languages: English.