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 分