ConnectMeGuru MCP Server
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:
{
"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:
{
"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:
{
"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:
{
"type": "object",
"properties": {}
}
3. validate_coupon
Validates a discount coupon code for checkout. User login is mandatory to validate a coupon.
Input Schema:
{
"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:
{
"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:
{
"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:
{
"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:
{
"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:
{
"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:
{
"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:
{
"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:
{
"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:
{
"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:
{
"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.