esimfly

Official MCP server for the eSIMfly Business API.

От сообществаРаботаетБез входаГлобальныйБесплатноТолько чтение

Что умеет

  • Search Packages: 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
  • Get Balance: Current prepaid balance (or enterprise balance) and currency.
  • List Esims: eSIMs on the account with status, data left and validity. Search by ICCID, package name or code; filter by status.

Какие данные видит

Нужен ли аккаунт

Не нужен: сервер работает без входа

Official MCP server for the eSIMfly Business API. Lets Claude, ChatGPT, Cursor and other AI agents search eSIM plans, order eSIMs, check usage and manage webhooks. Hosted (OAuth) at mcp.esimfly.net/mcp or local via npx @esimfly/mcp.

Website field:

https://esimfly.net/esim-api

Topics to add in the same panel:

mcp, mcp-server, model-context-protocol, esim, esim-api, ai-agents, claude, chatgpt, travel, telecom, typescript

Как подключить

Как подключить esimfly к Claude

Адрес сервера, который нужно вставить в настройках Claude:

https://esimfly--akam19901205.run.tools

  1. Откройте Claude (сайт claude.ai или приложение для компьютера).
  2. Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
  3. Нажмите Добавить пользовательский коннектор (Add custom connector).
  4. Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
  5. В чате нажмите + → Коннекторы и включите новый коннектор.

Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.

Авторизация

После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.

Как подключить esimfly к ChatGPT

Адрес сервера, который нужно вставить в настройках ChatGPT:

https://esimfly--akam19901205.run.tools

  1. Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
  2. Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
  3. Откройте Настройки → Коннекторы и нажмите Создать (Create).
  4. Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
  5. В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
  6. В новом чате откройте + → Приложения/Коннекторы и включите коннектор.

Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.

Авторизация

При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.

Как подключить esimfly к Cursor

Адрес сервера, который нужно вставить в настройках Cursor:

https://esimfly--akam19901205.run.tools

Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.

Вручную:

  1. В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
  2. Вставьте JSON, скопированный ниже, в открывшийся файл ~/.cursor/mcp.json (для одного проекта: .cursor/mcp.json в корне проекта).
  3. Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.

Авторизация

Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.

Список инструментов сервера (18)

Технические названия из tools/list. Нужны только разработчикам.

search_packagesFind 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.
get_balanceCurrent prepaid balance (or enterprise balance) and currency.
list_esimseSIMs on the account with status, data left and validity. Search by ICCID, package name or code; filter by status.
get_esim_usageStored data usage and validity for one eSIM (cheap; fresh as of the last sync). Identify by ICCID or order reference.
get_esim_live_statusLIVE 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.
get_network_eventsAttach 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).
get_usage_reportDaily data usage for one eSIM over the last N days (default 7, max 90) with per-country and per-operator breakdown.
list_ordersOrder history with filters (status, date range ISO 8601, search by reference / package) and a revenue summary.
get_orderOne order by reference, including its eSIM (ICCID, install links, pending state).
get_topup_packagesTop-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.
get_webhook_settingsConfigured webhook URL, subscribed events, available events and the last deliveries.
create_orderBuy 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.
topup_esimAdd a package to an existing eSIM. Two-step: without confirm returns the package name, cost and current balance; with confirm: true executes.
cancel_esimCancel 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.
suspend_esimBlock network access for an eSIMfly-network eSIM (reversible with activate_esim). Two-step: confirm: true to execute.
activate_esimRestore network access after suspend_esim. Two-step: confirm: true to execute.
send_smsSend a text (max 500 characters) to the device holding the eSIM. Two-step: confirm: true to send.
set_webhookConfigure (or rotate) the webhook URL and subscribed events. The response contains the signing secret — shown once. Two-step: confirm: true to apply.