SMS8 - SMS GATEWAY using your phone

SMS8 MCP Server

SMS-Gateway → sms8.io  ·  SMS Gateway MCP für Vibe-Coder & Entwickler → mcp.sms8.io

Senden Sie SMS, geben Sie OTPs aus und verifizieren Sie diese, warten Sie auf eingehende Codes und konfigurieren Sie Webhooks von Claude Code, Cursor, Windsurf, OpenCode und jedem anderen KI-Coding-Tool, das das Model Context Protocol spricht. SMS werden über ein gekoppeltes Android-Telefon über die SMS8-Plattform geleitet.

Live-Server: https://mcp.sms8.io Dashboard: https://app.sms8.io Marketing-Website: https://sms8.io

Warum das hier verwenden

Sie entwickeln eine App und möchten SMS-Benachrichtigungen, OTPs, bidirektionale Nachrichtenübermittlung oder Telefonverifizierung für autonome Agenten? Die meisten Optionen zwingen Sie dazu, sich bei Mobilfunkprogrammen zu registrieren, Telefonnummern bereitzustellen, pro Nachricht zu bezahlen oder eine Einweg-SIM pro Sitzung zu mieten. SMS8 leitet SMS über ein Telefon, das Sie bereits besitzen. Der MCP-Server stellt Ihrem KI-Assistenten neun Tools zur Verfügung, die er direkt aufrufen kann, sodass das Hinzufügen von SMS zu einem Projekt einen Prompt statt einer Stunde Integrationsarbeit erfordert.

Was Sie bekommen

Tool	Zweck
setup_sms8	Validiert den API-Schlüssel, gibt Account-Kontext und Codebeispiele zurück
send_sms	Sendet eine SMS über ein gekoppeltes Android-Gerät
send_otp	Generiert und sendet einen Verifizierungscode
verify_otp	Vergleicht einen eingegebenen Code mit dem zuletzt ausgegebenen OTP
wait_for_otp	NEU. Blockiert, bis ein OTP auf dem gekoppelten Android-Gerät eintrifft; extrahiert den Code
get_messages	Gibt kürzlich empfangene oder gesendete SMS zurück
list_devices	Listet gekoppelte Android-Geräte auf
get_balance	NEU. Leichtgewichtige Guthaben- und Verlängerungsprüfung
create_webhook	Registriert eine Callback-URL für eingehende SMS und Zustellereignisse

Alle Tools nutzen dieselbe Sendepipeline wie das SMS8-Dashboard. Guthaben, Wiederholungen, Multi-Device-Routing und Webhook-Signierung funktionieren identisch zu einem direkten API-Aufruf.

SMS8 vs Twilio vs MessageBird

Funktion	SMS8	Twilio	MessageBird
Integrierter MCP-Server	Ja	Nein	Nein
Gebühr pro Nachricht	Keine	$0.0079+	$0.05+
A2P 10DLC erforderlich	Nein	Ja	Ja
Bereitstellung von Telefonnummern	Nicht nötig	$1+/Monat	$2+/Monat
Einrichtungszeit	60 Sekunden	Tage bis Wochen	Tage
OTP-Verifizierung integriert	Ja	Zusätzlicher Dienst	Zusätzlicher Dienst
Open-Source MCP-Code	MIT	Nein	Nein

Installation via npm

Sechs Pakete decken jeden Ablauf ab – wählen Sie das passende für Ihr Projekt.

Paket	Ausführungsbefehl	Anwendungsfall
sms8-mcp	npx -y sms8-mcp	MCP-Launcher für Claude Code, Cursor, Windsurf, OpenCode
sms8-cli	npx sms8-cli send +1234 "hi"	Terminal-CLI für Senden / OTP / Posteingang / Geräte
react-sms-otp	npm i react-sms-otp	React useSms8Otp() + <OtpForm /> + <OtpInput /> (Trennzeichen, RTL, Maske, Render-Props)
sms-otp-verify	npm i sms-otp-verify	Gleicher Code, SEO-optimierter Name für "sms otp verify" / "otp input"-Suchen
capacitor-sms-otp-send-verify	npm i capacitor-sms-otp-send-verify	Capacitor-Plugin für Ionic-Apps – natives iOS Swift + Android Kotlin + Web-Fallback
cordova-plugin-sms-otp-send	cordova plugin add cordova-plugin-sms-otp-send	Cordova-Plugin für Ionic-Apps – natives iOS Swift + Android Kotlin
sms-otp-using-myphone	npx sms-otp-using-myphone send +1234	OTP-only-Marke derselben CLI
phone-sms-gateway	npx phone-sms-gateway send +1234 "hi"	Telefon-als-Gateway-Marke derselben CLI
send-sms-from-android	npx send-sms-from-android send +1234 "hi"	Android-First-Marke derselben CLI

MCP-Beispiel (Claude Code, Cursor, Windsurf – gleiche Konfigurationsform):

{
  "mcpServers": {
    "sms8": {
      "command": "npx",
      "args": ["-y", "sms8-mcp"],
      "env": { "SMS8_API_KEY": "sk_xxx" }
    }
  }
}

CLI-Beispiel:

export SMS8_API_KEY=sk_xxx
npx sms8-cli send +14155550100 "Hello"
CODE=$(npx sms8-cli otp wait +Google --timeout=120)

React-Beispiel:

import { OtpForm } from 'react-sms-otp';

<OtpForm
  apiKey={process.env.NEXT_PUBLIC_SMS8_API_KEY!}
  onVerified={(phone) => router.push('/dashboard')}
/>

Der Quellcode für alle sechs Pakete befindet sich in npm-packages/.

iOS + Android SDKs

Für native mobile Apps enthält der Ordner sdks/ Kotlin (Android) und Swift (iOS) SDKs mit der Senden / Verifizieren-API + SMS-Autofill-Helfern (Google SMS Retriever auf Android, Inhaltstyp oneTimeCode auf iOS).

SDK	Installation	Autofill
sms8-swift	Swift Package Manager – siehe README	iOS OTPTextField SwiftUI-Ansicht
sms8-android	JitPack – siehe README	SMSRetriever.start(activity) – keine SMS-Berechtigung erforderlich

Beide SDKs sind MIT-lizenziert, verwenden denselben SMS8-API-Schlüssel und zielen auf dieselben Twilio-Verify-Alternativ-Anwendungsfälle ab.

Schnellstart

1. SMS8-Konto erstellen

Registrieren Sie sich unter app.sms8.io. Kostenlose 5-Tage-Testversion, keine Kreditkarte erforderlich. Koppeln Sie Ihr Android-Telefon per QR-Code und kopieren Sie Ihren API-Schlüssel aus Profil dann API.

2. MCP-Server zu Ihrem Tool hinzufügen

Gehostetes HTTP (Claude Code, Cursor, Windsurf, Codex, Devin)

{
  "mcpServers": {
    "sms8": {
      "url": "https://mcp.sms8.io",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_SMS8_API_KEY"
      }
    }
  }
}

Claude Code Plugin (ein Befehl)

/plugin marketplace add 1fancy/sms8-sms-gateway
/plugin install sms8-sms-gateway

Dann export SMS8_API_KEY=sk_xxx in Ihrer Shell ausführen, bevor Sie Claude Code starten.

npx für stdio-Clients

{
  "mcpServers": {
    "sms8": {
      "command": "npx",
      "args": ["-y", "@sms8/mcp"],
      "env": { "SMS8_API_KEY": "sk_your_key" }
    }
  }
}

3. Einrichtungsassistent

Das Dashboard unter app.sms8.io/mcp-setup.php füllt das JSON für jedes KI-Tool vor, zeigt bei Bedarf Ihren Gerätekopplungs-QR-Code und enthält ein Live-SMS-Testformular.

4. Fragen Sie Ihre KI

Add SMS verification to my signup flow using the sms8 MCP.

Die KI ruft setup_sms8, dann send_otp und verify_otp auf und schreibt Produktionscode, der beim ersten Versuch funktioniert.

Anwendungsfälle

Dies sind echte Einzeiler-Prompts, die Sie in Claude Code, Cursor oder Windsurf einfügen können.

Telefonverifizierung bei der Anmeldung

Wire phone-number verification into this app using the sms8 MCP. Use
send_otp on /signup, verify_otp on /verify-phone. Render the remaining
attempts on error.

Versandbenachrichtigungen für Bestellungen

When an order ships, send the customer an SMS with their tracking link
via the sms8 MCP.

Bidirektionaler Support-Posteingang

Register a webhook with the sms8 MCP at https://my-app.com/sms-inbox.
Scaffold the handler that verifies the HMAC signature and routes inbound
SMS to the support queue.

Passwortlose Anmeldung per SMS

Replace the magic-link email login with SMS OTPs using the sms8 MCP.
6-digit code, 5-minute expiry, 5 attempts.

SMS 2FA für Admin-Seiten

Add SMS 2FA to /admin login via the sms8 MCP. Lock the account after
5 failed verify_otp attempts.

Fertige Codebeispiele

Jede Datei in examples/ ist produktionsreif, ohne Abhängigkeiten und kann kopiert und eingefügt werden. Dies ist das, was die KI nach einem setup_sms8-Handshake generiert.

• php-send.php: minimale Sms8Sender-Klasse mit send, sendOtp, verifyOtp
• js-fetch.js: Node / Browser / Cloudflare Worker Client (ESM und CommonJS)
• otp-flow.php: vollständiger Telefonverifizierungsablauf (startSignup + verifySignup)
• webhook-handler.php: Handler für eingehende SMS mit HMAC-Signaturprüfung

Häufig gestellte Fragen

Was ist der SMS8 MCP-Server?

Ein HTTPS-Endpunkt unter mcp.sms8.io, der das Model Context Protocol implementiert. KI-Coding-Tools rufen seine JSON-RPC-Schnittstelle auf, um SMS zu senden, OTPs auszugeben und Webhooks zu konfigurieren. SMS werden über ein gekoppeltes Android-Telefon über die SMS8-Plattform geleitet.

Wie unterscheidet sich das von Twilio?

SMS8 verwendet Ihr eigenes Android-Telefon als Gateway mit Ihrer vorhandenen SIM-Karte. Es fallen keine Gebühren pro Nachricht beim Mobilfunkanbieter an, keine A2P 10DLC-Registrierung und keine Bereitstellung von Telefonnummern. Sie zahlen einen Pauschalplan und senden unbegrenzt SMS. Der MCP-Server stellt sieben Tools bereit, die Ihr KI-Assistent direkt aufrufen kann, was Twilio nicht bietet.

Funktioniert das mit Claude Code?

Ja. Fügen Sie den MCP-Server zu ~/.config/claude/mcp-servers.json mit dem HTTP-Transport hinzu, der auf https://mcp.sms8.io zeigt, und Ihrem SMS8-API-Schlüssel als Bearer-Token. Oder führen Sie /plugin marketplace add 1fancy/sms8-sms-gateway gefolgt von /plugin install sms8-sms-gateway aus.

Funktioniert das mit Cursor und Windsurf?

Ja. Beide unterstützen HTTP-MCP-Server. Fügen Sie https://mcp.sms8.io mit Ihrem API-Schlüssel als Bearer-Header zu ~/.cursor/mcp.json (Cursor) oder ~/.codeium/windsurf/mcp_config.json (Windsurf) hinzu. Der Einrichtungsassistent unter app.sms8.io/mcp-setup.php füllt das JSON pro Tool vor.

Kann die KI automatisch eine OTP-Verifizierung hinzufügen?

Ja. Der mitgelieferte Claude Code Skill (skills/send-sms/SKILL.md) lehrt den Assistenten, wann send_otp und verify_otp aufzurufen sind und wie eine bestehende Anmelde- oder Login-Route mit dem Verifizierungsschritt umschlossen wird. Ein Prompt wie "Füge Telefonverifizierung zu /signup hinzu" ist ausreichend.

Ist der Quellcode öffentlich?

Ja, MIT-lizenziert. Der Server, alle sieben Tool-Implementierungen, der npm-Launcher (@sms8/mcp), das Claude Code Plugin-Manifest und Beispielcode befinden sich in diesem Repo.

Was passiert mit meinem API-Schlüssel?

Ihr API-Schlüssel authentifiziert jeden MCP-Tool-Aufruf über einen Authorization: Bearer-Header (oder X-Api-Key). Der gehostete Server validiert ihn gegen Ihr SMS8-Konto und leitet den Aufruf dann durch die bestehende SMS8-Sendepipeline. Die setup_sms8-Antwort gibt nur die letzten vier Zeichen Ihres Schlüssels zurück, sodass er niemals in den KI-Chatverlauf oder die Protokolle gelangt.

Ist die Verwendung in der Produktion sicher?

Ja. Serverseitige Schutzmaßnahmen umfassen:

• Pro-Schlüssel-Ratenbegrenzung, übernommen von der SMS8-API
• Harte Obergrenze von 5 OTPs pro Telefonnummer pro 24 Stunden, nicht benutzerkonfigurierbar
• Erneutes Senden erst nach einer Abklingzeit von 30 bis 600 Sekunden (Standard 60 Sekunden)
• Nur-POST-OTP-Endpunkte; GET gibt 405 zurück; Cookies werden ignoriert
• Transaktionsumhüllte Ratenbegrenzungsprüfungen mit Zeilensperren; gleichzeitige Aufrufe können die Grenzen nicht überschreiten
• HMAC-SHA256-Webhook-Signaturen
• Umfassende SSRF-Blockliste auf create_webhook, die RFC1918, CGNAT, Link-Local, IPv4-gemapptes IPv6 und DNS-aufgelöste Hosts abdeckt
• CORS wird nur für Erkennungsmethoden beworben; tools/call lässt CORS weg, sodass eine bösartige Webseite keine SMS-Sendungen veranlassen kann

Kann ich den MCP-Server selbst hosten?

Ja. Klonen Sie das Repo, setzen Sie SMS8_APP_PATH auf Ihr SMS8-Installationsverzeichnis und führen Sie aus:

git clone https://github.com/1fancy/sms8-sms-gateway.git
cd sms8-sms-gateway
export SMS8_APP_PATH=/path/to/your/sms8-install
php -S 127.0.0.1:8080 index.php

Der gehostete Server unter mcp.sms8.io ist kostenlos und für die meisten Benutzer einfacher.

Was ist "Vibe Coding"?

Vibe Coding bedeutet, funktionierende Software zu liefern, indem man einem KI-Assistenten in einfachem Englisch beschreibt, was man möchte, anstatt jede Zeile von Hand zu schreiben. SMS8 MCP macht eine der häufigsten Anforderungen ("SMS-Benachrichtigungen hinzufügen") möglich, ohne jemals ein Mobilfunkportal oder A2P-Papierkram anfassen zu müssen.

Sicherheit und Geheimnisse

Dieses Repository enthält keine Geheimnisse. Alle Anmeldeinformationen befinden sich in Umgebungsvariablen oder der MCP-Konfiguration Ihres KI-Tools:

SMS8_API_KEY=sk_…        # from app.sms8.io → Profile → API
SMS8_WEBHOOK_SECRET=…    # from app.sms8.io → Webhook

Vollständige Sicherheitsdetails finden Sie im obigen FAQ-Abschnitt. Eine separate Zusammenfassung des Sicherheitsaudits ist auf Anfrage erhältlich.

Repository-Struktur

.
├── README.md                       this file
├── LICENSE                         MIT
├── index.php                       MCP server entry (JSON-RPC dispatcher)
├── landing.html                    marketing landing at mcp.sms8.io
├── .claude-plugin/plugin.json      Claude Code plugin manifest
├── .mcp.json                       MCP server config referenced by the plugin
├── skills/send-sms/SKILL.md        teaches Claude when to invoke SMS8 tools
├── npm-packages/                   five published npm packages
│   ├── sms8-mcp/                   MCP stdio bridge (sms8-mcp)
│   ├── sms8-cli/                   universal CLI (sms8)
│   ├── sms-otp-using-myphone/      OTP-only brand of the CLI
│   ├── phone-sms-gateway/          phone-as-gateway brand of the CLI
│   └── send-sms-from-android/      Android-first brand of the CLI
├── lib/                            Auth, JsonRpc, ToolRegistry
├── tools/                          7 tool implementations
└── examples/                       PHP and JS drop-in samples

Roadmap

• HTTP-MCP-Server live unter mcp.sms8.io
• OTP-Endpunkte mit Missbrauchsobergrenze pro Telefon
• npm-Pakete sms8-mcp, sms8-cli, sms-otp-using-myphone, phone-sms-gateway, send-sms-from-android
• Claude Code Plugin und Skill
• MMS-Unterstützung
• Eingehende SMS automatisch zur Antwortgenerierung an KI weitergeleitet
• Pro-Tool-Ratenbegrenzungen im Dashboard konfigurierbar
• Codebeispiele in Python, Go und Ruby

Mitwirken

Issues und Pull Requests sind willkommen unter github.com/1fancy/sms8-sms-gateway. Eröffnen Sie eine Diskussion vor größeren Änderungen.

Lizenz

MIT. Siehe LICENSE.

Schlüsselwörter

model context protocol, mcp server, mcp sms, claude code sms, claude code mcp, cursor mcp, windsurf mcp, sms api, otp api, sms gateway, android sms gateway, twilio alternative, vibe coding, ai sms integration, sms notifications, send sms from claude, send sms from cursor, phone verification api, sms otp, 2fa sms, webhook sms, inbound sms, two-way sms, unlimited sms, no per-message fees, no A2P 10DLC, ai coding tools, sms8