TopSMS
European SMS gateway with no monthly fee: REST API, Verify API for OTP, and an MCP server for Claude, ChatGPT and Cursor. From €0.082 per SMS to Germany, Austria and most of the EU, credit never expires.
Hosted MCP Server
npx add-mcp 'https://topsms.eu/api/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
MCP server for SMS
One sentence, one tool call
Type what you would ask your assistant. Below you see which tool it calls on your TopSMS account and what comes back.
The assistant calls
get_credit
Arguments
{}
Server response
{
"ok": true,
"credit": 12.4,
"currency": "EUR",
"smsPrice": 0.082
}
The assistant replies
You have €12.40 of credit. One SMS costs €0.082.
Sample data. Tool, argument and response field names are the real ones.
What it can do
- send_sms sends an SMS to one number, optionally with your sender name, immediately or scheduled (
send_at) - send_bulk_sms the same text to up to 500 numbers, large batches are queued
- get_message_status delivery status of a message, including the non-delivery reason
errorCode - get_bulk_job the progress of a batch
- cancel_scheduled cancels a scheduled send and refunds the credit
- verify_send sends a verification code (OTP), see the Verify API
- verify_check checks the verification code
- get_credit credit balance and price per SMS
- get_pricing public price list (no login required)
The server calls the same REST API as your application, so the same prices, limits and billing rules apply. The sending tools accept an optional idempotencyKey: when the assistant repeats a call, the SMS is not sent twice. Package: npmjs.com/package/topsms-mcp.
For coding agents there are also open-source TopSMS Skills: they teach the agent the API (sending, webhooks, OTP, SMS length), while this server does the sending. Overview and one-command install for Claude Code: SMS for AI agents.
Connect Claude or ChatGPT, no API key
The server runs at https://topsms.eu/api/mcp and supports sign-in with OAuth. You paste the URL, sign in to your TopSMS account and click Allow on the consent screen; no key to copy. Accounts from www.topsms.cz can also use https://www.topsms.cz/api/mcp.
Claude (claude.ai or the Claude app), step by step
- Open Settings → Connectors, then click Add custom connector.
- Add Name:
TopSMS, URL:https://topsms.eu/api/mcp. Leave OAuth Client ID and Secret empty and click Add. - Connect Click Connect. The TopSMS sign-in page opens; sign in with your TopSMS account.
- Allow On the consent screen check the app name and click Allow. You are sent back to Claude.
- Ask The connector lists the TopSMS tools. In a chat, turn TopSMS on in the tools menu and ask, for example: How much credit do I have?
If the custom connector option is missing, it depends on your Claude plan or your organisation’s settings.
ChatGPT
Settings → Apps & Connectors, turn on Developer mode in the advanced settings, create a connector with the same URL and OAuth authentication, sign in, Allow. Developer mode is available on some ChatGPT plans only.
Claude Code
claude mcp add --transport http topsms https://topsms.eu/api/mcp, then /mcp and sign in in the browser. Or install the TopSMS plugin, which adds this server and the Skills in one step.
Each connection appears in the dashboard under API access as the key OAuth: app name with an OAUTH badge. Revoke it and the assistant is disconnected. Credit, sender rules and rate limit are the same as for an API key. Step by step with example prompts: Send SMS from Claude and ChatGPT.
Sample data
Sample data
Remote MCP with an API key
For clients without sign-in, such as Cursor, use the same address with your API key as the header Authorization: Bearer CLIENT_ID:SECRET (MCP transport Streamable HTTP, no Node.js needed). Prices, limits, test keys and the request log are the same as for the REST API. A test key sends and charges nothing, so this is also the way to try the tools first.
Claude Desktop: use the npm package below, or a bridge such as mcp-remote that can send headers. Recipes for n8n, Zapier and Make: Automations and AI agents.
# Claude Code
claude mcp add --transport http topsms https://topsms.eu/api/mcp \
--header "Authorization: Bearer CLIENT_ID:SECRET"
# Cursor (~/.cursor/mcp.json) and other clients with remote MCP
{
"mcpServers": {
"topsms": {
"url": "https://topsms.eu/api/mcp",
"headers": { "Authorization": "Bearer CLIENT_ID:SECRET" }
}
}
}
# Any client / raw HTTP (JSON-RPC 2.0)
curl -X POST https://topsms.eu/api/mcp \
-H "Authorization: Bearer CLIENT_ID:SECRET" -H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Installing the npm package
For Claude Desktop, Cursor and others: in the dashboard, under API keys, create a key with the scopes send and read and add this to your MCP client configuration:
You need Node.js 18 or newer. Cursor, Windsurf and VS Code use the same configuration format.
{
"mcpServers": {
"topsms": {
"command": "npx",
"args": ["-y", "topsms-mcp"],
"env": {
"TOPSMS_CLIENT_ID": "your-client-id",
"TOPSMS_SECRET": "your-secret"
}
}
}
}
Claude Code with a single command:
claude mcp add topsms -e TOPSMS_CLIENT_ID=... -e TOPSMS_SECRET=... -- npx -y topsms-mcp
Security and costs
| Credit | Every send uses real credit. Keep tool-call confirmation enabled in your client, so the assistant asks before sending. |
|---|---|
| Consent | Signing in shows a consent screen with the app name and what it may do (send SMS and spend credit, read credit and message status). Your password stays on TopSMS. |
| Own key | Each assistant gets its own key, from sign-in or created by you. In the dashboard you see its usage separately and can revoke it at any time. |
| npm package | With the npm package the key stays on your computer in the client configuration; the package sends it only to www.topsms.cz. |
| Without AI | For recurring automations that need no AI, Make or the REST API is the better fit. |
Sample data
Try it with €0.50 free credit
Free account, active as soon as you confirm your mobile number. No credit card, no monthly fee, prepaid credit that never expires.