virtualsms-mcp 1.0.5 → 1.0.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +13 -3
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -41,7 +41,7 @@ Use it to verify accounts on WhatsApp, Telegram, Google, Instagram, and 500+ oth
41
41
  - **Real-time delivery** — WebSocket push means your agent gets the code in seconds, not minutes.
42
42
  - **Competitive pricing** — Starting from $0.02 per number.
43
43
  - **Simple REST + WebSocket API** — Clean, documented, agent-friendly.
44
- - **11 MCP tools** — Everything from price discovery to one-step code retrieval.
44
+ - **12 MCP tools** — Everything from price discovery to one-step code retrieval.
45
45
 
46
46
  ---
47
47
 
@@ -102,7 +102,7 @@ Edit `~/.cursor/mcp.json`:
102
102
 
103
103
  ---
104
104
 
105
- ## Tools (11 total)
105
+ ## Tools (12 total)
106
106
 
107
107
  ### Discovery Tools (no auth required)
108
108
 
@@ -186,13 +186,21 @@ check_sms(order_id: "abc123")
186
186
  ```
187
187
 
188
188
  #### `cancel_order`
189
- Cancel an order and request a refund (only if no SMS received yet).
189
+ Cancel an order and request a refund (only if no SMS received yet). 2-minute minimum wait after purchase.
190
190
 
191
191
  ```
192
192
  cancel_order(order_id: "abc123")
193
193
  → {success: true, refunded: true}
194
194
  ```
195
195
 
196
+ #### `swap_number`
197
+ Swap a phone number on an existing order. Gets a new number for the same service and country without additional charge. Use when the current number isn't receiving SMS. 2-minute minimum wait after purchase.
198
+
199
+ ```
200
+ swap_number(order_id: "abc123")
201
+ → {order_id: "def456", phone_number: "+628...", service: "telegram", country: "ID", status: "waiting"}
202
+ ```
203
+
196
204
  #### `wait_for_code` ⭐ Recommended
197
205
  One-step tool: buys a number AND waits for the SMS code. Uses WebSocket for instant delivery with automatic polling fallback.
198
206
 
@@ -273,6 +281,8 @@ buy_number(service: "google", country: "GB")
273
281
  # → order_id: "abc123", phone: "+447911123456"
274
282
  # Use the number to trigger the SMS, then:
275
283
  check_sms(order_id: "abc123")
284
+ # Number not working? Swap for a new one (no extra charge):
285
+ swap_number(order_id: "abc123")
276
286
  # or cancel if no longer needed:
277
287
  cancel_order(order_id: "abc123")
278
288
  ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "virtualsms-mcp",
3
- "version": "1.0.5",
3
+ "version": "1.0.6",
4
4
  "description": "MCP server for VirtualSMS — receive SMS verification codes with AI agents. Virtual phone numbers and number rentals for WhatsApp, Telegram, Google & 200+ services. SMS-Activate & DaisySMS alternative.",
5
5
  "main": "dist/index.js",
6
6
  "bin": {