SMS für KI-Agenten

9 SMS-Toolsim MCP-Server: senden, Massenversand, planen, Status, stornieren, OTP, Guthaben, Preise
7 SkillsOpen Source (MIT), sie bringen Coding-Agenten die TopSMS-API bei
0 €für Skills, MCP-Server und Testschlüssel; Sie zahlen nur gesendete SMS

Skills bringen Ihrem Coding-Agenten bei, wie die TopSMS-API funktioniert. Über den MCP-Server senden Claude, ChatGPT, Cursor oder jeder andere MCP-Client die SMS. Nutzen Sie eines davon oder beides zusammen.

0,084 €pro SMS nach Deutschland und Österreich
Keine Grundgebühr
Kein Vertrag
0,50 € Startguthaben

Kostenloses Konto anlegen Assistenten verbinden

Skills liefern Wissen, MCP führt aus

Ein Agent, der Ihre Integration programmiert, muss die API kennen. Ein Assistent, der die Arbeit erledigt, braucht ein Tool, das er aufrufen kann. TopSMS bietet beides, im selben Konto und nach denselben Regeln.

Skills

Skills = Wissen: Anmeldung, Versand, Webhooks, OTP, SMS-Länge, Rechtliches

Was: Sieben Markdown-Pakete (SKILL.md) mit genauen Request- und Response-Formaten, Limits und kleinen lauffähigen Beispielen.
Für: Coding-Agenten, die Ihren Code schreiben oder prüfen: Claude Code und andere Agenten, die das Agent-Skills-Format lesen.
Läuft: Im Agenten, als Kontext. Kein API-Schlüssel, keine Netzwerkaufrufe.
Installation: Claude-Code-Plugin, oder die Ordner nach ~/.claude/skills kopieren.

skills/topsms-send-sms/SKILL.md

---
name: topsms-send-sms
description: Send SMS through the TopSMS REST API
  correctly - single SMS (POST /api/sms/send),
  bulk up to 500 recipients (POST /api/sms/send-bulk,
  queue and jobId above 50), scheduled sending …
license: MIT
metadata:
  author: TopSMS
  version: "1.0.0"
---

# Sending SMS with TopSMS

MCP-Server

MCP = Aktion: SMS senden, Zustellung, Guthaben und Preise abfragen

Was: Ein Remote-Server unter https://topsms.eu/api/mcp mit 9 SMS-Tools.
Für: Assistenten, die für Sie handeln: claude.ai, ChatGPT, Claude Code, Cursor und andere MCP-Clients.
Läuft: Bei TopSMS. Jeder Tool-Aufruf ist ein echter API-Request in Ihrem Konto.
Installation: URL als Connector hinzufügen und anmelden (OAuth), oder einen API-Schlüssel als Header senden.

Beispieldaten

In Claude Code installiert ein Plugin beides.

Assistenten verbinden

Clients mit Anmeldung brauchen keinen API-Schlüssel: URL hinzufügen, bei TopSMS anmelden und auf Erlauben klicken.

claude.ai und die Claude-Apps: Settings → Connectors → Add custom connector. URL https://topsms.eu/api/mcp, OAuth-Felder leer lassen, auf Connect klicken, bei TopSMS anmelden und auf Erlauben klicken. Ob eigene Connectors verfügbar sind, hängt von Ihrem Claude-Tarif und den Einstellungen Ihrer Organisation ab.
ChatGPT: Settings → Apps & Connectors, in den erweiterten Einstellungen den Developer mode einschalten, einen Connector mit derselben URL und OAuth anlegen, anmelden und auf Erlauben klicken. Den Developer mode gibt es nur in einigen ChatGPT-Tarifen.
Claude Code: Das Plugin unten installiert die sieben Skills und registriert den MCP-Server. Danach /mcp ausführen und anmelden. Oder nur den Server mit claude mcp add hinzufügen.
Cursor und andere Clients: Server mit Ihrem API-Schlüssel als Authorization-Header hinzufügen. Nehmen Sie zuerst einen Testschlüssel: Er sendet nichts und kostet nichts.
n8n: Installieren Sie den Community-Node n8n-nodes-topsms (Settings → Community Nodes). Er kann senden, Massen-SMS, Status, geplante Jobs, Bestätigungscodes und Guthaben und lässt sich als Tool einem n8n-AI-Agent hinzufügen.

# Claude Code: Skills und MCP-Server in einem Plugin
claude plugin marketplace add topsms-ghb/topsms-skills
claude plugin install topsms@topsms
# danach in Claude Code /mcp ausführen und bei TopSMS anmelden

# Claude Code: nur der MCP-Server
claude mcp add --transport http topsms https://topsms.eu/api/mcp

# Cursor (~/.cursor/mcp.json) und andere Clients, mit (Test-)API-Schlüssel
{
  "mcpServers": {
    "topsms": {
      "url": "https://topsms.eu/api/mcp",
      "headers": { "Authorization": "Bearer CLIENT_ID:SECRET" }
    }
  }
}

Was die 9 MCP-Tools für SMS können

Tool	Funktion
send_sms	Sendet eine SMS, sofort oder geplant (send_at), auf Wunsch mit Ihrem Absendernamen
send_bulk_sms	Sendet denselben Text an bis zu 500 Nummern; ab 50 läuft der Versand über die Warteschlange
get_message_status	Zustellstatus einer Nachricht, mit Grund bei Nichtzustellung (errorCode)
get_bulk_job	Fortschritt eines Massenversands oder geplanten Versands
cancel_scheduled	Storniert einen geplanten Versand und schreibt das Guthaben gut
verify_send	Sendet einen Einmalcode (OTP) per SMS
verify_check	Prüft den eingegebenen Code
get_credit	Guthaben und Preis pro SMS
get_pricing	Öffentliche Preisliste, ohne Anmeldung

Jedes Tool ruft dieselbe REST-API auf wie Ihre Anwendung: gleiche Preise, Limits, Absenderregeln und Request-Log. Die Sende-Tools nehmen einen idempotencyKey an, damit ein wiederholter Aufruf nie doppelt sendet.

Die sieben Skills

Jeder Skill ist ein Ordner mit einer SKILL.md im offenen Agent-Skills-Format. Der Agent lädt nur den, den er gerade braucht.

Skills filtern

Konten (EUR oder CZK), API-Schlüssel, Testschlüssel, erste SMS mit curl, Python, Node.js und PHP, Fehlercodes
Auf GitHub öffnen →

Quellcode und Installationsanleitung auf GitHub: github.com/topsms-ghb/topsms-skills →

Sicherheit und Kontrolle

Bei der Anmeldung sehen Sie eine Zustimmungsseite mit dem Namen der App und dem, was sie darf. Ihr Passwort geben Sie nur bei TopSMS ein.
Jede Anmeldung wird im Dashboard unter API-Zugang zu einem eigenen API-Schlüssel „OAuth: App-Name“. Widerrufen Sie ihn dort, ist der Assistent getrennt.
Für Clients mit Header legen Sie einen eigenen Schlüssel nur mit den nötigen Scopes an (send, read), auf Wunsch mit IP-Allowlist und niedrigerem Rate-Limit.
Testschlüssel senden und berechnen nichts, liefern aber echte Antwortformate und simulierte Zustellberichte. Lassen Sie Agenten dort zuerst üben.
Lassen Sie im Client die Bestätigung von Tool-Aufrufen eingeschaltet, dann fragt der Assistent vor dem Senden. Versendet wird nur aus Ihrem Prepaid-Guthaben.
Die Skills enthalten keine Schlüssel und rufen nichts im Netz auf; ihre Beispielskripte lesen den Schlüssel aus Umgebungsvariablen.

Name	Scopes	Limit	Aufrufe
OAuth: ClaudeOAUTH	send,read	60/min	37×
OAuth: ChatGPTOAUTH	send,read	60/min	12×
Shop	send	60/min	1.204×
TestTEST	send,read	60/min	85×

Beispieldaten

Häufige Fragen

Was ist der Unterschied zwischen Skills und dem MCP-Server? Skills sind Wissen: Markdown-Dateien, die einem Coding-Agenten erklären, wie die TopSMS-API funktioniert, damit sein Code stimmt. Der MCP-Server ist Aktion: Tools, die ein Assistent aufruft, um sofort eine SMS zu senden oder die Zustellung zu prüfen. Skills laufen im Agenten, der MCP-Server bei TopSMS.

Brauche ich beides? Nein. Für eine SMS-Integration in Ihrem eigenen Code reichen die Skills. Damit ein Assistent für Sie Nachrichten sendet, reicht der MCP-Server. In Claude Code installiert ein Plugin beides.

Welche KI-Tools funktionieren? Der MCP-Server funktioniert mit claude.ai und den Claude-Apps als eigener Connector, mit ChatGPT im Developer mode, mit Claude Code, Cursor und anderen Clients, die Remote-MCP unterstützen. Für Clients, die nur lokale Server starten, gibt es das npm-Paket topsms-mcp. Die Skills folgen dem offenen Agent-Skills-Format, das Claude Code und andere Agenten nutzen.

Was kostet das? Skills, MCP-Server und Testschlüssel sind kostenlos. Sie zahlen nur gesendete SMS: 0,084 € pro SMS-Segment nach Deutschland, Österreich und in die übrige EU, ohne Grundgebühr.

Kann ein Agent ohne meine Zustimmung SMS senden? Nur mit dem Zugang, den Sie ihm geben. Lassen Sie die Bestätigung von Tool-Aufrufen eingeschaltet, nutzen Sie zum Ausprobieren einen Testschlüssel und widerrufen Sie die Verbindung jederzeit im Dashboard. Versendet wird nur aus Ihrem Prepaid-Guthaben.

Ist das Open Source? Ja. Die Skills stehen unter MIT-Lizenz auf GitHub (topsms-ghb/topsms-skills), das lokale MCP-Paket topsms-mcp unter MIT-Lizenz auf npm.

Testen Sie mit 0,50 € Startguthaben

Kostenloses Konto, aktiv, sobald Sie Ihre Mobilnummer bestätigt haben. Ohne Kreditkarte, ohne Grundgebühr, Prepaid-Guthaben ohne Verfall.

Kostenloses Konto anlegen Erst Fragen klären? Kontakt