ConnectMeGuru eSIM Server

io.github.vineetgoyalhufv1.0.0Updated Oct 4, 2026

Official ConnectMeGuru MCP server: search 190+ travel eSIM data plans and buy in-chat.

VerifiedStreamable HTTPWeb executableBusiness & CommerceLocation & Lifestyle

Overview

AI-generated overview

Lets an assistant search travel eSIM data plans, authenticate by email OTP, and buy or top up eSIMs in chat using a prepaid wallet.

What it does
ConnectMeGuru is the official remote MCP server for prepaid international travel eSIMs. It exposes 13 tools: catalog search across 190+ countries, a grounding knowledge base, coupon validation, checkout link generation, email OTP authentication, wallet balance lookup, in-chat eSIM purchase, order history with ICCIDs and QR codes, carrier usage refresh, order cancellation, and top-up plan lookup and purchase.
When to use it
Use it when a traveler wants to compare or buy prepaid mobile data plans for a destination inside a chat, check remaining data on an active eSIM, or top up an existing eSIM. It suits conversational travel and connectivity assistance rather than general web tasks.
Requirements
A remote MCP endpoint; no local package install is required, though the README also shows an optional local npx route. A customer email address is needed for OTP login, and a session token returned by verify_agent_otp is required for wallet, order, usage, cancellation and top-up tools. A pre-funded USD wallet balance is needed for in-chat purchases.
Before you install
Purchases and top-ups spend real money from a pre-funded USD wallet, and cancel_order changes order state. The server handles customer email addresses, session tokens, order history, ICCIDs and eSIM QR codes, so treat the token as a credential and avoid sharing it. Coupon validation requires login. Confirm package, price and destination before authorizing any purchase.

Installation

In SourceWeft

  1. Open ConnectMeGuru eSIM Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "connectmeguru-mcp": {
      "type": "http",
      "url": "https://www.connectmeguru.com/api/mcp"
    }
  }
}

README

ConnectMeGuru MCP Server

[AllMCPs Verified] [Featured on ConfettiSaaS]

ConnectMeGuru is the official Model Context Protocol (MCP) server for instant prepaid international travel eSIMs across 190+ countries and territories. This server bridges AI coding assistants and conversational agents (such as Claude Code, Claude Desktop, Cursor, VS Code, and Grok) directly to live telecommunication networks. With ConnectMeGuru MCP, AI agents can search live prepaid mobile data catalogs, compare regional plans, validate checkout coupons, manage pre-funded USD wallet balances, and securely provision instant eSIM QR codes directly inside conversational workflows with zero roaming fees.

🚀 Quick Start (Remote Gateway - Option A)

You do not need to install any packages locally to use this server. You can connect directly to the public remote gateway.

Add the following to your claude_desktop_config.json file:

json
{  "mcpServers": {    "connectmeguru": {      "command": "npx",      "args": [        "-y",        "mcp-remote",        "https://www.connectmeguru.com/api/mcp"      ]    }  }}

Restart Claude Desktop after saving the configuration.

🛠️ Local Installation (Option B)

If you prefer to run the MCP server locally on your machine:

1. Configure configuration file

Add this server to your claude_desktop_config.json:

json
{  "mcpServers": {    "connectmeguru": {      "command": "npx",      "args": [        "-y",        "connectmeguru-mcp"      ]    }  }}

🔑 Callable MCP Tools & Schemas

The server exposes 13 callable tools adhering strictly to the Model Context Protocol specifications:

1. get_esim_catalog

Queries active international travel eSIM data plans. Optionally filter by country code (e.g. JP, US, FR) or search query keywords.

Input Schema:

json
{  "type": "object",  "properties": {    "country": {      "type": "string",      "description": "Destination name, country code, or query keywords to refine results (e.g. JP, Japan, Japan 100MB, Europe 10GB, USA 30 Days)."    }  },  "required": ["country"]}

2. get_knowledge_base

Retrieves the official ConnectMeGuru grounding knowledge base, including installation guides, device compatibility, refund policies, and support escalation workflows.

Input Schema:

json
{  "type": "object",  "properties": {}}

3. validate_coupon

Validates a discount coupon code for checkout. User login is mandatory to validate a coupon.

Input Schema:

json
{  "type": "object",  "properties": {    "code": {      "type": "string",      "description": "The coupon code to validate (e.g. WELCOME10)."    },    "packageCode": {      "type": "string",      "description": "The eSIM package code to check applicability for."    },    "token": {      "type": "string",      "description": "The secure session token returned by verify_agent_otp."    }  },  "required": ["code", "packageCode", "token"]}

4. get_checkout_url

Generates a secure checkout and purchase link for a specific eSIM package.

Input Schema:

json
{  "type": "object",  "properties": {    "packageCode": {      "type": "string",      "description": "The package code of the eSIM (e.g. PIK0SW14Q)."    },    "discountCode": {      "type": "string",      "description": "Optional coupon code to pre-apply (e.g. WELCOME10)."    }  },  "required": ["packageCode"]}

5. send_agent_otp

Sends a 6-digit OTP code to the customer's email address for in-chat authentication.

Input Schema:

json
{  "type": "object",  "properties": {    "email": {      "type": "string",      "description": "The email address of the customer."    }  },  "required": ["email"]}

6. verify_agent_otp

Verifies the email OTP code and returns a session token for wallet purchases.

Input Schema:

json
{  "type": "object",  "properties": {    "email": {      "type": "string",      "description": "The email address of the customer."    },    "code": {      "type": "string",      "description": "The 6-digit OTP code entered by the user."    }  },  "required": ["email", "code"]}

7. get_wallet_balance

Retrieves the user's current pre-funded USD wallet balance. Requires a valid session token.

Input Schema:

json
{  "type": "object",  "properties": {    "token": {      "type": "string",      "description": "The secure session token returned by verify_agent_otp."    }  },  "required": ["token"]}

8. purchase_esim_with_wallet

Purchases an eSIM package directly in chat using the user's wallet balance. If balance is insufficient, returns a magic link to top-up.

Input Schema:

json
{  "type": "object",  "properties": {    "packageCode": {      "type": "string",      "description": "The package code of the eSIM (e.g. PIK0SW14Q)."    },    "token": {      "type": "string",      "description": "The secure session token returned by verify_agent_otp."    },    "discountCode": {      "type": "string",      "description": "Optional coupon code (e.g. WELCOME10)."    }  },  "required": ["packageCode", "token"]}

9. get_user_orders

Retrieves complete customer order history, active ICCIDs, and installation QR codes. Requires a valid session token.

Input Schema:

json
{  "type": "object",  "properties": {    "token": {      "type": "string",      "description": "The secure session token returned by verify_agent_otp."    }  },  "required": ["token"]}

10. refresh_esim_usage

Requests a real-time data usage update for an active eSIM from the carrier. Requires a valid session token.

Input Schema:

json
{  "type": "object",  "properties": {    "iccid": {      "type": "string",      "description": "The ICCID number of the eSIM."    },    "token": {      "type": "string",      "description": "The secure session token returned by verify_agent_otp."    }  },  "required": ["iccid", "token"]}

11. cancel_order

Cancels an eligible eSIM order before activation/provisioning. Requires a valid session token.

Input Schema:

json
{  "type": "object",  "properties": {    "orderId": {      "type": "string",      "description": "The ID of the order to cancel."    },    "token": {      "type": "string",      "description": "The secure session token returned by verify_agent_otp."    }  },  "required": ["orderId", "token"]}

12. get_topup_packages

Queries eligible data top-up plans for an existing active eSIM. Requires a valid session token.

Input Schema:

json
{  "type": "object",  "properties": {    "iccid": {      "type": "string",      "description": "The ICCID number of the eSIM."    },    "token": {      "type": "string",      "description": "The secure session token returned by verify_agent_otp."    }  },  "required": ["iccid", "token"]}

13. purchase_topup

Completes an in-chat eSIM top-up purchase using the pre-funded wallet balance. Requires a valid session token.

Input Schema:

json
{  "type": "object",  "properties": {    "packageCode": {      "type": "string",      "description": "The package code of the top-up plan."    },    "iccid": {      "type": "string",      "description": "The ICCID of the eSIM to recharge."    },    "token": {      "type": "string",      "description": "The secure session token returned by verify_agent_otp."    }  },  "required": ["packageCode", "iccid", "token"]}

📄 License

MIT License. Created by ConnectMeGuru.

Source: README.md at commit c1a9c0a

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v1.0.0LatestOct 4, 2026