English Français العربية

TopSMS

Registre officiel Sécurité

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

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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
Configuration JSON (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>"
            }
        }
    }
}

Variables d'environnement

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que TopSMS ?

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

Comment installer TopSMS ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour TopSMS ?

Oui. Il attend TOPSMS_CLIENT_ID, TOPSMS_SECRET, à renseigner dans sa configuration.

TopSMS est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient TopSMS ?

Il est publié par topsms-ghb. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.