TopSMS
Send SMS and OTP codes, check delivery and credit from an assistant, with prepaid billing
- Pricing
- Paid
- Platforms
- API, CLI
- Runs
- Locally or Remotely
- Version
- 1.1.1
- Listing updated
- 3 days ago
About TopSMS
TopSMS is a paid MCP server for communication. It can run locally on your machine or as a hosted remote server.
TopSMS is a prepaid SMS gateway for the EU and Czech markets, and its MCP server calls the same REST API as an application would, so prices and limits match. You can connect Claude or ChatGPT at topsms.eu/api/mcp with OAuth sign-in and a consent screen, or use an API key as a bearer header (Cursor) or through the local npm package. Each OAuth connection shows up in the dashboard and can be revoked.
Nine tools cover immediate or scheduled sending, bulk sends of up to 500 numbers (over 50 are queued), delivery status with a non-delivery reason, cancelling a scheduled send with a credit refund, verification codes, balance and the public price list. Send tools accept an idempotency key so a repeated call does not send twice, and the README warns every send call spends real credit. Test keys send and charge nothing.
Pricing is per segment with no monthly fee: €0.084 per SMS to Germany and Austria, about €0.036-0.040 for Czech and Slovak numbers, and volume prices from 10,000 SMS a month. New accounts get €0.50 free credit on the site, while the README mentions 10 free SMS.
Install
Run in a terminal
claude mcp add --transport http topsms-mcp https://topsms.eu/api/mcpAdd to Settings → Connectors → Add custom connector
https://topsms.eu/api/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"topsms-mcp": {
"url": "https://topsms.eu/api/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"topsms-mcp": {
"type": "http",
"url": "https://topsms.eu/api/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"topsms-mcp": {
"serverUrl": "https://topsms.eu/api/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"topsms-mcp": {
"type": "http",
"url": "https://topsms.eu/api/mcp"
}
}
}Configuration
TOPSMS_CLIENT_IDAPI key Client ID from the TopSMS dashboard (API klíče)RequiredTOPSMS_SECRETAPI key secret from the TopSMS dashboardRequired
Tools this server provides (9)
Taken from the project documentation; the running server may differ.
- send_sms
- Send an SMS to one number, optionally with a sender name or send_at schedule.
- send_bulk_sms
- Send the same text to up to 500 numbers; large batches are queued.
- get_message_status
- Delivery status of a message, including the non-delivery error code.
- get_bulk_job
- Progress of a queued bulk batch.
- cancel_scheduled
- Cancel a scheduled send and refund the credit.
- verify_send
- Send a one-time verification code by SMS.
- verify_check
- Check the verification code entered.
- get_credit
- Credit balance and price per SMS.
- get_pricing
- Public price list, no login required.
What it does
- Immediate and scheduled sends
- Send one SMS now or later, with an optional sender name.
- Bulk sending
- Send the same text to up to 500 numbers; large batches are queued.
- Delivery tracking
- Check status and the error code for a failure.
- Verification codes
- verify_send and verify_check handle OTP flows.
- Idempotency keys
- A repeated call does not send the SMS twice.
- OAuth or API key
- Sign in from Claude or ChatGPT, or use a key with a bearer header.
Good for
- Text a customer that an order has shipped
- Send appointment reminders in bulk
- Check remaining credit and price per SMS
- Cancel a scheduled message and get credit back
- Verify a phone number with a code
Pricing
Paid
Prepaid per SMS from €0.084 to Germany and Austria; no monthly fee; €0.50 free credit
Prices change. Check topsms.eu before you buy.
TopSMS FAQ
What does an SMS cost?
€0.084 per segment to Germany and Austria; Czech and Slovak numbers are €0.036-0.040 depending on volume. Prices differ by destination.
Is there a monthly fee?
No monthly fee or contract; credit is prepaid and does not expire.
Can the assistant send by mistake?
Every send call spends real credit; the README advises keeping client confirmation enabled.
How do I authenticate?
OAuth sign-in for Claude and ChatGPT, or a Client ID and secret API key.
Is TopSMS free?
No. TopSMS is a paid product.
How do I add TopSMS to Claude Code?
Run this command in your terminal: claude mcp add --transport http topsms-mcp https://topsms.eu/api/mcp
What are the best alternatives to TopSMS?
The closest alternatives to TopSMS are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.
Alternatives to TopSMS

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity