# MonoEsim MCP server

> Search, compare and order travel data eSIMs for 190+ countries and regions, with prices in EUR.

- Listing: https://mcp.tc/i/monoesim
- Connect: use the server's own URL `https://www.monoesim.app/mcp` (no sign-in); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: none
- Category: [E-commerce](https://mcp.tc/c/ecommerce)
- Vendor: MonoEsim
- Homepage: <https://www.monoesim.app>

## About

MonoEsim connects an assistant to a travel eSIM shop. It can list destinations, search and compare data plans, check phone eSIM compatibility, read purchase terms, prepare a price quote, create a Stripe Checkout link and track order delivery. Sandbox tools cover machine wallets and saved-card authorizations for autonomous purchases.

The hosted endpoint runs over streamable HTTP. No sign-in or API key is needed for searching and quoting. Sandbox wallet and card tools use a machine API key returned by register\_machine. Human purchases are paid by the customer through a Stripe Checkout link, after explicit consent to the terms.

## What it can do

- List eSIM destinations by country or region
- Search plans by days, data, budget and unlimited
- Compare 2 to 10 plans by price, price per GB and validity
- Check phone eSIM compatibility
- Prepare a locked 30 minute price quote
- Create a customer-paid Stripe Checkout link
- Track order and delivery status
- Manage sandbox wallets and saved-card permissions

## Tools (26)

- `search_plans`: Find eSIM plans for a destination with filters for days, data, budget and sort. (read-only)
- `list_destinations`: List offered countries and regions with starting EUR prices. (read-only)
- `get_plan`: Get current details for one plan by plan\_id. (read-only)
- `compare_plans`: Compare 2 to 10 plans by price, price per GB and validity. (read-only)
- `check_device`: Look up a phone model's probable eSIM compatibility. (read-only)
- `get_terms`: Get purchase terms and legal links in en, de, ru or uk. (read-only)
- `prepare_order`: Create a signed quote that locks the price for 30 minutes. (read-only)
- `create_checkout`: Create a customer-paid Stripe Checkout link from a quote.
- `get_order`: Get payment and delivery status using order\_id and order\_token. (read-only)
- `payment_capabilities`: List payment methods with enabled or planned status and requirements. (read-only)
- `purchase`: Start a purchase from a quote using a chosen buyer mode and payment method.
- `card_payment_terms`: Read the consent version and conditions for saved-card authorization. (read-only)
- `create_card_authorization`: Create a sandbox Stripe SetupIntent with spending limits after saved-card consent.
- `sync_card_authorization`: Reconcile a completed card setup with Stripe and activate the permission.
- `revoke_card_authorization`: Revoke a machine's saved-card spending permission. (can modify or delete data)
- `sync_card_payment`: Reconcile a saved-card purchase and resume pending charges or required authentication.
- `register_machine`: Create a sandbox machine identity with a zero-EUR test wallet and API key.
- `get_wallet`: Read sandbox wallet balance, limits and ledger entries. (read-only)
- `set_wallet_limits`: Set per-purchase and per-day sandbox spending limits in EUR cents.
- `fund_wallet`: Create a Stripe test Checkout to fund the sandbox wallet.
- `revoke_machine`: Permanently disable the sandbox machine's API key. (can modify or delete data)
- `register_affiliate`: Register this AI agent as a MonoEsim affiliate (call WITHOUT an API key).
- `get_affiliate`: Read your affiliate account with your API key: state (awaiting\_owner\_confirmation, active, pending\_review, blocked), referral link and ?ref= code, QR image, clicks and sales, balance in EUR (available, on hold… (read-only)
- `get_referral_link`: Build your tracked link (requires an active affiliate key): pass plan\_id for a plan page with the plan preselected, destination (country, city, region or ISO-2) for a destination page, or nothing for your partner… (read-only)
- `list_affiliate_sales`: List sales made through your referral link (latest first, 50 per page): date, destination, plan, amount, refunds, your commission and its state (held, available, settled, void). (read-only)
- `request_payout`: Ask MonoEsim to pay out your available commission (requires an active affiliate key, available balance at or above the minimum and the owner's completed payout setup).

## Example prompts

- "Find a 10 GB eSIM for 10 days in Japan under 15 EUR"
- "Compare these two eSIM plans for my trip to Italy"
- "Will my iPhone 12 mini work with an eSIM?"
- "Show the purchase terms for the eSIM in English"

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport http monoesim https://www.monoesim.app/mcp
```

2. Start Claude Code and type `/mcp`. **monoesim** should show as connected.

Add `--scope user` to make it available in every project, not just this one.

### Claude Desktop

1. Open **Customize → Connectors**, click **+ Add**, then **Add custom connector**.

2. Name it **MonoEsim** and paste this URL:

```url
https://www.monoesim.app/mcp
```

3. Click **Add**. Its tools appear in the chat’s tools menu.

Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

### claude.ai

1. Open the connector form on claude.ai. This button fills in the name and URL for you:

[Add to claude.ai](<https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=MonoEsim&connectorUrl=https%3A%2F%2Fwww.monoesim.app%2Fmcp>) (opens connector settings)

2. Check that the URL reads `https://www.monoesim.app/mcp` and click **Add**.

3. Turn it on in a chat from the tools menu.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.

### ChatGPT

1. On chatgpt.com, go to **Plugins**, select **+**, then **Add custom MCP server**.

2. Enter a name for the server.

3. Under **Connection**, paste `https://www.monoesim.app/mcp` as the server URL, then for authentication choose **No authentication**.

4. Check **I understand and want to continue**, then select **Create as a plugin**.

Whether you can add a custom MCP server depends on your ChatGPT plan and your workspace permissions (in Business workspaces, admins and owners can).

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=monoesim&config=eyJ1cmwiOiJodHRwczovL3d3dy5tb25vZXNpbS5hcHAvbWNwIn0%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "monoesim": {
      "url": "https://www.monoesim.app/mcp"
    }
  }
}
```

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=monoesim&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fwww.monoesim.app%2Fmcp%22%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"monoesim","type":"http","url":"https://www.monoesim.app/mcp"}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "monoesim": {
      "type": "http",
      "url": "https://www.monoesim.app/mcp"
    }
  }
}
```

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "monoesim": {
      "serverUrl": "https://www.monoesim.app/mcp"
    }
  }
}
```

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.

### Codex

```bash
codex mcp add monoesim --url https://www.monoesim.app/mcp
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.monoesim]
url = "https://www.monoesim.app/mcp"
```

### Gemini CLI

```bash
gemini mcp add --transport http monoesim https://www.monoesim.app/mcp
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.

```json
{
  "mcpServers": {
    "monoesim": {
      "type": "http",
      "url": "https://www.monoesim.app/mcp"
    }
  }
}
```

Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.

Client only starts local servers? Bridge it with `npx -y mcp-remote https://www.monoesim.app/mcp`.

## Recent changes

- 2026-11-11 02:45 UTC: New version 1.5.0 (was 1.4.0), reported by the server. Source: automatic check.
- 2026-11-11 02:45 UTC: 5 tools added and 8 tools changed. Server instructions changed. Source: automatic check. Worth a look: new server instructions. Added: get\_affiliate, get\_referral\_link, list\_affiliate\_sales, register\_affiliate, request\_payout. Changed: compare\_plans, create\_checkout, get\_plan, get\_terms, list\_destinations, prepare\_order, purchase, search\_plans.
- 2026-11-09 14:49 UTC: 8 tools changed. Source: automatic check. Changed: compare\_plans, create\_checkout, get\_plan, get\_terms, list\_destinations, prepare\_order, purchase, search\_plans.
- 2026-11-09 05:43 UTC: 8 tools changed. Source: automatic check. Changed: compare\_plans, create\_checkout, get\_plan, get\_terms, list\_destinations, prepare\_order, purchase, search\_plans.
- 2026-11-08 17:54 UTC: Server instructions changed. Source: automatic check. Worth a look: new server instructions.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/monoesim#history (Atom feed: https://mcp.tc/i/monoesim/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 1.5.0
- MCP protocol version: 2025-06-18
- Last checked: 2026-11-12 (reachable)
- Listed: 2026-11-02
- Updated: 2026-11-11

---
Source: https://mcp.tc/i/monoesim (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
