MCP server
SMS z AI asistentů

Co umí

• send_sms: odešle SMS na jedno číslo, volitelně s vaším schváleným odesílatelem, hned nebo naplánovaně (send_at)
• send_bulk_sms: stejný text až na 500 čísel, velké dávky jdou do fronty
• get_message_status a get_bulk_job: stav doručení zprávy (včetně důvodu nedoručení errorCode) a průběh dávky
• cancel_scheduled: zruší naplánované odeslání a vrátí kredit
• verify_send a verify_check: pošle ověřovací kód (OTP) a zkontroluje ho, viz Verify API
• get_credit: zůstatek kreditu a cena za SMS
• get_pricing: veřejný ceník (bez přihlášení)

Server volá stejné REST API jako vaše aplikace, takže platí stejné ceny, limity a pravidla účtování. Odesílací nástroje přijímají volitelný idempotencyKey: když asistent volání zopakuje, SMS neodejde dvakrát. Balíček: npmjs.com/package/topsms-mcp.

Instalace do Claude Desktop, Cursoru a dalších

V dashboardu v sekci API klíče vytvořte klíč se scopes send a read a do konfigurace MCP klienta přidejte:

{
  "mcpServers": {
    "topsms": {
      "command": "npx",
      "args": ["-y", "topsms-mcp"],
      "env": {
        "TOPSMS_CLIENT_ID": "vas-client-id",
        "TOPSMS_SECRET": "vas-secret"
      }
    }
  }
}

Claude Code jedním příkazem:

claude mcp add topsms -e TOPSMS_CLIENT_ID=... -e TOPSMS_SECRET=... -- npx -y topsms-mcp

Potřebujete Node.js 18 nebo novější. Cursor, Windsurf i VS Code používají stejný formát konfigurace.

Bezpečnost a náklady

• Každé odeslání čerpá skutečný kredit. Nechte v klientovi zapnuté potvrzování volání nástrojů, asistent se pak před odesláním zeptá.
• Pro AI asistenta vytvořte samostatný API klíč. V dashboardu uvidíte jeho spotřebu zvlášť a kdykoli ho zrušíte.
• Klíč zůstává na vašem počítači v konfiguraci klienta, server ho posílá jen na www.topsms.cz.
• Pro opakované automatizace bez AI je vhodnější Make nebo přímo REST API.