MCP.Market

TopSMS MCP server

by topsms-ghb·io.github.topsms-ghb/topsms-mcp·v1.1.0
No reviews yet

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

B80/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B80/100

full report

Adoption
New

0 stars

Reviews

Write one

Nobody has reviewed TopSMS yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

TopSMS tools (9, 4 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • cancel_scheduledwrite action

    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.

  • get_bulk_job

    Get progress of a queued bulk send (status, sent, failed, queued counts and per-message results).

  • get_credit

    Get the current TopSMS credit balance (CZK) and the price per SMS for this account.

  • 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.

  • 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.

  • send_bulk_smswrite action

    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.

  • send_smswrite action

    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 CZK.

  • 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).

  • verify_sendwrite action

    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.

Public scan report

scanner v0.1.10 · 2026-10-01 · same rubric, same numbers if you re-run it

no findings
  • Code scan2 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 0 days ago15/15
  • Maintainer identityregistry namespace matches repository owner6/10
Overall 80/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How TopSMS compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
80/100
higher than 60% of 48,255 servers
Tools
9
the typical server has 7
Tools that change things
44%
typical: 0%. Fewer write tools means less an agent can break

What its tools let an agent do: 5 read · 1 change · 1 delete · 2 send or post

Install TopSMS in Claude Code, Cursor or VS Code

Runs npx -y topsms-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add topsms-mcp -- npx -y topsms-mcp
Add to Cursor

What the publisher says

From the TopSMS repository's README, as published. We do not edit it. Read it on GitHub

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

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 TOPSMSCLIENTID=... -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

Nothing above is checked by us. What we check is on the safety report.

TopSMS: common questions

Is TopSMS MCP server safe?
Mostly: it is graded B (80/100). Read the TopSMS safety report
How do I install TopSMS?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does TopSMS need an API key?
Yes. The registry entry asks for TOPSMS_SECRET.
Is TopSMS maintained?
The last commit was 34 days ago (2026-09-30). The latest release is v1.1.0.
How does TopSMS compare with other MCP servers?
safety score 80/100 (higher than 60% of 48,255 servers); tools 9 (the typical server has 7); tools that change things 44% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.