mcpField
T
TopSMS

TopSMS

Local
topsms.czCommunication0Updated 4w ago
RepositoryVisit website

About TopSMS

TopSMS is an MCP server for sending messages through the Czech TopSMS business SMS gateway. It supports scheduled and bulk SMS, OTP verification, delivery tracking, and account credit and pricing queries.

Key features

  1. 01Send and schedule SMS
  2. 02Send bulk messages to up to 500 numbers
  3. 03Send and validate OTP codes
  4. 04Check message and bulk-job status
  5. 05View credit balance and pricing

Use cases

  1. 01Send appointment or service notifications
  2. 02Verify a user's phone number by OTP
  3. 03Track delivery of individual or bulk SMS

MCP support

Exposes TopSMS messaging, verification, status, credit, and pricing tools to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "topsms-ghb-topsms": {
      "command": "npx",
      "args": [
        "-y",
        "topsms-mcp"
      ],
      "env": {
        "TOPSMS_CLIENT_ID": "<TOPSMS_CLIENT_ID>",
        "TOPSMS_SECRET": "<TOPSMS_SECRET>"
      }
    }
  }
}
Run commandnpx -y topsms-mcp
Environment variables to set
TOPSMS_CLIENT_IDAPI key Client ID from the TopSMS dashboard (API klíče)
TOPSMS_SECRETSecretAPI key secret from the TopSMS dashboard

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmtopsms-mcp1.1.0

Tools

9

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
tostringYesPhone number in international format, e.g. +420601234567 (Czech numbers without prefix are accepted).
fromstringNoApproved Sender ID (max 11 chars). Omit to use the default sender "TopSMS".
textstringYesMessage text.
send_atstringNoSchedule for later: ISO 8601 with timezone, e.g. 2026-10-01T09:00:00+02:00 (max 30 days ahead). Omit to send now. Scheduled sends return a jobId that can be cancelled with cancel_scheduled.
idempotencyKeystringNoOptional Idempotency-Key (e.g. a UUID). Repeating a call with the same key never sends the SMS twice; the original response is returned.

Details

From the project README

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

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.