# connectmeguru-mcp [Verified] [Health: Active]

**Category:** 💬 Communication  
**Repository:** https://github.com/vineetgoyalhuf/connectmeguru-mcp  
**GitHub Stars:** 1  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/connectmeguru-mcp

## Description
Official MCP server for searching ConnectMeGuru international eSIM plans, validating coupons, checking wallet balances, purchasing eSIMs and top-ups, managing orders, and retrieving usage and installation details.

## Claude Desktop Quick Installation
Remote MCP endpoint (confidence: high). Install path detected from listing signals. Add as a URL/SSE server in your client:

```json
"mcpServers": {
  "connectmeguru-mcp": {
    "url": "https://www.connectmeguru.com/api/mcp"
  }
}
```

## Documentation & README

# ConnectMeGuru MCP Server

[![AllMCPs Verified](https://allmcps.com/api/badge/connectmeguru-mcp?theme=light)](https://allmcps.com/mcp/connectmeguru-mcp?verify=ae946245-8c09-449d-80b5-644c325fbb73)
[![Featured on ConfettiSaaS](https://confettisaas.com/badge-dark.svg)](https://confettisaas.com)

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.