virtualsms-mcp 1.0.0

package/ARCHITECTURE.md

@@ -0,0 +1,140 @@
+# VirtualSMS MCP Server — Architecture
+
+## Overview
+
+The VirtualSMS MCP server is a **stdio-transport MCP server** written in TypeScript. It wraps the VirtualSMS REST API and WebSocket gateway, exposing them as 11 MCP tools that AI agents can call directly.
+
+---
+
+## How MCP stdio Transport Works
+
+```
+Claude Desktop / Cursor
+        │
+        │ stdin/stdout (JSON-RPC 2.0)
+        ▼
+  virtualsms-mcp process (Node.js)
+        │
+        ├──► REST API calls (axios)
+        │       https://virtualsms.io/api/v1/
+        │
+        └──► WebSocket connection (ws)
+                wss://virtualsms.io/ws/orders
+```
+
+The MCP client (Claude Desktop, Cursor) spawns `virtualsms-mcp` as a child process and communicates via stdin/stdout using JSON-RPC 2.0. The server is persistent — it stays alive for the lifetime of the AI session, which is why it can hold WebSocket connections.
+
+**Important:** Never write to stdout except via the MCP SDK. Any `console.log()` would corrupt the JSON-RPC stream. Use `process.stderr` for debug output.
+
+---
+
+## Client → API Flow
+
+All REST calls go through `VirtualSMSClient` (src/client.ts):
+
+```
+Tool Handler → VirtualSMSClient → axios → https://virtualsms.io/api/v1/
+```
+
+The client:
+- Attaches `Authorization: Bearer {apiKey}` to all authenticated requests
+- Normalizes errors into human-readable messages
+- Handles 401/403 with clear "set VIRTUALSMS_API_KEY" guidance
+
+---
+
+## Auth Flow
+
+1. User sets `VIRTUALSMS_API_KEY=vms_xxxxx` in their MCP config
+2. On startup, the MCP server reads `process.env.VIRTUALSMS_API_KEY`
+3. Every API call includes `Authorization: Bearer vms_xxxxx`
+4. The backend validates the key by SHA-256 hash lookup in `api_keys` table
+5. For WebSocket, the key is passed as `?api_key=vms_xxxxx` query param
+
+---
+
+## WebSocket Connection Lifecycle (`wait_for_code`)
+
+```
+1. buy_number() → REST POST /api/v1/order → {order_id, phone_number}
+
+2. Connect WebSocket:
+   wss://virtualsms.io/ws/orders?order_id={id}&api_key={key}
+
+3. Server sends: {type: "connected", order_id: "...", phone_number: "...", status: "pending"}
+
+4. When SMS arrives, server pushes:
+   {type: "sms", code: "12345", full_text: "Your code is 12345", sender: "..."}
+
+5. MCP server resolves with the code, closes WebSocket.
+
+6. If WebSocket fails (network error, server unreachable):
+   → Fallback to polling GET /api/v1/order/{id} every 5s
+
+7. If timeout:
+   → Return {success: false, order_id: ...} so user can recover
+   → Do NOT cancel automatically (user may still want the code)
+```
+
+**Reconnect logic:** If the WebSocket disconnects unexpectedly (not on error/timeout), the client reconnects once after 1 second before falling back to polling.
+
+---
+
+## Error Handling Strategy
+
+All tool errors are wrapped as `McpError` to prevent server crashes:
+
+| Error type | McpError code |
+|------------|---------------|
+| Zod validation | `InvalidParams` |
+| Missing API key | `InvalidRequest` |
+| Network/API errors | `InternalError` |
+| Unknown tool name | `MethodNotFound` |
+
+This means the AI agent always gets a structured error it can act on, rather than a crash.
+
+---
+
+## File Structure
+
+```
+virtualsms-mcp/
+├── src/
+│   ├── index.ts      # MCP server setup, tool routing, startup
+│   ├── client.ts     # VirtualSMSClient — REST API wrapper
+│   └── tools.ts      # Tool definitions (schemas) + handlers
+├── dist/             # Compiled output (from tsc)
+│   ├── index.js      # Has #!/usr/bin/env node shebang
+│   ├── client.js
+│   └── tools.js
+├── package.json
+├── tsconfig.json
+├── README.md
+├── ROADMAP.md
+└── ARCHITECTURE.md
+```
+
+---
+
+## Adding a New Tool
+
+1. Add input schema (zod) to `src/tools.ts`
+2. Add tool definition to `TOOL_DEFINITIONS` array
+3. Add handler function `handleXxx()` to `src/tools.ts`
+4. Add case to switch in `src/index.ts`
+5. Export schema + handler from `src/tools.ts`
+6. `npm run build`
+
+---
+
+## Local Development
+
+```bash
+npm install
+npm run build          # compile TypeScript
+npm run dev            # watch mode (tsc --watch)
+node dist/index.js     # test startup (exits immediately — needs MCP client)
+
+# Test with MCP Inspector:
+npx @modelcontextprotocol/inspector node dist/index.js
+```

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 VirtualSMS
+
+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,270 @@
+# VirtualSMS MCP Server
+
+Receive SMS verification codes directly inside your AI agent workflows. Supports Claude Desktop, Cursor, and any MCP-compatible client.
+
+**Powered by [VirtualSMS.io](https://virtualsms.io)** — virtual phone numbers for SMS verification.
+
+---
+
+## Quick Start
+
+```bash
+npx virtualsms-mcp
+```
+
+Or install globally:
+
+```bash
+npm install -g virtualsms-mcp
+```
+
+Get your API key at [virtualsms.io](https://virtualsms.io).
+
+---
+
+## Configuration
+
+### Claude Desktop
+
+Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):
+
+```json
+{
+  "mcpServers": {
+    "virtualsms": {
+      "command": "npx",
+      "args": ["virtualsms-mcp"],
+      "env": {
+        "VIRTUALSMS_API_KEY": "vms_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### Cursor
+
+Edit `~/.cursor/mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "virtualsms": {
+      "command": "npx",
+      "args": ["virtualsms-mcp"],
+      "env": {
+        "VIRTUALSMS_API_KEY": "vms_your_api_key_here"
+      }
+    }
+  }
+}
+```
+
+### Environment Variables
+
+| Variable | Required | Default | Description |
+|----------|----------|---------|-------------|
+| `VIRTUALSMS_API_KEY` | Yes (for auth tools) | — | Your VirtualSMS API key |
+| `VIRTUALSMS_BASE_URL` | No | `https://virtualsms.io` | API base URL |
+
+---
+
+## Tools (11 total)
+
+### Discovery Tools (no auth required)
+
+#### `list_services`
+Get all available SMS verification services.
+
+```
+list_services()
+→ [{code: "telegram", name: "Telegram"}, ...]
+```
+
+#### `list_countries`
+Get all available countries for SMS verification.
+
+```
+list_countries()
+→ [{iso: "US", name: "United States"}, ...]
+```
+
+#### `check_price`
+Check price and availability for a service + country combination.
+
+```
+check_price(service: "telegram", country: "US")
+→ {price_usd: 0.15, available: true}
+```
+
+#### `find_cheapest`
+Find cheapest countries for a service, sorted by price.
+
+```
+find_cheapest(service: "telegram", limit: 5)
+→ {cheapest_options: [{country: "PK", price_usd: 0.05, ...}], total_available_countries: 23}
+```
+
+#### `search_service`
+Find the right service code using natural language.
+
+```
+search_service(query: "uber")
+→ {matches: [{code: "uber", name: "Uber", match_score: 1.0}]}
+```
+
+### Account Tools (API key required)
+
+#### `get_balance`
+Check your account balance.
+
+```
+get_balance()
+→ {balance_usd: 5.00}
+```
+
+#### `active_orders`
+List your active orders. **Essential for crash recovery.**
+
+```
+active_orders()
+active_orders(status: "pending")
+→ {count: 2, orders: [{order_id: "abc123", phone_number: "+14155552671", status: "pending", ...}]}
+```
+
+Optional `status` filter: `"pending"`, `"sms_received"`, `"cancelled"`, `"completed"`
+
+### Order Management Tools (API key required)
+
+#### `buy_number`
+Purchase a virtual phone number.
+
+```
+buy_number(service: "telegram", country: "US")
+→ {order_id: "abc123", phone_number: "+14155552671", expires_at: "...", status: "pending"}
+```
+
+#### `check_sms`
+Check if an SMS code has arrived for an order.
+
+```
+check_sms(order_id: "abc123")
+→ {status: "sms_received", phone_number: "+14155552671", sms_code: "12345", sms_text: "Your code is 12345"}
+```
+
+#### `cancel_order`
+Cancel an order and request a refund (only if no SMS received yet).
+
+```
+cancel_order(order_id: "abc123")
+→ {success: true, refunded: true}
+```
+
+#### `wait_for_code` ⭐ Recommended
+One-step tool: buys a number AND waits for the SMS code. Uses WebSocket for instant delivery with automatic polling fallback.
+
+```
+wait_for_code(service: "telegram", country: "US")
+wait_for_code(service: "whatsapp", country: "PK", timeout_seconds: 180)
+→ {
+    success: true,
+    phone_number: "+14155552671",
+    sms_code: "12345",
+    sms_text: "Your Telegram code: 12345",
+    order_id: "abc123",
+    delivery_method: "websocket",
+    elapsed_seconds: 8
+  }
+```
+
+On timeout, returns `order_id` for recovery:
+```
+→ {success: false, error: "timeout", order_id: "abc123", phone_number: "...", tip: "Use check_sms..."}
+```
+
+---
+
+## How It Works
+
+### WebSocket vs Polling
+
+`wait_for_code` uses a two-tier delivery system:
+
+1. **WebSocket (instant)** — connects to `wss://virtualsms.io/ws/orders?order_id=xxx` immediately after buying the number. When the SMS arrives, the server pushes it in real-time. Typical delivery: 2-15 seconds.
+
+2. **Polling fallback** — if WebSocket fails to connect or disconnects, automatically falls back to polling `GET /api/v1/order/{id}` every 5 seconds. Same result, slightly slower.
+
+The `delivery_method` field in the response tells you which was used.
+
+### Architecture
+
+```
+AI Agent (Claude/Cursor)
+    │
+    ▼ MCP stdio protocol
+VirtualSMS MCP Server (this package)
+    │
+    ├──► REST API: https://virtualsms.io/api/v1/
+    │        buy_number, check_sms, cancel_order, etc.
+    │
+    └──► WebSocket: wss://virtualsms.io/ws/orders
+             real-time SMS push delivery
+```
+
+---
+
+## Typical Workflows
+
+### Simple: Get a Telegram code
+```
+wait_for_code(service: "telegram", country: "US")
+```
+
+### Budget: Find cheapest option first
+```
+find_cheapest(service: "telegram", limit: 3)
+# → picks cheapest country
+wait_for_code(service: "telegram", country: "PK")
+```
+
+### Manual: Step by step
+```
+buy_number(service: "google", country: "GB")
+# → order_id: "abc123", phone: "+447911123456"
+
+# Use the phone number to trigger the SMS...
+
+check_sms(order_id: "abc123")
+# Poll until sms_code appears, or:
+cancel_order(order_id: "abc123")  # if taking too long
+```
+
+---
+
+## Crash Recovery
+
+If your MCP server crashes or the AI session is interrupted mid-verification:
+
+1. **Restart the MCP server** (it reconnects automatically)
+2. **List active orders:**
+   ```
+   active_orders(status: "pending")
+   ```
+3. **Check for codes:**
+   ```
+   check_sms(order_id: "abc123")
+   ```
+4. **Cancel if no longer needed:**
+   ```
+   cancel_order(order_id: "abc123")
+   ```
+
+The `wait_for_code` tool always returns `order_id` even on timeout — this is your recovery handle.
+
+---
+
+## License
+
+MIT — See [LICENSE](./LICENSE)
+
+Built with ❤️ by [VirtualSMS.io](https://virtualsms.io)

package/ROADMAP.md

@@ -0,0 +1,48 @@
+# VirtualSMS MCP Server — Roadmap
+
+Current version: **v1.0.0** — Core tools, WebSocket delivery, crash recovery.
+
+---
+
+## v1.1 — Smart Features
+
+- **`smart_verify`** — Auto-retry with different countries on failure. Finds cheapest country, buys number, waits for SMS, and if it times out, cancels and tries next country automatically. (Held from v1.0 pending refund mechanics verification.)
+- **`recommend_country`** — ML-based country recommendation based on historical success rate analytics per service.
+- **`price_compare`** — Show VirtualSMS price vs competitors for a given service/country.
+
+---
+
+## v1.2 — Batch & Automation
+
+- **`batch_verify`** — Buy multiple numbers in parallel for bulk verification workflows.
+- **`webhook_mode`** — Register a callback URL to receive SMS codes instead of waiting synchronously.
+- Notification preferences: get notified via email or Telegram when a code arrives.
+
+---
+
+## v1.3 — Multi-Provider Aggregation
+
+- Aggregate numbers across multiple upstream SMS providers.
+- Auto-route to cheapest/fastest provider based on real-time availability.
+- Unified service code mapping across providers (different providers use different codes for the same service).
+- Provider health monitoring — skip providers with high failure rates.
+
+---
+
+## v2.0 — Remote Transport
+
+- **SSE/Streamable HTTP transport** — zero-install, just add a URL to your MCP config.
+- Hosted at `https://mcp.virtualsms.io`.
+- OAuth2 auth flow for MCP clients (no more copying API keys).
+- Usage dashboard for MCP users — see spend, history, success rates.
+
+---
+
+## Future Ideas
+
+- **Number reputation scoring** — flag numbers with low verification success rates.
+- **Success rate analytics** — per-service, per-country historical success rates exposed via API.
+- **Rate limiting per API key tier** — different quotas for free, pro, enterprise.
+- **Rental numbers** — keep a number for days or weeks (not just one-time verification).
+- **Number recycling preferences** — opt out of recycled numbers for higher success rates.
+- **Operator filtering** — prefer specific carriers per country for higher deliverability.

package/dist/client.d.ts

@@ -0,0 +1,49 @@
+export interface Service {
+    code: string;
+    name: string;
+    icon?: string;
+}
+export interface Country {
+    iso: string;
+    name: string;
+    flag?: string;
+}
+export interface Price {
+    price_usd: number;
+    currency: string;
+    available: boolean;
+}
+export interface Balance {
+    balance_usd: number;
+}
+export interface Order {
+    order_id: string;
+    phone_number: string;
+    expires_at?: string;
+    status: string;
+    sms_code?: string;
+    sms_text?: string;
+}
+export interface CancelResult {
+    success: boolean;
+    refunded: boolean;
+}
+export declare class VirtualSMSClient {
+    private http;
+    private apiKey?;
+    private baseUrl;
+    constructor(baseUrl: string, apiKey?: string);
+    requireApiKey(): void;
+    listServices(): Promise<Service[]>;
+    listCountries(): Promise<Country[]>;
+    checkPrice(service: string, country: string): Promise<Price>;
+    getBalance(): Promise<Balance>;
+    createOrder(service: string, country: string): Promise<Order>;
+    getOrder(orderId: string): Promise<Order>;
+    cancelOrder(orderId: string): Promise<CancelResult>;
+    completeOrder(orderId: string): Promise<Order>;
+    listOrders(status?: string): Promise<Order[]>;
+    getApiKey(): string | undefined;
+    getBaseUrl(): string;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,KAAK;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,KAAK;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM;IA4C5C,aAAa,IAAI,IAAI;IASf,YAAY,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAKlC,aAAa,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAKnC,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAO5D,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;IAM9B,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAM7D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAMzC,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAQnD,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;IAQ9C,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAOnD,SAAS,IAAI,MAAM,GAAG,SAAS;IAI/B,UAAU,IAAI,MAAM;CAGrB"}

package/dist/client.js

@@ -0,0 +1,109 @@
+import axios from 'axios';
+export class VirtualSMSClient {
+    http;
+    apiKey;
+    baseUrl;
+    constructor(baseUrl, apiKey) {
+        this.apiKey = apiKey;
+        this.baseUrl = baseUrl;
+        this.http = axios.create({
+            baseURL: baseUrl,
+            timeout: 30000,
+            headers: {
+                'Content-Type': 'application/json',
+                'Accept': 'application/json',
+            },
+        });
+        // Add auth header if API key is set
+        this.http.interceptors.request.use((config) => {
+            if (this.apiKey) {
+                config.headers['Authorization'] = `Bearer ${this.apiKey}`;
+            }
+            return config;
+        });
+        // Handle errors gracefully
+        this.http.interceptors.response.use((res) => res, (err) => {
+            const status = err.response?.status;
+            const data = err.response?.data;
+            const message = data?.message || data?.error || err.message;
+            if (status === 401) {
+                throw new Error('Invalid API key. Get one at https://virtualsms.io');
+            }
+            else if (status === 402) {
+                throw new Error('Insufficient balance. Top up at https://virtualsms.io');
+            }
+            else if (status === 404) {
+                throw new Error(`Not found: ${message}`);
+            }
+            else if (status === 429) {
+                throw new Error('Rate limit exceeded. Please slow down requests.');
+            }
+            else if (status && status >= 500) {
+                throw new Error(`VirtualSMS server error (${status}). Please try again.`);
+            }
+            throw new Error(`API error: ${message}`);
+        });
+    }
+    requireApiKey() {
+        if (!this.apiKey) {
+            throw new Error('VIRTUALSMS_API_KEY is required for this operation. ' +
+                'Get your API key at https://virtualsms.io');
+        }
+    }
+    async listServices() {
+        const res = await this.http.get('/api/v1/services');
+        return res.data;
+    }
+    async listCountries() {
+        const res = await this.http.get('/api/v1/countries');
+        return res.data;
+    }
+    async checkPrice(service, country) {
+        const res = await this.http.get('/api/v1/price', {
+            params: { service, country },
+        });
+        return res.data;
+    }
+    async getBalance() {
+        this.requireApiKey();
+        const res = await this.http.get('/api/v1/balance');
+        return res.data;
+    }
+    async createOrder(service, country) {
+        this.requireApiKey();
+        const res = await this.http.post('/api/v1/order', { service, country });
+        return res.data;
+    }
+    async getOrder(orderId) {
+        this.requireApiKey();
+        const res = await this.http.get(`/api/v1/order/${orderId}`);
+        return res.data;
+    }
+    async cancelOrder(orderId) {
+        this.requireApiKey();
+        const res = await this.http.put(`/api/v1/order/${orderId}`, {
+            action: 'cancel',
+        });
+        return res.data;
+    }
+    async completeOrder(orderId) {
+        this.requireApiKey();
+        const res = await this.http.put(`/api/v1/order/${orderId}`, {
+            action: 'complete',
+        });
+        return res.data;
+    }
+    async listOrders(status) {
+        this.requireApiKey();
+        const params = status ? { status } : {};
+        const res = await this.http.get('/api/v1/orders', { params });
+        return res.data;
+    }
+    getApiKey() {
+        return this.apiKey;
+    }
+    getBaseUrl() {
+        return this.baseUrl;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * VirtualSMS MCP Server
+ * Receive SMS verification codes with AI agents
+ * https://virtualsms.io
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;GAIG"}