MCP Integration

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

Get StartedLearn More

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

Copy

mcp-config.json

Copy

{ "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.

01

Create an API Key

Open your account menu → click API → create a new key with the activate permission.

02

Paste the Config

Copy the JSON above and paste it into your AI assistant's MCP configuration file.

03

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.

“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”

“Show my active numbers”

“Cancel all my active orders”

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.

Buy a numberMCP Server for SMS Activation by 1001SMS