Connect AI Assistants
to 1001SMS
Use Claude, Cursor, Windsurf, or any MCP-compatible AI assistant to receive SMS codes, rent virtual numbers, buy eSIM data plans and manage your account directly from a conversation. No installation needed.
- Open Standard
- Secure
- Zero Install
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.
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.
Available Tools
Once connected, your AI agent can use these tools through natural language.
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
- get_number_renewal_options
Renewal terms, priced today
- 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
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”
Common Questions
No. The MCP server is free. It uses your existing 1001SMS balance just like the website or API. You only pay for the numbers and eSIM plans you order.
Any assistant that supports the Model Context Protocol (MCP) with Streamable HTTP transport. This includes Claude Desktop, Claude Code, Cursor, Windsurf, and others. The list is growing fast.
Yes. Your API key is sent directly from your AI assistant to 1001SMS servers over HTTPS. It is never stored or shared with any third party.
Only when you ask it to. The AI assistant will always tell you what it plans to do before calling tools like order_number. You stay in full control of every purchase.
No. The 1001SMS MCP server runs remotely. Just add the URL and API key to your AI assistant config and restart. No downloads, no builds, no Node.js needed.
Prefer plain REST?
The same account works over the REST API: keys, webhooks and JSON built for scripts and SDKs.
Telegram channel