English Français العربية

TopSMS

السجل الرسمي الأمن

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

الشيفرة المصدرية الموقع التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package topsms-mcp
Claude Code 
claude mcp add topsms -e 'TOPSMS_CLIENT_ID=<TOPSMS_CLIENT_ID>' -e 'TOPSMS_SECRET=<your topsms_secret>' -- npx -y topsms-mcp@1.1.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "topsms": {
            "command": "npx",
            "args": [
                "-y",
                "topsms-mcp@1.1.0"
            ],
            "env": {
                "TOPSMS_CLIENT_ID": "<TOPSMS_CLIENT_ID>",
                "TOPSMS_SECRET": "<your topsms_secret>"
            }
        }
    }
}

متغيرات البيئة

  • TOPSMS_CLIENT_ID إلزامي API key Client ID from the TopSMS dashboard (API klíče)
  • TOPSMS_SECRET إلزامي سري API key secret from the TopSMS dashboard

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. TopSMS MCP server
  2. Tools
  3. Setup
  4. Pricing
  5. Notes
  6. License

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

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.cz (10 free SMS).
  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
{
  "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

الأسئلة الشائعة

ما هو TopSMS؟

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

كيف أثبّت TopSMS؟

يعمل على جهازك. في Claude Code: claude mcp add topsms -e 'TOPSMS_CLIENT_ID=<TOPSMS_CLIENT_ID>' -e 'TOPSMS_SECRET=<your topsms_secret>' -- npx -y topsms-mcp@1.1.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج TopSMS إلى مفتاح API؟

نعم. يتطلب TOPSMS_CLIENT_ID, TOPSMS_SECRET، وتضبطها في إعداداته.

هل TopSMS مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون TopSMS؟

ينشره topsms-ghb. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.