# TopSMS

> TopSMS is a paid MCP server for communication. Send SMS and OTP codes, check delivery and credit from an assistant, with prepaid billing. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI
- **Website:** https://topsms.eu/mcp
- **Repository:** https://github.com/topsms-ghb/topsms-mcp
- **MCP Registry name:** io.github.topsms-ghb/topsms-mcp
- **Categories:** communication
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http topsms-mcp https://topsms.eu/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://topsms.eu/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "topsms-mcp": {
      "url": "https://topsms.eu/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "topsms-mcp": {
      "type": "http",
      "url": "https://topsms.eu/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "topsms-mcp": {
      "serverUrl": "https://topsms.eu/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "topsms-mcp": {
      "type": "http",
      "url": "https://topsms.eu/api/mcp"
    }
  }
}
```

## Tools

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

## 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

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/topsms
