TopSMS

Name: TopSMS
Author: topsms-ghb

@topsms-ghbMCP server · External

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

Messaging appsv1.1.0MITJavaScript

Freeno charge per call

How to install

Runs on your machine from its package; the steps are below.

What it does

Reads
Writes
High impact

Not assessed yet.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

npmtopsms-mcpv1.1.0

Run

npx -y topsms-mcp

MCP client config

{
  "mcpServers": {
    "topsms": {
      "command": "npx",
      "args": [
        "-y",
        "topsms-mcp"
      ]
    }
  }
}

README2 min readView on GitHub

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

Tool	What it does
`send_sms`	Send one SMS (number, text, optional Sender ID, optional `send_at` to schedule, optional idempotency key)
`send_bulk_sms`	Same text to up to 500 numbers; over 50 recipients it is queued and returns a `jobId`
`get_message_status`	Delivery status of a message (queued, sent, delivered, failed, expired)
`get_bulk_job`	Progress of a queued bulk send
`cancel_scheduled`	Cancel a scheduled send (credit is returned)
`verify_send`	Send a one-time verification code (OTP) by SMS
`verify_check`	Check the code the user entered
`get_credit`	Credit balance in CZK and price per SMS
`get_pricing`	Public price list (no credentials needed)

Setup

Create a free account at topsms.cz (10 free SMS).
In the dashboard open API klíče (API keys), create a key with scopes send and read, copy the Client ID and Secret.
Add the server to your MCP client.

Claude Desktop / Claude Code

json

{
  "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

Similar modules

Browse Messaging apps