Skip to content

SMS for automations and AI agents

Your agent or workflow sends the SMS itself: through a remote MCP server with no install, from the Make app, the n8n community node or Zapier over HTTP, or straight from the REST API. Test keys are free.

€0.084per SMS to Germany and Austria

  • No monthly fee
  • No contract
  • €0.50 free credit
Create free accountAll prices
MyShopnow
Hi Ms Weber, your appointment tomorrow at 10:30 is confirmed. Questions? Just reply by e-mail.

Written by an AI assistant and sent over MCP.

Remote MCP: SMS from Claude, ChatGPT, Cursor and other agents

The MCP server runs on our side. In Claude or ChatGPT you add https://topsms.eu/api/mcp as a custom connector, sign in to TopSMS and click Allow; no API key to copy. Clients without sign-in, such as Cursor, send your API key as a header. The agent gets the tools send_sms, send_bulk_sms, get_message_status, get_bulk_job, cancel_scheduled, verify_send, verify_check, get_credit and get_pricing.

  • Same rules as the API: same prices, limits, test keys, IP allowlist and logs in the dashboard. A sign-in shows up as the key “OAuth: app name”; revoke it to disconnect.
  • Prefer local? The npm package topsms-mcp offers the same tools, for example for Claude Desktop.
  • Practise safely: with a test key (via the header) the agent sends and pays nothing, yet responses and status changes are real.
  • Step by step: Send SMS from Claude and ChatGPT, with example prompts.
  • For coding agents: open-source TopSMS Skills teach the agent the API, the MCP server does the sending. See SMS for AI agents.

Make, n8n and Zapier

Make: official TopSMS app, added via this invitation link.

n8n: community node n8n-nodes-topsms (Settings → Community Nodes → Install). It sends SMS and bulk SMS, schedules and cancels, sends and checks verification codes, reads status and credit, and can be added as a tool to an n8n AI Agent.

Zapier (and n8n without the node): one HTTP request to https://www.topsms.cz/api/sms/send with the header Authorization: Bearer CLIENT_ID:SECRET and this JSON:

{ "to": "+4915112345678", "text": "Your order 1024 has shipped.", "send_at": "2026-12-01T09:00:00+01:00" }

send_at is optional. The response contains id, price and currency (EUR); delivery reports come back to your workflow by webhook.

Three recipes

1. n8n: new order → SMS

  1. Add a Webhook node and enter its URL as the order webhook in your shop.
  2. TopSMS node (community node n8n-nodes-topsms): resource Message, operation Send, credential with your API key.
  3. To: {{$json.phone}}, Text: Thanks for your order {{$json.number}}!. For Shopware, WooCommerce and JTL-Shop there are also ready-made plugins.

2. Zapier: Google Calendar event → reminder

  1. Trigger Google Calendar – Event Start, e.g. 24 hours before.
  2. Action Webhooks by Zapier – POST (on paid Zapier plans) to the SMS address above.
  3. Take the phone number from the event description; text: “Reminder: your appointment tomorrow at …”.

3. Claude or ChatGPT: “text the customer”

  1. Connect TopSMS as shown below.
  2. In the chat: “Send Mr Müller (+49 151 …) an SMS that his order shipped today.”
  3. The agent calls send_sms and can check delivery with get_message_status.

Verification codes for agents and apps

With verify_send and verify_check TopSMS generates, sends and checks the one-time code, in English, German or Czech. Your agent never stores a code. Abuse limits: 5 codes per number per hour, 30 seconds apart, 5 attempts per code.

For language models there is a compact description at llms.txt, the full one at llms-full.txt, and the OpenAPI specification.

Set up remote MCP

In Claude and ChatGPT, sign in when you add the connector. For a header, create an API key in the dashboard under API (a test key to try things out). Any client that can send HTTP headers works the same way.

# Claude.ai and ChatGPT: add a custom connector with this URL, sign in, Allow
https://topsms.eu/api/mcp

# Claude Code: add the server, then /mcp to sign in
claude mcp add --transport http topsms https://topsms.eu/api/mcp

# Claude Code with a (test) API key instead of sign-in
claude mcp add --transport http topsms https://topsms.eu/api/mcp \
  --header "Authorization: Bearer CLIENT_ID:SECRET"

# Cursor: ~/.cursor/mcp.json
{
  "mcpServers": {
    "topsms": {
      "url": "https://topsms.eu/api/mcp",
      "headers": { "Authorization": "Bearer CLIENT_ID:SECRET" }
    }
  }
}

Your own sender name and links in the SMS text become active after the first top-up; until then TopSMS sends as “TopSMS”. New accounts get €0.50 starting credit. Details on the MCP server page.

Full API documentation →

Frequently asked questions

Do I need to install anything?

No. The remote MCP server runs at topsms.eu/api/mcp. In Claude, ChatGPT and Claude Code you add the address and sign in; in Cursor and other clients you add the address and your API key. There is also the npm package topsms-mcp.

Could an agent send expensive SMS by mistake?

Develop with a test key: it sends and charges nothing. For the live key you can set an IP allowlist and a per-minute rate limit in the dashboard; sending only draws on your prepaid credit.

What does an SMS cost via MCP or n8n?

The same as via the API: €0.084 per SMS segment to Germany, Austria and the rest of the EU, no monthly fee. Amounts in API responses are in euros.

Does it work with ChatGPT?

Yes, as a custom connector in developer mode with OAuth sign-in, on the ChatGPT plans that offer developer mode. Enter topsms.eu/api/mcp as the URL, sign in to TopSMS and click Allow.

Try it with €0.50 free credit

Free account, active as soon as you confirm your mobile number. No credit card, no monthly fee, prepaid credit that never expires.

Create free accountQuestions first? Contact us

More use cases