1001SMS

Setup

MCP Server Setup

Connect your AI agent to 1001SMS to purchase numbers, check SMS, and manage your account through natural language. Add the following configuration to your Claude Desktop, Claude Code, Cursor, or any MCP-compatible AI agent.

Three steps · about a minute

https://www.1001sms.com/api/mcp

{
  "mcpServers": {
    "1001sms": {
      "type": "streamableHttp",
      "url": "https://www.1001sms.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Replace YOUR_API_KEY with an API key from the section below, or create one in your Account → API settings.

Tools

Available Tools

Once connected, your AI agent can use these tools through natural language.

29 tools

Account

• get_balance Check your account balance
• get_profile View full account profile
• get_stats Orders, success rate, totals
• get_transactions Transaction history with filters

SMS activations

• list_services All available services
• list_countries All available countries
• get_pricing Real-time pricing by service & country
• order_number Purchase a virtual phone number
• check_sms Poll for received SMS + extract code
• get_order Full order details & message history
• cancel_order Cancel with automatic refund logic
• cancel_all_orders Bulk cancel all active orders
• list_active_orders All currently active orders
• order_history Past orders with date & status filters

Virtual numbers

• list_number_countries Countries where virtual numbers are sold
• get_number_pricing Terms and dedicated-service prices for a country
• order_virtual_number Rent a number for 12 hours to a year
• list_virtual_numbers Your virtual numbers with message counts
• get_virtual_number One number with its stored messages
• get_number_messages Fetch the inbox and extract codes
• renew_virtual_number Extend a number by one more term
• cancel_virtual_number Cancel within 2 hours for a refund

eSIMs

• list_esim_destinations Countries, regions and global plans
• list_esim_packages Data plans for a destination at retail
• quote_esim Price an order with its discounts
• order_esim Buy an eSIM and get the QR code
• list_esim_orders Your eSIM orders with profiles
• get_esim_order Activation code, ICCID and live usage

Prompts

Example Prompts

Try saying these to your AI agent once it's connected to 1001SMS.

• “What's my 1001SMS balance?”
• “How much does a US number cost for WhatsApp?”
• “Buy me a US number for Telegram from MAIN provider”
• “Check SMS on my latest order”
• “Rent a UK number for 30 days that works with every app”
• “Buy a 7-day eSIM for Spain and show me the QR code”

FAQ

Common Questions

Does using the MCP server cost extra?

Which AI assistants are supported?

Is my API key safe?

Can the AI assistant spend my balance automatically?

Do I need to install anything?

Prefer plain REST?

The same account works over the REST API: keys, webhooks and JSON built for scripts and SDKs.

POST /api/v1/activations/order

GET /api/v1/activations/:id

GET /api/v1/pricing