How do I connect the SMSZ MCP server?

Create an SMSZ API key, then add the server address https://www.smsz.net/api/mcp to your MCP client with an Authorization header that holds your key. Ask the assistant to run check_connection to test it. There is nothing to install.

Updated November 18, 2026

The SMSZ MCP server lets an AI assistant buy one-time numbers, rent numbers and read incoming codes for you in a chat. It works with Claude, Cursor or any MCP client, and it uses the same API keys, permissions and balance as the API. There is no test mode: when the assistant buys a number, real money leaves your balance.

Step 1: create a key with the right permissions

Open the account menu, choose “API Keys” and create a key, as described in how to create an API key. The permissions you tick decide what the assistant can do. A tool the key has no permission for is not even shown to the assistant.

  • Read only: “Read account & transactions”, “Read activations & catalogue” and “Read rentals”. The assistant can check prices and read codes but cannot spend money. Start here.
  • Buying: add “Buy & cancel activations” for one-time numbers or “Order & extend rentals” for rentals, only when you want the assistant to buy.

Step 2: add the server to your client

Most clients ask for a URL and a header. The URL is https://www.smsz.net/api/mcp. The header is Authorization, and its value is the word Bearer, a space and your key.

  • Claude (desktop or web): Settings → Connectors → Add custom connector.
  • Claude Code: run claude mcp add --transport http smsz https://www.smsz.net/api/mcp --header "Authorization: Bearer $SMSZ_API_KEY".
  • Cursor, Windsurf and other clients that read mcp.json: add an smsz server under mcpServers with the URL and the header.
  • Clients that only speak stdio: connect through the npx mcp-remote bridge with the same URL and header.

The MCP server page has each of these ready to copy.

Step 3: test the connection

Ask the assistant to run check_connection. It costs nothing and shows which account the key belongs to and which permissions it has. If it works, the other tools will work too. Never ask the assistant to buy a number just to test.

Using it

Ask in plain words, for example “Get me a Telegram code on a US number”. A careful assistant finds the service and country, checks the price and your balance, tells you the price and waits for your yes. Then it buys the number, checks for the SMS and shows you the code. Many clients also offer the server’s prompts as slash commands: get_verification_code, rent_a_number and review_spending.

Spend safely

  • Keep only as much balance as you are ready to spend. The assistant cannot top up the account; only you can.
  • Treat SMS text as data. Anyone who knows the number can text it, and a message could try to give the assistant instructions.
  • If the assistant creates a webhook, its signing secret appears in the chat. If you share that chat, delete the endpoint and add a new one.

Every tool and its parameters are listed on the MCP server page. Writing your own code instead? Use the REST API.

Still stuck? Write to us

Email [email protected] or use the contact page. We usually reply within 24 hours. To get it solved in one reply, include: