@esimfly/mcp 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,6 @@
+# Changelog
+
+## 0.1.0 — 2026-09-13
+
+Initial release: 11 read tools, 7 opt-in two-step write tools, `esimfly_integration_guide` and
+`diagnose_esim` prompts. Stdio transport, built on @esimfly/sdk.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 eSIMfly
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,134 @@
+# @esimfly/mcp — eSIMfly MCP server
+
+Give your AI assistant hands on the eSIMfly Business API. With this
+[Model Context Protocol](https://modelcontextprotocol.io) server, Claude, Cursor, ChatGPT and other
+MCP clients can search eSIM plans with your wholesale prices, check balances and usage, diagnose
+"no data" problems from live network data — and, if you enable it, place orders and top-ups with an
+explicit confirmation step.
+
+- **Read-only by default.** Nothing can spend your balance unless you opt in.
+- **Two-step writes.** Every write tool returns a preview (what, cost, balance) until called with `confirm: true`.
+- **Built on the official [`@esimfly/sdk`](https://www.npmjs.com/package/@esimfly/sdk)** — signing, retries and error codes handled.
+- Ships two prompts: the complete integration guide and an eSIM diagnosis workflow.
+
+Docs: **https://docs.esimfly.net** · Credentials: Business Dashboard → Settings → API Keys.
+
+## Install
+
+The server runs locally over stdio; your API key never leaves your machine.
+
+### Claude Desktop
+
+`claude_desktop_config.json` → `mcpServers`:
+
+```json
+{
+  "mcpServers": {
+    "esimfly": {
+      "command": "npx",
+      "args": ["-y", "@esimfly/mcp"],
+      "env": {
+        "ESIMFLY_ACCESS_CODE": "esf_...",
+        "ESIMFLY_SECRET_KEY": "sk_..."
+      }
+    }
+  }
+}
+```
+
+### Claude Code
+
+```bash
+claude mcp add esimfly -e ESIMFLY_ACCESS_CODE=esf_... -e ESIMFLY_SECRET_KEY=sk_... -- npx -y @esimfly/mcp
+```
+
+### Cursor / Windsurf / other MCP clients
+
+`.cursor/mcp.json` (or the client's equivalent):
+
+```json
+{
+  "mcpServers": {
+    "esimfly": {
+      "command": "npx",
+      "args": ["-y", "@esimfly/mcp"],
+      "env": { "ESIMFLY_ACCESS_CODE": "esf_...", "ESIMFLY_SECRET_KEY": "sk_..." }
+    }
+  }
+}
+```
+
+### Enable write tools
+
+Add `"ESIMFLY_MCP_ALLOW_WRITES": "true"` to `env`. Without it the ordering, top-up, cancel,
+suspend, SMS and webhook tools are not even registered.
+
+## Try it
+
+- "Find the cheapest 5 GB plan for Turkey and tell me my margin at €9.99."
+- "Which of my eSIMs are active and below 200 MB?"
+- "ICCID 8948010010036785060 says no data — diagnose it." *(uses the `diagnose_esim` prompt)*
+- "Set up webhooks for installed / status / low-data events at https://my.app/hooks." *(write tool, previews first)*
+- "Build me a Node.js integration." *(uses the `esimfly_integration_guide` prompt)*
+
+## Tools
+
+| Tool | What it does | Mode |
+|---|---|---|
+| `search_packages` | Catalogue search by destination / type with your cost price | read |
+| `get_balance` | Account (or enterprise) balance | read |
+| `list_esims` | Your eSIMs with status, data left, validity | read |
+| `get_esim_usage` | Stored usage for one eSIM (cheap) | read |
+| `get_esim_live_status` | Live status from the network: install state, last network, device, usage | read (expensive) |
+| `get_network_events` | Last 7 days of attach / data-session events, wrong-network flag | read |
+| `get_usage_report` | Daily usage by country and operator (up to 90 days) | read |
+| `list_orders` / `get_order` | Order history and one order with its eSIM | read |
+| `get_topup_packages` | Top-up options for one eSIM | read |
+| `get_webhook_settings` | Webhook URL, events, recent deliveries | read |
+| `create_order` | Buy eSIMs — preview → `confirm: true` + idempotency key | write |
+| `topup_esim` | Add data to an eSIM — preview shows package and cost | write |
+| `cancel_esim` | Cancel an unused eSIM and refund to balance | write (destructive) |
+| `suspend_esim` / `activate_esim` | Block / restore network access | write |
+| `send_sms` | Text the device holding the eSIM | write |
+| `set_webhook` | Configure webhook URL and events | write |
+
+Prompts: `esimfly_integration_guide` (optional `stack`), `diagnose_esim` (`iccid`).
+
+## Safety model
+
+- Read-only unless `ESIMFLY_MCP_ALLOW_WRITES=true`.
+- Write tools are two-step: a call without `confirm` returns a preview and makes no mutable API call;
+  `create_order` additionally requires the `idempotency_key` from its own preview, so an agent
+  cannot place the same order twice.
+- Tool annotations mark reads as `readOnlyHint` and cancel/suspend as `destructiveHint`, so hosts
+  that ask for user approval on risky tools do so.
+- The server never logs credentials and never writes to stdout except the MCP protocol.
+- Give the agent a dedicated API key with the smallest rate limits you are comfortable with, and
+  rotate it from the dashboard if in doubt.
+
+## Configuration
+
+| Variable | Required | Description |
+|---|---|---|
+| `ESIMFLY_ACCESS_CODE` | yes | API access code (`esf_…`) |
+| `ESIMFLY_SECRET_KEY` | yes | API secret key (`sk_…`) |
+| `ESIMFLY_MCP_ALLOW_WRITES` | no | `true` to register write tools |
+| `ESIMFLY_BASE_URL` | no | Override the API base URL |
+
+## Embedding
+
+```ts
+import { createEsimflyMcpServer } from '@esimfly/mcp';
+const server = createEsimflyMcpServer({ config: { accessCode, secretKey }, allowWrites: false });
+// connect it to any MCP transport
+```
+
+## Releasing (maintainers)
+
+Bump `version` in `package.json`, `server.json` and `MCP_VERSION` in `src/server.ts`, add a
+CHANGELOG entry, push, then publish a GitHub Release tagged `vX.Y.Z` — the workflow publishes to
+npm with Trusted Publishing (OIDC).
+
+## Support
+
+support@esimfly.net · https://docs.esimfly.net

package/SECURITY.md

@@ -0,0 +1,15 @@
+# Security
+
+## Reporting a vulnerability
+
+Email **support@esimfly.net** with the subject "MCP security". Please do not open a public issue.
+
+## Design
+
+- The server runs locally (stdio) with credentials from environment variables; they are used only by
+  the bundled `@esimfly/sdk` to sign requests and are never logged or written to stdout.
+- Read-only by default. Write tools require `ESIMFLY_MCP_ALLOW_WRITES=true` and a second call with
+  `confirm: true`; `create_order` also requires the idempotency key from its own preview.
+- Cancel and suspend are annotated `destructiveHint` so MCP hosts can require user approval.
+- Do not expose this server over the network. If you need remote access, put it behind your own
+  authenticated gateway and a dedicated, rate-limited API key.

package/dist/chunk-Q3UI3CYF.js

@@ -0,0 +1,422 @@
+// src/server.ts
+import { randomUUID } from "crypto";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { ESIMfly, ESIMflyError } from "@esimfly/sdk";
+var MCP_VERSION = "0.1.0";
+var FULL_PROMPT_URL = "https://docs.esimfly.net/llm/esimfly-api-full-prompt.txt";
+var DOCS_URL = "https://docs.esimfly.net";
+var text = (value) => ({
+  content: [{ type: "text", text: typeof value === "string" ? value : JSON.stringify(value, null, 2) }]
+});
+var failure = (err) => {
+  if (err instanceof ESIMflyError) {
+    return {
+      isError: true,
+      content: [{
+        type: "text",
+        text: JSON.stringify({ error: err.code, message: err.message, status: err.status ?? null, details: err.response ?? null }, null, 2)
+      }]
+    };
+  }
+  return { isError: true, content: [{ type: "text", text: `Unexpected error: ${err?.message ?? String(err)}` }] };
+};
+var run = async (fn) => {
+  try {
+    return await fn();
+  } catch (err) {
+    return failure(err);
+  }
+};
+var READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true };
+var WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true };
+var DESTRUCTIVE = { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true };
+var iccidArg = z.string().min(15).max(22).describe("ICCID of the eSIM (19-20 digits)");
+function compactPackage(p) {
+  return {
+    package_code: p.package_code,
+    name: p.name,
+    region: p.region,
+    type: p.type,
+    data_gb: p.data_amount_gb,
+    validity_days: p.validity_days,
+    cost: p.cost,
+    currency: p.currency,
+    is_unlimited: p.is_unlimited,
+    has_voice: p.has_voice ?? false,
+    has_sms: p.has_sms ?? false,
+    countries: p.countries ? p.countries.length > 12 ? [...p.countries.slice(0, 12), `+${p.countries.length - 12} more`] : p.countries : void 0,
+    networks: p.networks?.length ?? p.locationNetworkList?.reduce((n, l) => n + (l.operatorList?.length ?? 0), 0)
+  };
+}
+function createEsimflyMcpServer(options = {}) {
+  const client = options.client ?? new ESIMfly(options.config ?? {});
+  const allowWrites = options.allowWrites ?? false;
+  const fetchImpl = options.fetch ?? globalThis.fetch;
+  const server = new McpServer(
+    { name: "esimfly", version: MCP_VERSION },
+    {
+      instructions: [
+        "Tools for the eSIMfly Business API (wholesale eSIM data plans for 200+ countries).",
+        "Package codes are opaque strings: pass them back exactly as returned. Prices (cost) are the partner buy price in the account currency.",
+        "get_esim_usage is cheap; get_esim_live_status and get_network_events query the mobile network live \u2014 use them for diagnosis, not routinely.",
+        allowWrites ? "Write tools are enabled. Every write is two-step: call without confirm to get a preview (cost, balance), then call again with confirm: true. Never confirm on the user's behalf without telling them the cost." : "This server is read-only: ordering, top-ups, cancel, suspend, SMS and webhook changes are disabled (start with ESIMFLY_MCP_ALLOW_WRITES=true to enable).",
+        `Documentation: ${DOCS_URL}`
+      ].join("\n")
+    }
+  );
+  server.registerTool(
+    "search_packages",
+    {
+      title: "Search eSIM packages",
+      description: "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.",
+      inputSchema: {
+        search: z.string().optional().describe('Country or region name, e.g. "Turkey", "Europe"'),
+        type: z.enum(["local", "regional", "global"]).optional(),
+        page: z.number().int().min(1).optional(),
+        limit: z.number().int().min(1).max(100).optional().describe("Default 20")
+      },
+      annotations: READ
+    },
+    async ({ search, type, page, limit }) => run(async () => {
+      const res = await client.packages.list({ search, type, page, limit: limit ?? 20 });
+      return text({ pagination: res.pagination, packages: res.packages.map(compactPackage) });
+    })
+  );
+  server.registerTool(
+    "get_balance",
+    { title: "Get account balance", description: "Current prepaid balance (or enterprise balance) and currency.", inputSchema: {}, annotations: READ },
+    async () => run(async () => text(await client.balance.get()))
+  );
+  server.registerTool(
+    "list_esims",
+    {
+      title: "List eSIMs",
+      description: "eSIMs on the account with status, data left and validity. Search by ICCID, package name or code; filter by status.",
+      inputSchema: {
+        search: z.string().optional(),
+        status: z.enum(["all", "NEW", "ACTIVE", "EXPIRED", "CANCELLED", "DEPLETED", "DELETED"]).optional(),
+        page: z.number().int().min(1).optional(),
+        limit: z.number().int().min(1).max(100).optional().describe("Default 20")
+      },
+      annotations: READ
+    },
+    async ({ search, status, page, limit }) => run(async () => {
+      const res = await client.esims.list({ search, status, page, limit: limit ?? 20 });
+      return text({
+        pagination: res.pagination,
+        esims: res.esims.map((e) => ({
+          id: e.id,
+          iccid: e.iccid,
+          package_name: e.package_name,
+          package_code: e.package_code,
+          status: e.status,
+          data: e.data,
+          validity: e.validity,
+          countries: e.countries,
+          created_at: e.created_at,
+          esim_status: e.esim_status ?? null,
+          profile_status: e.profile_status ?? null
+        }))
+      });
+    })
+  );
+  server.registerTool(
+    "get_esim_usage",
+    {
+      title: "Get eSIM usage",
+      description: "Stored data usage and validity for one eSIM (cheap; fresh as of the last sync). Identify by ICCID or order reference.",
+      inputSchema: { iccid: z.string().optional(), order_reference: z.string().optional() },
+      annotations: READ
+    },
+    async ({ iccid, order_reference }) => run(async () => {
+      if (!iccid && !order_reference) throw new ESIMflyError("Provide iccid or order_reference", { code: "MISSING_IDENTIFIER" });
+      return text(await client.esims.usage(iccid ? { iccid } : { orderId: order_reference }));
+    })
+  );
+  server.registerTool(
+    "get_esim_live_status",
+    {
+      title: "Get live eSIM status (network query)",
+      description: '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 \u2014 use for diagnosis ("no data", "is it installed?"), not routinely.',
+      inputSchema: { iccid: iccidArg },
+      annotations: READ
+    },
+    async ({ iccid }) => run(async () => text(await client.esims.status({ iccid })))
+  );
+  server.registerTool(
+    "get_network_events",
+    {
+      title: "Get network events (last 7 days)",
+      description: '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 \u2014 the usual cause of "connected but no data" (fix: airplane-mode toggle or manual network selection).',
+      inputSchema: { iccid: iccidArg },
+      annotations: READ
+    },
+    async ({ iccid }) => run(async () => text(await client.esims.networkEvents({ iccid })))
+  );
+  server.registerTool(
+    "get_usage_report",
+    {
+      title: "Get daily usage report",
+      description: "Daily data usage for one eSIM over the last N days (default 7, max 90) with per-country and per-operator breakdown.",
+      inputSchema: { iccid: iccidArg, days: z.number().int().min(1).max(90).optional() },
+      annotations: READ
+    },
+    async ({ iccid, days }) => run(async () => text(await client.esims.usageReport({ iccid }, days)))
+  );
+  server.registerTool(
+    "list_orders",
+    {
+      title: "List orders",
+      description: "Order history with filters (status, date range ISO 8601, search by reference / package) and a revenue summary.",
+      inputSchema: {
+        status: z.enum(["all", "pending", "completed", "failed", "cancelled"]).optional(),
+        from_date: z.string().optional(),
+        to_date: z.string().optional(),
+        search: z.string().optional(),
+        page: z.number().int().min(1).optional(),
+        limit: z.number().int().min(1).max(100).optional().describe("Default 20")
+      },
+      annotations: READ
+    },
+    async ({ status, from_date, to_date, search, page, limit }) => run(async () => text(await client.orders.list({ status, from_date, to_date, search, page, limit: limit ?? 20 })))
+  );
+  server.registerTool(
+    "get_order",
+    {
+      title: "Get order",
+      description: "One order by reference, including its eSIM (ICCID, install links, pending state).",
+      inputSchema: { order_reference: z.string() },
+      annotations: READ
+    },
+    async ({ order_reference }) => run(async () => text(await client.orders.get(order_reference)))
+  );
+  server.registerTool(
+    "get_topup_packages",
+    {
+      title: "Get top-up packages for an eSIM",
+      description: "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.",
+      inputSchema: { iccid: iccidArg, limit: z.number().int().min(1).max(100).optional() },
+      annotations: READ
+    },
+    async ({ iccid, limit }) => run(async () => text(await client.topups.packages({ iccid, limit: limit ?? 50 })))
+  );
+  server.registerTool(
+    "get_webhook_settings",
+    {
+      title: "Get webhook settings",
+      description: "Configured webhook URL, subscribed events, available events and the last deliveries.",
+      inputSchema: {},
+      annotations: READ
+    },
+    async () => run(async () => text(await client.webhooks.get()))
+  );
+  if (allowWrites) {
+    const confirmArg = z.boolean().optional().describe("Omit to get a preview; pass true to execute");
+    server.registerTool(
+      "create_order",
+      {
+        title: "Create eSIM order (spends balance)",
+        description: "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.",
+        inputSchema: {
+          package_code: z.string().describe("Exact package_code from search_packages"),
+          quantity: z.number().int().min(1).max(10).optional(),
+          idempotency_key: z.string().max(200).optional().describe("From the preview; required with confirm: true"),
+          confirm: confirmArg
+        },
+        annotations: WRITE
+      },
+      async ({ package_code, quantity, idempotency_key, confirm }) => run(async () => {
+        if (!confirm) {
+          const balance = await client.balance.get();
+          return text({
+            preview: true,
+            action: "create_order",
+            package_code,
+            quantity: quantity ?? 1,
+            balance_before: balance,
+            idempotency_key: `mcp-${randomUUID()}`,
+            next_step: "Call create_order again with confirm: true and this idempotency_key to place the order. The API charges the current package price."
+          });
+        }
+        if (!idempotency_key) {
+          throw new ESIMflyError("confirm: true requires the idempotency_key returned by the preview", { code: "MISSING_FIELDS" });
+        }
+        const order = await client.orders.create({ packageCode: package_code, quantity, idempotencyKey: idempotency_key });
+        return text({
+          orderReference: order.orderReference,
+          status: order.status,
+          duplicate: order.duplicate ?? false,
+          amount: order.amount,
+          currency: order.currency,
+          newBalance: order.newBalance,
+          esims: order.esims.map((e) => ({
+            iccid: e.iccid,
+            lpaString: e.lpaString,
+            directAppleInstallUrl: e.directAppleInstallUrl,
+            directAndroidInstallUrl: e.directAndroidInstallUrl,
+            expired_time: e.expired_time,
+            isPending: e.isPending
+          }))
+        });
+      })
+    );
+    server.registerTool(
+      "topup_esim",
+      {
+        title: "Top up an eSIM (spends balance)",
+        description: "Add a package to an existing eSIM. Two-step: without confirm returns the package name, cost and current balance; with confirm: true executes.",
+        inputSchema: { iccid: iccidArg, package_code: z.string().describe("From get_topup_packages"), confirm: confirmArg },
+        annotations: WRITE
+      },
+      async ({ iccid, package_code, confirm }) => run(async () => {
+        if (!confirm) {
+          const [pkgs, balance] = await Promise.all([client.topups.packages({ iccid, limit: 100 }), client.balance.get()]);
+          const pkg = pkgs.packages.find((p) => p.package_code === package_code) ?? null;
+          return text({
+            preview: true,
+            action: "topup_esim",
+            iccid,
+            package: pkg ? { package_code: pkg.package_code, name: pkg.name, data_gb: pkg.data_amount_gb, validity_days: pkg.validity_days, cost: pkg.cost, currency: pkg.currency } : null,
+            warning: pkg ? void 0 : "package_code is not in the top-up list for this eSIM; the call will fail",
+            balance_before: balance,
+            next_step: "Call topup_esim again with confirm: true to execute."
+          });
+        }
+        return text(await client.topups.create({ iccid, packageCode: package_code }));
+      })
+    );
+    server.registerTool(
+      "cancel_esim",
+      {
+        title: "Cancel an unused eSIM (refund to balance)",
+        description: "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.",
+        inputSchema: { iccid: iccidArg, confirm: confirmArg },
+        annotations: DESTRUCTIVE
+      },
+      async ({ iccid, confirm }) => run(async () => {
+        if (!confirm) {
+          const usage = await client.esims.usage({ iccid }).catch(() => null);
+          return text({
+            preview: true,
+            action: "cancel_esim",
+            iccid,
+            current: usage ? { status: usage.esim.status, order_id: usage.esim.order_id, activated_at: usage.validity.activated_at } : null,
+            warning: "All eligible eSIMs in the same order will be cancelled together. Installed or activated eSIMs are not eligible.",
+            next_step: "Call cancel_esim again with confirm: true to execute."
+          });
+        }
+        return text(await client.esims.cancel({ iccid }));
+      })
+    );
+    server.registerTool(
+      "suspend_esim",
+      {
+        title: "Suspend an eSIM (block network access)",
+        description: "Block network access for an eSIMfly-network eSIM (reversible with activate_esim). Two-step: confirm: true to execute.",
+        inputSchema: { iccid: iccidArg, confirm: confirmArg },
+        annotations: DESTRUCTIVE
+      },
+      async ({ iccid, confirm }) => run(async () => {
+        if (!confirm) return text({ preview: true, action: "suspend_esim", iccid, next_step: "Call again with confirm: true to block network access." });
+        return text(await client.esims.suspend({ iccid }));
+      })
+    );
+    server.registerTool(
+      "activate_esim",
+      {
+        title: "Re-activate a suspended eSIM",
+        description: "Restore network access after suspend_esim. Two-step: confirm: true to execute.",
+        inputSchema: { iccid: iccidArg, confirm: confirmArg },
+        annotations: WRITE
+      },
+      async ({ iccid, confirm }) => run(async () => {
+        if (!confirm) return text({ preview: true, action: "activate_esim", iccid, next_step: "Call again with confirm: true to restore network access." });
+        return text(await client.esims.activate({ iccid }));
+      })
+    );
+    server.registerTool(
+      "send_sms",
+      {
+        title: "Send an SMS to an eSIM",
+        description: "Send a text (max 500 characters) to the device holding the eSIM. Two-step: confirm: true to send.",
+        inputSchema: { iccid: iccidArg, message: z.string().min(1).max(500), confirm: confirmArg },
+        annotations: WRITE
+      },
+      async ({ iccid, message, confirm }) => run(async () => {
+        if (!confirm) return text({ preview: true, action: "send_sms", iccid, message, next_step: "Call again with confirm: true to send." });
+        await client.esims.sendSms({ iccid }, message);
+        return text({ sent: true, iccid });
+      })
+    );
+    server.registerTool(
+      "set_webhook",
+      {
+        title: "Set webhook URL and events",
+        description: "Configure (or rotate) the webhook URL and subscribed events. The response contains the signing secret \u2014 shown once. Two-step: confirm: true to apply.",
+        inputSchema: {
+          webhook_url: z.string().url(),
+          events: z.array(z.enum(["esim.installed", "esim.profile.updated", "esim.status.changed", "esim.usage.threshold", "esim.provisioned", "order.completed"])).optional(),
+          confirm: confirmArg
+        },
+        annotations: WRITE
+      },
+      async ({ webhook_url, events, confirm }) => run(async () => {
+        if (!confirm) return text({ preview: true, action: "set_webhook", webhook_url, events: events ?? null, next_step: "Call again with confirm: true to apply. Store the returned secret securely." });
+        return text(await client.webhooks.set({ webhookUrl: webhook_url, events }));
+      })
+    );
+  }
+  server.registerPrompt(
+    "esimfly_integration_guide",
+    {
+      title: "eSIMfly integration guide",
+      description: "The complete, always-current prompt for building an eSIMfly integration (all endpoints, recommended architecture, webhooks, SDK). Fetched from docs.esimfly.net.",
+      argsSchema: { stack: z.string().optional().describe('Your language / framework / database, e.g. "Node.js + Prisma + Postgres"') }
+    },
+    async ({ stack }) => {
+      let guide;
+      try {
+        const res = await fetchImpl(FULL_PROMPT_URL);
+        guide = res.ok ? await res.text() : "";
+      } catch {
+        guide = "";
+      }
+      if (!guide) guide = `(Could not fetch the guide. Read it at ${FULL_PROMPT_URL})`;
+      const extra = stack ? `
+
+My stack: ${stack}. Start with the shared client and the catalogue sync job.` : "";
+      return { messages: [{ role: "user", content: { type: "text", text: guide + extra } }] };
+    }
+  );
+  server.registerPrompt(
+    "diagnose_esim",
+    {
+      title: "Diagnose an eSIM connectivity problem",
+      description: "Walks through the live status, network events and usage of one eSIM and explains what the customer should do.",
+      argsSchema: { iccid: z.string().describe("ICCID of the eSIM") }
+    },
+    async ({ iccid }) => ({
+      messages: [{
+        role: "user",
+        content: {
+          type: "text",
+          text: [
+            `Diagnose eSIM ${iccid}.`,
+            "1. Call get_esim_usage to see status, data left and validity.",
+            "2. Call get_esim_live_status: is the profile installed (profile = Enabled)? which device? which network did it last attach to?",
+            "3. Call get_network_events: any is_allowed = false events (wrong network)? recent data sessions?",
+            "Then explain in plain language what is wrong (not installed / wrong network / depleted / expired / never connected) and the exact steps the customer should take (install, enable data roaming, airplane-mode toggle, manual network selection, top-up)."
+          ].join("\n")
+        }
+      }]
+    })
+  );
+  return server;
+}
+
+export {
+  MCP_VERSION,
+  createEsimflyMcpServer
+};
+//# sourceMappingURL=chunk-Q3UI3CYF.js.map

package/dist/chunk-Q3UI3CYF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["/**\n * eSIMfly MCP server — exposes the eSIMfly Business API to AI agents as tools.\n *\n * Read tools are always available. Write tools (orders, top-ups, cancel,\n * suspend, SMS, webhook config) exist only when `allowWrites` is on, and each\n * one is two-step: a call without `confirm: true` returns a preview (what it\n * will do, what it costs, your balance) and never touches the API mutably.\n */\nimport { randomUUID } from 'node:crypto';\nimport { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';\nimport type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';\nimport { z } from 'zod';\nimport { ESIMfly, ESIMflyError, type ESIMflyConfig, type Package } from '@esimfly/sdk';\n\nexport const MCP_VERSION = '0.1.0';\nconst FULL_PROMPT_URL = 'https://docs.esimfly.net/llm/esimfly-api-full-prompt.txt';\nconst DOCS_URL = 'https://docs.esimfly.net';\n\nexport interface EsimflyMcpOptions {\n  /** Pre-built client (tests, embedding). Takes precedence over `config`. */\n  client?: ESIMfly;\n  /** Credentials used to build the client when `client` is not given. */\n  config?: ESIMflyConfig;\n  /** Register the money-moving / state-changing tools. Default false. */\n  allowWrites?: boolean;\n  /** Used to fetch the integration prompt for the `esimfly_integration_guide` prompt. */\n  fetch?: typeof fetch;\n}\n\ntype ToolResult = CallToolResult;\n\nconst text = (value: unknown): ToolResult => ({\n  content: [{ type: 'text', text: typeof value === 'string' ? value : JSON.stringify(value, null, 2) }],\n});\n\nconst failure = (err: unknown): ToolResult => {\n  if (err instanceof ESIMflyError) {\n    return {\n      isError: true,\n      content: [{\n        type: 'text',\n        text: JSON.stringify({ error: err.code, message: err.message, status: err.status ?? null, details: err.response ?? null }, null, 2),\n      }],\n    };\n  }\n  return { isError: true, content: [{ type: 'text', text: `Unexpected error: ${(err as Error)?.message ?? String(err)}` }] };\n};\n\nconst run = async (fn: () => Promise<ToolResult>): Promise<ToolResult> => {\n  try {\n    return await fn();\n  } catch (err) {\n    return failure(err);\n  }\n};\n\nconst READ = { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: true } as const;\nconst WRITE = { readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true } as const;\nconst DESTRUCTIVE = { readOnlyHint: false, destructiveHint: true, idempotentHint: true, openWorldHint: true } as const;\n\nconst iccidArg = z.string().min(15).max(22).describe('ICCID of the eSIM (19-20 digits)');\n\nfunction compactPackage(p: Package) {\n  return {\n    package_code: p.package_code,\n    name: p.name,\n    region: p.region,\n    type: p.type,\n    data_gb: p.data_amount_gb,\n    validity_days: p.validity_days,\n    cost: p.cost,\n    currency: p.currency,\n    is_unlimited: p.is_unlimited,\n    has_voice: p.has_voice ?? false,\n    has_sms: p.has_sms ?? false,\n    countries: p.countries ? (p.countries.length > 12 ? [...p.countries.slice(0, 12), `+${p.countries.length - 12} more`] : p.countries) : undefined,\n    networks: p.networks?.length ?? p.locationNetworkList?.reduce((n, l) => n + (l.operatorList?.length ?? 0), 0),\n  };\n}\n\nexport function createEsimflyMcpServer(options: EsimflyMcpOptions = {}): McpServer {\n  const client = options.client ?? new ESIMfly(options.config ?? ({} as ESIMflyConfig));\n  const allowWrites = options.allowWrites ?? false;\n  const fetchImpl = options.fetch ?? globalThis.fetch;\n\n  const server = new McpServer(\n    { name: 'esimfly', version: MCP_VERSION },\n    {\n      instructions: [\n        'Tools for the eSIMfly Business API (wholesale eSIM data plans for 200+ countries).',\n        'Package codes are opaque strings: pass them back exactly as returned. Prices (cost) are the partner buy price in the account currency.',\n        'get_esim_usage is cheap; get_esim_live_status and get_network_events query the mobile network live — use them for diagnosis, not routinely.',\n        allowWrites\n          ? 'Write tools are enabled. Every write is two-step: call without confirm to get a preview (cost, balance), then call again with confirm: true. Never confirm on the user\\'s behalf without telling them the cost.'\n          : 'This server is read-only: ordering, top-ups, cancel, suspend, SMS and webhook changes are disabled (start with ESIMFLY_MCP_ALLOW_WRITES=true to enable).',\n        `Documentation: ${DOCS_URL}`,\n      ].join('\\n'),\n    },\n  );\n\n  // ------------------------------------------------------------------ read tools\n  server.registerTool(\n    'search_packages',\n    {\n      title: 'Search eSIM packages',\n      description:\n        '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.',\n      inputSchema: {\n        search: z.string().optional().describe('Country or region name, e.g. \"Turkey\", \"Europe\"'),\n        type: z.enum(['local', 'regional', 'global']).optional(),\n        page: z.number().int().min(1).optional(),\n        limit: z.number().int().min(1).max(100).optional().describe('Default 20'),\n      },\n      annotations: READ,\n    },\n    async ({ search, type, page, limit }) =>\n      run(async () => {\n        const res = await client.packages.list({ search, type, page, limit: limit ?? 20 });\n        return text({ pagination: res.pagination, packages: res.packages.map(compactPackage) });\n      }),\n  );\n\n  server.registerTool(\n    'get_balance',\n    { title: 'Get account balance', description: 'Current prepaid balance (or enterprise balance) and currency.', inputSchema: {}, annotations: READ },\n    async () => run(async () => text(await client.balance.get())),\n  );\n\n  server.registerTool(\n    'list_esims',\n    {\n      title: 'List eSIMs',\n      description: 'eSIMs on the account with status, data left and validity. Search by ICCID, package name or code; filter by status.',\n      inputSchema: {\n        search: z.string().optional(),\n        status: z.enum(['all', 'NEW', 'ACTIVE', 'EXPIRED', 'CANCELLED', 'DEPLETED', 'DELETED']).optional(),\n        page: z.number().int().min(1).optional(),\n        limit: z.number().int().min(1).max(100).optional().describe('Default 20'),\n      },\n      annotations: READ,\n    },\n    async ({ search, status, page, limit }) =>\n      run(async () => {\n        const res = await client.esims.list({ search, status, page, limit: limit ?? 20 });\n        return text({\n          pagination: res.pagination,\n          esims: res.esims.map((e) => ({\n            id: e.id,\n            iccid: e.iccid,\n            package_name: e.package_name,\n            package_code: e.package_code,\n            status: e.status,\n            data: e.data,\n            validity: e.validity,\n            countries: e.countries,\n            created_at: e.created_at,\n            esim_status: e.esim_status ?? null,\n            profile_status: e.profile_status ?? null,\n          })),\n        });\n      }),\n  );\n\n  server.registerTool(\n    'get_esim_usage',\n    {\n      title: 'Get eSIM usage',\n      description: 'Stored data usage and validity for one eSIM (cheap; fresh as of the last sync). Identify by ICCID or order reference.',\n      inputSchema: { iccid: z.string().optional(), order_reference: z.string().optional() },\n      annotations: READ,\n    },\n    async ({ iccid, order_reference }) =>\n      run(async () => {\n        if (!iccid && !order_reference) throw new ESIMflyError('Provide iccid or order_reference', { code: 'MISSING_IDENTIFIER' });\n        return text(await client.esims.usage(iccid ? { iccid } : { orderId: order_reference! }));\n      }),\n  );\n\n  server.registerTool(\n    'get_esim_live_status',\n    {\n      title: 'Get live eSIM status (network query)',\n      description:\n        '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.',\n      inputSchema: { iccid: iccidArg },\n      annotations: READ,\n    },\n    async ({ iccid }) => run(async () => text(await client.esims.status({ iccid }))),\n  );\n\n  server.registerTool(\n    'get_network_events',\n    {\n      title: 'Get network events (last 7 days)',\n      description:\n        '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).',\n      inputSchema: { iccid: iccidArg },\n      annotations: READ,\n    },\n    async ({ iccid }) => run(async () => text(await client.esims.networkEvents({ iccid }))),\n  );\n\n  server.registerTool(\n    'get_usage_report',\n    {\n      title: 'Get daily usage report',\n      description: 'Daily data usage for one eSIM over the last N days (default 7, max 90) with per-country and per-operator breakdown.',\n      inputSchema: { iccid: iccidArg, days: z.number().int().min(1).max(90).optional() },\n      annotations: READ,\n    },\n    async ({ iccid, days }) => run(async () => text(await client.esims.usageReport({ iccid }, days))),\n  );\n\n  server.registerTool(\n    'list_orders',\n    {\n      title: 'List orders',\n      description: 'Order history with filters (status, date range ISO 8601, search by reference / package) and a revenue summary.',\n      inputSchema: {\n        status: z.enum(['all', 'pending', 'completed', 'failed', 'cancelled']).optional(),\n        from_date: z.string().optional(),\n        to_date: z.string().optional(),\n        search: z.string().optional(),\n        page: z.number().int().min(1).optional(),\n        limit: z.number().int().min(1).max(100).optional().describe('Default 20'),\n      },\n      annotations: READ,\n    },\n    async ({ status, from_date, to_date, search, page, limit }) =>\n      run(async () => text(await client.orders.list({ status, from_date, to_date, search, page, limit: limit ?? 20 }))),\n  );\n\n  server.registerTool(\n    'get_order',\n    {\n      title: 'Get order',\n      description: 'One order by reference, including its eSIM (ICCID, install links, pending state).',\n      inputSchema: { order_reference: z.string() },\n      annotations: READ,\n    },\n    async ({ order_reference }) => run(async () => text(await client.orders.get(order_reference))),\n  );\n\n  server.registerTool(\n    'get_topup_packages',\n    {\n      title: 'Get top-up packages for an eSIM',\n      description: '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.',\n      inputSchema: { iccid: iccidArg, limit: z.number().int().min(1).max(100).optional() },\n      annotations: READ,\n    },\n    async ({ iccid, limit }) => run(async () => text(await client.topups.packages({ iccid, limit: limit ?? 50 }))),\n  );\n\n  server.registerTool(\n    'get_webhook_settings',\n    {\n      title: 'Get webhook settings',\n      description: 'Configured webhook URL, subscribed events, available events and the last deliveries.',\n      inputSchema: {},\n      annotations: READ,\n    },\n    async () => run(async () => text(await client.webhooks.get())),\n  );\n\n  // ------------------------------------------------------------------ write tools (opt-in, two-step)\n  if (allowWrites) {\n    const confirmArg = z.boolean().optional().describe('Omit to get a preview; pass true to execute');\n\n    server.registerTool(\n      'create_order',\n      {\n        title: 'Create eSIM order (spends balance)',\n        description:\n          '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.',\n        inputSchema: {\n          package_code: z.string().describe('Exact package_code from search_packages'),\n          quantity: z.number().int().min(1).max(10).optional(),\n          idempotency_key: z.string().max(200).optional().describe('From the preview; required with confirm: true'),\n          confirm: confirmArg,\n        },\n        annotations: WRITE,\n      },\n      async ({ package_code, quantity, idempotency_key, confirm }) =>\n        run(async () => {\n          if (!confirm) {\n            const balance = await client.balance.get();\n            return text({\n              preview: true,\n              action: 'create_order',\n              package_code,\n              quantity: quantity ?? 1,\n              balance_before: balance,\n              idempotency_key: `mcp-${randomUUID()}`,\n              next_step: 'Call create_order again with confirm: true and this idempotency_key to place the order. The API charges the current package price.',\n            });\n          }\n          if (!idempotency_key) {\n            throw new ESIMflyError('confirm: true requires the idempotency_key returned by the preview', { code: 'MISSING_FIELDS' });\n          }\n          const order = await client.orders.create({ packageCode: package_code, quantity, idempotencyKey: idempotency_key });\n          return text({\n            orderReference: order.orderReference,\n            status: order.status,\n            duplicate: order.duplicate ?? false,\n            amount: order.amount,\n            currency: order.currency,\n            newBalance: order.newBalance,\n            esims: order.esims.map((e) => ({\n              iccid: e.iccid,\n              lpaString: e.lpaString,\n              directAppleInstallUrl: e.directAppleInstallUrl,\n              directAndroidInstallUrl: e.directAndroidInstallUrl,\n              expired_time: e.expired_time,\n              isPending: e.isPending,\n            })),\n          });\n        }),\n    );\n\n    server.registerTool(\n      'topup_esim',\n      {\n        title: 'Top up an eSIM (spends balance)',\n        description: 'Add a package to an existing eSIM. Two-step: without confirm returns the package name, cost and current balance; with confirm: true executes.',\n        inputSchema: { iccid: iccidArg, package_code: z.string().describe('From get_topup_packages'), confirm: confirmArg },\n        annotations: WRITE,\n      },\n      async ({ iccid, package_code, confirm }) =>\n        run(async () => {\n          if (!confirm) {\n            const [pkgs, balance] = await Promise.all([client.topups.packages({ iccid, limit: 100 }), client.balance.get()]);\n            const pkg = pkgs.packages.find((p) => p.package_code === package_code) ?? null;\n            return text({\n              preview: true,\n              action: 'topup_esim',\n              iccid,\n              package: pkg ? { package_code: pkg.package_code, name: pkg.name, data_gb: pkg.data_amount_gb, validity_days: pkg.validity_days, cost: pkg.cost, currency: pkg.currency } : null,\n              warning: pkg ? undefined : 'package_code is not in the top-up list for this eSIM; the call will fail',\n              balance_before: balance,\n              next_step: 'Call topup_esim again with confirm: true to execute.',\n            });\n          }\n          return text(await client.topups.create({ iccid, packageCode: package_code }));\n        }),\n    );\n\n    server.registerTool(\n      'cancel_esim',\n      {\n        title: 'Cancel an unused eSIM (refund to balance)',\n        description: '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.',\n        inputSchema: { iccid: iccidArg, confirm: confirmArg },\n        annotations: DESTRUCTIVE,\n      },\n      async ({ iccid, confirm }) =>\n        run(async () => {\n          if (!confirm) {\n            const usage = await client.esims.usage({ iccid }).catch(() => null);\n            return text({\n              preview: true,\n              action: 'cancel_esim',\n              iccid,\n              current: usage ? { status: usage.esim.status, order_id: usage.esim.order_id, activated_at: usage.validity.activated_at } : null,\n              warning: 'All eligible eSIMs in the same order will be cancelled together. Installed or activated eSIMs are not eligible.',\n              next_step: 'Call cancel_esim again with confirm: true to execute.',\n            });\n          }\n          return text(await client.esims.cancel({ iccid }));\n        }),\n    );\n\n    server.registerTool(\n      'suspend_esim',\n      {\n        title: 'Suspend an eSIM (block network access)',\n        description: 'Block network access for an eSIMfly-network eSIM (reversible with activate_esim). Two-step: confirm: true to execute.',\n        inputSchema: { iccid: iccidArg, confirm: confirmArg },\n        annotations: DESTRUCTIVE,\n      },\n      async ({ iccid, confirm }) =>\n        run(async () => {\n          if (!confirm) return text({ preview: true, action: 'suspend_esim', iccid, next_step: 'Call again with confirm: true to block network access.' });\n          return text(await client.esims.suspend({ iccid }));\n        }),\n    );\n\n    server.registerTool(\n      'activate_esim',\n      {\n        title: 'Re-activate a suspended eSIM',\n        description: 'Restore network access after suspend_esim. Two-step: confirm: true to execute.',\n        inputSchema: { iccid: iccidArg, confirm: confirmArg },\n        annotations: WRITE,\n      },\n      async ({ iccid, confirm }) =>\n        run(async () => {\n          if (!confirm) return text({ preview: true, action: 'activate_esim', iccid, next_step: 'Call again with confirm: true to restore network access.' });\n          return text(await client.esims.activate({ iccid }));\n        }),\n    );\n\n    server.registerTool(\n      'send_sms',\n      {\n        title: 'Send an SMS to an eSIM',\n        description: 'Send a text (max 500 characters) to the device holding the eSIM. Two-step: confirm: true to send.',\n        inputSchema: { iccid: iccidArg, message: z.string().min(1).max(500), confirm: confirmArg },\n        annotations: WRITE,\n      },\n      async ({ iccid, message, confirm }) =>\n        run(async () => {\n          if (!confirm) return text({ preview: true, action: 'send_sms', iccid, message, next_step: 'Call again with confirm: true to send.' });\n          await client.esims.sendSms({ iccid }, message);\n          return text({ sent: true, iccid });\n        }),\n    );\n\n    server.registerTool(\n      'set_webhook',\n      {\n        title: 'Set webhook URL and events',\n        description: 'Configure (or rotate) the webhook URL and subscribed events. The response contains the signing secret — shown once. Two-step: confirm: true to apply.',\n        inputSchema: {\n          webhook_url: z.string().url(),\n          events: z.array(z.enum(['esim.installed', 'esim.profile.updated', 'esim.status.changed', 'esim.usage.threshold', 'esim.provisioned', 'order.completed'])).optional(),\n          confirm: confirmArg,\n        },\n        annotations: WRITE,\n      },\n      async ({ webhook_url, events, confirm }) =>\n        run(async () => {\n          if (!confirm) return text({ preview: true, action: 'set_webhook', webhook_url, events: events ?? null, next_step: 'Call again with confirm: true to apply. Store the returned secret securely.' });\n          return text(await client.webhooks.set({ webhookUrl: webhook_url, events }));\n        }),\n    );\n  }\n\n  // ------------------------------------------------------------------ prompts\n  server.registerPrompt(\n    'esimfly_integration_guide',\n    {\n      title: 'eSIMfly integration guide',\n      description: 'The complete, always-current prompt for building an eSIMfly integration (all endpoints, recommended architecture, webhooks, SDK). Fetched from docs.esimfly.net.',\n      argsSchema: { stack: z.string().optional().describe('Your language / framework / database, e.g. \"Node.js + Prisma + Postgres\"') },\n    },\n    async ({ stack }) => {\n      let guide: string;\n      try {\n        const res = await fetchImpl(FULL_PROMPT_URL);\n        guide = res.ok ? await res.text() : '';\n      } catch {\n        guide = '';\n      }\n      if (!guide) guide = `(Could not fetch the guide. Read it at ${FULL_PROMPT_URL})`;\n      const extra = stack ? `\\n\\nMy stack: ${stack}. Start with the shared client and the catalogue sync job.` : '';\n      return { messages: [{ role: 'user', content: { type: 'text', text: guide + extra } }] };\n    },\n  );\n\n  server.registerPrompt(\n    'diagnose_esim',\n    {\n      title: 'Diagnose an eSIM connectivity problem',\n      description: 'Walks through the live status, network events and usage of one eSIM and explains what the customer should do.',\n      argsSchema: { iccid: z.string().describe('ICCID of the eSIM') },\n    },\n    async ({ iccid }) => ({\n      messages: [{\n        role: 'user',\n        content: {\n          type: 'text',\n          text: [\n            `Diagnose eSIM ${iccid}.`,\n            '1. Call get_esim_usage to see status, data left and validity.',\n            '2. Call get_esim_live_status: is the profile installed (profile = Enabled)? which device? which network did it last attach to?',\n            '3. Call get_network_events: any is_allowed = false events (wrong network)? recent data sessions?',\n            'Then explain in plain language what is wrong (not installed / wrong network / depleted / expired / never connected) and the exact steps the customer should take (install, enable data roaming, airplane-mode toggle, manual network selection, top-up).',\n          ].join('\\n'),\n        },\n      }],\n    }),\n  );\n\n  return server;\n}\n"],"mappings":"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","names":[]}

package/dist/index.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+import {
+  MCP_VERSION,
+  createEsimflyMcpServer
+} from "./chunk-Q3UI3CYF.js";
+
+// src/index.ts
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+var accessCode = process.env.ESIMFLY_ACCESS_CODE;
+var secretKey = process.env.ESIMFLY_SECRET_KEY;
+if (!accessCode || !secretKey) {
+  console.error(
+    "[esimfly-mcp] Missing credentials. Set ESIMFLY_ACCESS_CODE and ESIMFLY_SECRET_KEY (Business Dashboard \u2192 Settings \u2192 API Keys). See https://docs.esimfly.net"
+  );
+  process.exit(1);
+}
+var allowWrites = /^(1|true|yes)$/i.test(process.env.ESIMFLY_MCP_ALLOW_WRITES ?? "");
+var server = createEsimflyMcpServer({
+  config: {
+    accessCode,
+    secretKey,
+    baseUrl: process.env.ESIMFLY_BASE_URL,
+    userAgent: `esimfly-mcp/${MCP_VERSION}`
+  },
+  allowWrites
+});
+var transport = new StdioServerTransport();
+await server.connect(transport);
+console.error(`[esimfly-mcp] v${MCP_VERSION} ready (${allowWrites ? "read + write tools" : "read-only"})`);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * CLI entry: `npx -y @esimfly/mcp` (stdio transport).\n *\n * Env: ESIMFLY_ACCESS_CODE, ESIMFLY_SECRET_KEY (required),\n *      ESIMFLY_MCP_ALLOW_WRITES=true (optional), ESIMFLY_BASE_URL (optional).\n * Never write to stdout here — it is the MCP protocol channel.\n */\nimport { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';\nimport { createEsimflyMcpServer, MCP_VERSION } from './server.js';\n\nconst accessCode = process.env.ESIMFLY_ACCESS_CODE;\nconst secretKey = process.env.ESIMFLY_SECRET_KEY;\n\nif (!accessCode || !secretKey) {\n  console.error(\n    '[esimfly-mcp] Missing credentials. Set ESIMFLY_ACCESS_CODE and ESIMFLY_SECRET_KEY ' +\n      '(Business Dashboard → Settings → API Keys). See https://docs.esimfly.net',\n  );\n  process.exit(1);\n}\n\nconst allowWrites = /^(1|true|yes)$/i.test(process.env.ESIMFLY_MCP_ALLOW_WRITES ?? '');\n\nconst server = createEsimflyMcpServer({\n  config: {\n    accessCode,\n    secretKey,\n    baseUrl: process.env.ESIMFLY_BASE_URL,\n    userAgent: `esimfly-mcp/${MCP_VERSION}`,\n  },\n  allowWrites,\n});\n\nconst transport = new StdioServerTransport();\nawait server.connect(transport);\nconsole.error(`[esimfly-mcp] v${MCP_VERSION} ready (${allowWrites ? 'read + write tools' : 'read-only'})`);\n"],"mappings":";;;;;;AAOA,SAAS,4BAA4B;AAGrC,IAAM,aAAa,QAAQ,IAAI;AAC/B,IAAM,YAAY,QAAQ,IAAI;AAE9B,IAAI,CAAC,cAAc,CAAC,WAAW;AAC7B,UAAQ;AAAA,IACN;AAAA,EAEF;AACA,UAAQ,KAAK,CAAC;AAChB;AAEA,IAAM,cAAc,kBAAkB,KAAK,QAAQ,IAAI,4BAA4B,EAAE;AAErF,IAAM,SAAS,uBAAuB;AAAA,EACpC,QAAQ;AAAA,IACN;AAAA,IACA;AAAA,IACA,SAAS,QAAQ,IAAI;AAAA,IACrB,WAAW,eAAe,WAAW;AAAA,EACvC;AAAA,EACA;AACF,CAAC;AAED,IAAM,YAAY,IAAI,qBAAqB;AAC3C,MAAM,OAAO,QAAQ,SAAS;AAC9B,QAAQ,MAAM,kBAAkB,WAAW,WAAW,cAAc,uBAAuB,WAAW,GAAG;","names":[]}

package/dist/server.d.ts

@@ -0,0 +1,17 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { ESIMfly, ESIMflyConfig } from '@esimfly/sdk';
+
+declare const MCP_VERSION = "0.1.0";
+interface EsimflyMcpOptions {
+    /** Pre-built client (tests, embedding). Takes precedence over `config`. */
+    client?: ESIMfly;
+    /** Credentials used to build the client when `client` is not given. */
+    config?: ESIMflyConfig;
+    /** Register the money-moving / state-changing tools. Default false. */
+    allowWrites?: boolean;
+    /** Used to fetch the integration prompt for the `esimfly_integration_guide` prompt. */
+    fetch?: typeof fetch;
+}
+declare function createEsimflyMcpServer(options?: EsimflyMcpOptions): McpServer;
+
+export { type EsimflyMcpOptions, MCP_VERSION, createEsimflyMcpServer };

package/dist/server.js

@@ -0,0 +1,9 @@
+import {
+  MCP_VERSION,
+  createEsimflyMcpServer
+} from "./chunk-Q3UI3CYF.js";
+export {
+  MCP_VERSION,
+  createEsimflyMcpServer
+};
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "@esimfly/mcp",
+  "version": "0.1.0",
+  "description": "MCP server for the eSIMfly Business API — let Claude, ChatGPT, Cursor and other AI agents search eSIM plans, check usage, diagnose connectivity and (optionally) place orders",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "esim",
+    "esimfly",
+    "ai-agent",
+    "claude",
+    "cursor",
+    "travel",
+    "connectivity"
+  ],
+  "homepage": "https://docs.esimfly.net",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eSimfly-Official/esimfly-mcp.git"
+  },
+  "bugs": {
+    "email": "support@esimfly.net"
+  },
+  "license": "MIT",
+  "author": "eSIMfly <support@esimfly.net>",
+  "type": "module",
+  "bin": {
+    "esimfly-mcp": "./dist/index.js"
+  },
+  "main": "./dist/server.js",
+  "types": "./dist/server.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/server.d.ts",
+      "import": "./dist/server.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "SECURITY.md",
+    "server.json"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
+  "dependencies": {
+    "@esimfly/sdk": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.20.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.19.43",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.11"
+  },
+  "overrides": {
+    "esbuild": ">=0.28.1"
+  },
+  "mcpName": "io.github.esimfly-official/esimfly-mcp"
+}

package/server.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json",
+  "name": "io.github.esimfly-official/esimfly-mcp",
+  "description": "eSIMfly Business API: search eSIM plans with wholesale prices, check usage, diagnose connectivity, and optionally order and top up eSIMs (two-step confirmation).",
+  "version": "0.1.0",
+  "websiteUrl": "https://docs.esimfly.net",
+  "repository": { "url": "https://github.com/eSimfly-Official/esimfly-mcp", "source": "github" },
+  "packages": [
+    {
+      "registryType": "npm",
+      "registryBaseUrl": "https://registry.npmjs.org",
+      "identifier": "@esimfly/mcp",
+      "version": "0.1.0",
+      "transport": { "type": "stdio" },
+      "runtimeHint": "npx",
+      "environmentVariables": [
+        { "name": "ESIMFLY_ACCESS_CODE", "description": "eSIMfly API access code (esf_...)", "isRequired": true, "isSecret": true },
+        { "name": "ESIMFLY_SECRET_KEY", "description": "eSIMfly API secret key (sk_...)", "isRequired": true, "isSecret": true },
+        { "name": "ESIMFLY_MCP_ALLOW_WRITES", "description": "Set to true to enable ordering, top-up, cancel, suspend, SMS and webhook tools", "isRequired": false, "isSecret": false }
+      ]
+    }
+  ]
+}