TopSMS

io.github.topsms-ghb由 GitHub 账号 topsms-ghb 发布v1.1.1更新于 Nov 11, 2026

EU SMS gateway (topsms.eu, topsms.cz): send SMS, OTP codes, delivery status and credit.

已验证Streamable HTTP可网页运行沟通与协作安全与监控

概览

AI 生成的概览

TopSMS 让助手通过欧盟短信网关发送短信和 OTP 验证码,并查询送达状态、批量任务进度和账户余额。

可以做什么
  • 发送单条短信,可定时发送或指定发送方标识,也可将同一内容批量发送给最多 500 个号码。
  • 查询单条消息的送达状态和排队中批量发送的进度。
  • 取消定时发送或尚未开始的批量任务,并退回相应额度。
  • 通过短信发送一次性验证码,并校验用户输入的验证码。
  • 读取账户短信余额和公开价目表。
适用场景
适合需要让助手发送通知类或事务类短信、执行批量短信发送,或在注册登录流程中加入短信 OTP 验证的场景,也便于在同一对话中查看送达状态和剩余额度。
运行要求
需要 topsms.eu(欧元计费)或 topsms.cz(捷克克朗计费)的 TopSMS 账户并预充值。需在后台创建具备 send 和 read 权限的 API 密钥,以 TOPSMS_CLIENT_ID 和 TOPSMS_SECRET 提供。可作为远程端点使用,也可通过 npx topsms-mcp 本地运行;声明支持 OAuth。
安装前请注意
每次发送都会消耗真实预付费额度,批量发送最多 500 个号码;建议保持客户端的调用确认提示开启。API 密钥是可计费的凭据,应仅存放在客户端的环境配置中。发送短信会把消息内容和收件人手机号传输给第三方 TopSMS。

安装

在 SourceWeft 中

  1. 打开 控制台中的 TopSMS,将其添加到工作区。
  2. 连接 所需的 凭据。它们会被私密存储,绝不会在公开页面上展示。
  3. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.topsms-ghb%2Ftopsms-mcp/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。 客户端会在首次连接时完成 OAuth 登录。

{
  "mcpServers": {
    "topsms": {
      "type": "http",
      "url": "https://topsms.eu/api/mcp"
    }
  }
}

README

TopSMS MCP server

Send SMS from Claude, ChatGPT, Cursor and other AI assistants through TopSMS, an SMS gateway for businesses with two front doors: TopSMS.cz for the Czech Republic and Slovakia (billed in CZK) and TopSMS.eu for Germany, Austria and the rest of the EU (billed in EUR). One API, 200+ countries, prepaid, no monthly fee, 10 free SMS on registration.

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.eu (English/German, billed in EUR) or topsms.cz (Czech, billed in CZK). 10 free SMS either way.
  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

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.084 per SMS to Germany, Austria and other EU countries, €0.036–0.040 to Czech and Slovak numbers, no monthly fees, credit never expires. Full price list: https://topsms.eu/#pricing (EUR) · https://www.topsms.cz/pricing.json (CZK).

Notes

License

MIT

来源:README.md,提交 268fd09

工具

9

send_sms

Send one SMS message via TopSMS (Czech SMS gateway). Costs credit: 160 chars without diacritics = 1 SMS, 70 with diacritics/emoji. Returns message id, number of segments and price in your account currency (field currency: EUR for topsms.eu accounts, CZK for topsms.cz).

输入参数to必填fromtext必填send_atidempotencyKey

send_bulk_sms

Send the same SMS text to up to 500 recipients. Batches over 50 recipients are queued (HTTP 202) and return a jobId; use get_bulk_job to follow progress.

输入参数to必填fromtext必填send_atidempotencyKey

get_message_status

Get delivery status of a sent message (queued, sent, delivered, failed, expired) with timestamps, errorMessage and machine-readable errorCode (expired, undelivered, rejected, deleted, unknown, repeated_failure, not_sent), by message id or external id.

输入参数id必填

get_bulk_job

Get progress of a queued bulk send (status, sent, failed, queued counts and per-message results).

输入参数jobId必填results

cancel_scheduled

Cancel a scheduled send (or a queued bulk job that has not started yet). Unsent messages are removed and their price is returned to credit.

输入参数jobId必填

verify_send

Send a one-time verification code (OTP) by SMS for login, registration or payment confirmation. TopSMS generates and stores the code; returns a verification id. Limits: 5 codes per number per hour, 30 s between codes.

输入参数to必填ttlfrombrandlengthlocale

verify_check

Check a verification code the user entered. Returns valid true/false, status (approved, pending, expired, failed, canceled) and attempts left (max 5 attempts per code).

输入参数idtocode必填

get_credit

Get the current TopSMS credit balance and base price per SMS in your account currency (field currency: EUR or CZK).

无需输入参数。

get_pricing

Get the public TopSMS price list (tiers, prices per destination zone in CZK and EUR, Sender ID fee, billing rules). Does not require credentials.

无需输入参数。

版本历史

2
  1. v1.1.1最新Nov 8, 2026
  2. v1.1.0Oct 1, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分