Back to Browse

Topsms MCP Server

Developer ToolsModerate5.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

5.2
Moderate5.2Moderate Risk

This is a well-structured MCP server for the TopSMS SMS gateway with proper authentication, input validation, and error handling. Credentials are correctly managed via environment variables. The main concern is that all tools that spend credit are accessible without additional authorization checks, which is mitigated by the note that AI clients typically ask for confirmation. The server's permissions match its stated purpose of sending SMS and checking account status. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

4 files analyzed · 8 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

API key Client ID from the TopSMS dashboard (API klíče)Optional

Environment variable: TOPSMS_CLIENT_ID

API key secret from the TopSMS dashboardRequired

Environment variable: TOPSMS_SECRET

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-topsms-ghb-topsms-mcp": {
      "env": {
        "TOPSMS_SECRET": "your-topsms-secret-here",
        "TOPSMS_CLIENT_ID": "your-topsms-client-id-here"
      },
      "args": [
        "-y",
        "topsms-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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

License

MIT

Reviews

No reviews yet

Be the first to review this server!