TopSMS

io.github.topsms-ghbv1.1.0更新于 Oct 1, 2026

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

已验证STDIO仅桌面Productivity & Workflow Communication & Collaboration

安装

在 SourceWeft 中

打开控制台中的 TopSMS，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照仓库中的启动说明。

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

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

{  "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: [email protected]

License

MIT

来源：README.md，提交 a254a12

工具

工具元数据尚未被收录。

版本历史

v1.1.0最新Oct 1, 2026