Connect AI Assistants to 1001SMS
Use Claude, Cursor, Windsurf, or any MCP-compatible AI assistant to order virtual numbers, receive SMS codes, and manage activations directly from a conversation. No installation needed.
Open Standard
Model Context Protocol by Anthropic
Secure
HTTPS, no third-party access
Zero Install
Remote server, just add URL + key
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.
{
"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.
Create an API Key
Open your account menu → click API → create a new key with the activate permission.
Paste the Config
Copy the JSON above and paste it into your AI assistant's MCP configuration file.
Restart & Use
Restart your AI assistant. The 1001SMS tools will show up right away. Try asking "What's my balance?"
Available Tools
Once connected, your AI agent can use these tools through natural language.
get_balance
Check your account balance
get_profile
View full account profile
get_stats
Orders, success rate, totals
get_transactions
Transaction history with filters
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
Example Prompts
Try saying these to your AI agent once it's connected to 1001SMS.
Common Questions
Does using the MCP server cost extra?
No. The MCP server is free. It uses your existing 1001SMS balance just like the website or API. You only pay for the virtual numbers you order.
Which AI assistants are supported?
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.
Is my API key safe?
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.
Can the AI assistant spend my balance automatically?
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.
Do I need to install anything?
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.