Skip to content
MCP server

TopSMS

Send SMS and OTP codes, check delivery and credit from an assistant, with prepaid billing

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://topsms.eu/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "topsms-mcp": {
      "url": "https://topsms.eu/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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)Required
  • TOPSMS_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

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity