mcpField
T
TopSMS

TopSMS

ローカル
topsms.czコミュニケーション04 週間前に更新
リポジトリ公式サイト

TopSMS について

TopSMSは、チェコの法人向けSMSゲートウェイTopSMS経由でメッセージを送るMCPサーバーです。予約送信や一括送信、OTP認証、配信状況、残高と料金の照会に対応します。

主な機能

  1. 01SMSの送信と予約送信
  2. 02最大500件への一括送信
  3. 03OTPコードの送信と検証
  4. 04SMSと一括ジョブの状況確認
  5. 05残高と料金の確認

活用シーン

  1. 01予約やサービスの通知を送信
  2. 02OTPでユーザーの電話番号を確認
  3. 03個別または一括SMSの配信状況を追跡

MCP 対応

TopSMSのメッセージ送信、認証、状況、残高、料金の各ツールをMCPクライアントに提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "topsms-ghb-topsms": {
      "command": "npx",
      "args": [
        "-y",
        "topsms-mcp"
      ],
      "env": {
        "TOPSMS_CLIENT_ID": "<TOPSMS_CLIENT_ID>",
        "TOPSMS_SECRET": "<TOPSMS_SECRET>"
      }
    }
  }
}
起動コマンドnpx -y topsms-mcp
設定が必要な環境変数
TOPSMS_CLIENT_IDAPI key Client ID from the TopSMS dashboard (API klíče)
TOPSMS_SECRETシークレットAPI key secret from the TopSMS dashboard

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
npmtopsms-mcp1.1.0

ツール

9

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
tostringはい国際形式の電話番号。例：+420601234567（プレフィックスなしのチェコの電話番号も使用できます）。
fromstringいいえ承認済みの Sender ID（最大11文字）。省略すると、デフォルトの送信者 "TopSMS" が使用されます。
textstringはいメッセージ本文。
send_atstringいいえ後で送信する場合のスケジュール：タイムゾーン付きの ISO 8601 形式。例：2026-10-01T09:00:00+02:00（最大30日先まで）。省略すると今すぐ送信します。予約送信では jobId が返され、cancel_scheduled でキャンセルできます。
idempotencyKeystringいいえ任意の Idempotency-Key（例：UUID）。同じキーで呼び出しを繰り返しても SMS は二重送信されず、元の応答が返されます。

詳細

TopSMS MCP サーバー

Czech Republic, Slovakia and 200+ countries の企業向けチェコの SMS ゲートウェイ TopSMS を通じて、Claude、ChatGPT、Cursor などの AI アシスタントから SMS を送信します。

ツール

ツール機能
send_smsSMS を 1 通送信します（番号、テキスト、任意の送信者 ID、予約送信する場合は任意の send_at、任意の冪等性キー）
send_bulk_sms最大 500 件の番号に同じテキストを送信します。宛先が 50 件を超えるとキューに登録され、jobId が返されます
get_message_statusメッセージの配信状況（キュー登録済み、送信済み、配信済み、失敗、期限切れ）
get_bulk_jobキューに登録された一括送信の進捗状況
cancel_scheduled予約送信をキャンセルします（クレジットは返還されます）
verify_sendSMS でワンタイム認証コード（OTP）を送信します
verify_checkユーザーが入力したコードを確認します
get_creditクレジット残高（CZK）と SMS 1 通あたりの料金
get_pricing公開料金表（認証情報は不要）

セットアップ

  1. topsms.cz で無料アカウントを作成します（SMS 10 通が無料）。
  2. ダッシュボードで API klíče（API キー）を開き、スコープ send と read を設定してキーを作成し、Client ID と Secret をコピーします。
  3. MCP クライアントにサーバーを追加します。
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

クライアントの MCP 設定で、同じ command、args、env を使用します。

料金

チェコとスロバキアの番号宛ては SMS 1 通あたり 0.88～0.98 CZK（約 €0.036～0.040）で、月額料金はなく、クレジットの有効期限もありません。EU は 2 CZK、それ以外の地域は 1 セグメントあたり 3 CZK です。料金一覧：https://www.topsms.cz/pricing.json

注意事項

  • send_* の呼び出しごとに実際のクレジットが消費されます。AI クライアントは通常、ツールの呼び出し前に確認を求めます。この設定は有効にしておいてください。
  • ダイアクリティカルマークなしの 160 文字で SMS 1 通、ダイアクリティカルマークまたは絵文字を含む場合は 70 文字で SMS 1 通です。
  • API ドキュメント：https://www.topsms.cz/api-integrace/rest-api · サポート：[email protected]

ライセンス

MIT

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。