English Français العربية

TopSMS

Official registry Security

Czech SMS gateway: send and schedule SMS, OTP verification codes, delivery status and credit.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package topsms-mcp
Claude Code 
claude mcp add topsms -e 'TOPSMS_CLIENT_ID=<TOPSMS_CLIENT_ID>' -e 'TOPSMS_SECRET=<your topsms_secret>' -- npx -y topsms-mcp@1.1.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "topsms": {
            "command": "npx",
            "args": [
                "-y",
                "topsms-mcp@1.1.0"
            ],
            "env": {
                "TOPSMS_CLIENT_ID": "<TOPSMS_CLIENT_ID>",
                "TOPSMS_SECRET": "<your topsms_secret>"
            }
        }
    }
}

Environment variables

  • TOPSMS_CLIENT_ID required API key Client ID from the TopSMS dashboard (API klíče)
  • TOPSMS_SECRET required secret API key secret from the TopSMS dashboard

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. TopSMS MCP server
  2. Tools
  3. Setup
  4. Pricing
  5. Notes
  6. License

TopSMS MCP server

Send SMS from Claude, ChatGPT, Cursor and other AI assistants through TopSMS, a Czech SMS gateway for businesses (Czech Republic, Slovakia and 200+ countries).

Tools

ToolWhat it does
send_smsSend one SMS (number, text, optional Sender ID, optional send_at to schedule, optional idempotency key)
send_bulk_smsSame text to up to 500 numbers; over 50 recipients it is queued and returns a jobId
get_message_statusDelivery status of a message (queued, sent, delivered, failed, expired)
get_bulk_jobProgress of a queued bulk send
cancel_scheduledCancel a scheduled send (credit is returned)
verify_sendSend a one-time verification code (OTP) by SMS
verify_checkCheck the code the user entered
get_creditCredit balance in CZK and price per SMS
get_pricingPublic price list (no credentials needed)

Setup

  1. Create a free account at topsms.cz (10 free SMS).
  2. In the dashboard open API klíče (API keys), create a key with scopes send and read, copy the Client ID and Secret.
  3. Add the server to your MCP client.
Claude Desktop / Claude Code
{
  "mcpServers": {
    "topsms": {
      "command": "npx",
      "args": ["-y", "topsms-mcp"],
      "env": {
        "TOPSMS_CLIENT_ID": "your-client-id",
        "TOPSMS_SECRET": "your-secret"
      }
    }
  }
}

Claude Code: claude mcp add topsms -e TOPSMS_CLIENT_ID=... -e TOPSMS_SECRET=... -- npx -y topsms-mcp

Cursor, Windsurf, VS Code

Use the same command, args and env in the client's MCP configuration.

Pricing

0.88–0.98 CZK (≈ €0.036–0.040) per SMS to Czech and Slovak numbers, no monthly fees, credit never expires. EU 2 CZK, rest of world 3 CZK per segment. Full list: https://www.topsms.cz/pricing.json

Notes

  • Every send_* call spends real credit. AI clients usually ask for confirmation before calling tools; keep that enabled.
  • 160 characters without diacritics = 1 SMS, 70 with diacritics or emoji.
  • API docs: https://www.topsms.cz/api-integrace/rest-api · Support: info@topsms.cz

License

MIT

Frequently asked questions

What is TopSMS?

Czech SMS gateway: send and schedule SMS, OTP verification codes, delivery status and credit.

How do I install TopSMS?

It runs on your machine. In Claude Code: claude mcp add topsms -e 'TOPSMS_CLIENT_ID=<TOPSMS_CLIENT_ID>' -e 'TOPSMS_SECRET=<your topsms_secret>' -- npx -y topsms-mcp@1.1.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does TopSMS need an API key?

Yes. It expects TOPSMS_CLIENT_ID, TOPSMS_SECRET, which you set in its configuration.

Is TopSMS open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains TopSMS?

It is published by topsms-ghb. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.