Platfone - Receive SMS & Virtual Numbers MCP

offiziell

Virtuelle Telefonnummernplattform für KI-Agenten – Nummern in über 200 Ländern mieten, SMS empfangen und den gesamten Aktivierungslebenszyklus verwalten

GitHub

Was kann man mit Platfone Receive SMS & Virtual Numbers MCP machen?

Kontostand prüfen — Bitten Sie die KI, Ihre gesamten, reservierten und verfügbaren Guthaben mit get_balance abzurufen.
Kosten und Verfügbarkeit prüfen — Überprüfen Sie vor der Bestellung die Preise und die Nummernverfügbarkeit für ein Länder- und Dienstpaar mit check_price.
Virtuelle Nummer bestellen — Mieten Sie eine temporäre Telefonnummer nach Land und Dienstname über order_number, um eine Aktivierungs-ID und Telefonnummer zu erhalten.
Auf eingegangene SMS prüfen — Überprüfen Sie mit check_sms, ob ein SMS-Code für eine Aktivierung eingegangen ist; Status und Abrufanleitung werden zurückgegeben.
Neue SMS anfordern — Lösen Sie einen kostenlosen erneuten Versuch aus, um eine weitere SMS auf derselben Nummer mit retry_activation zu erhalten.
Stornieren und Rückerstattung — Geben Sie eine aktive Aktivierung frei und holen Sie reservierte Guthaben mit cancel_activation zurück, bevor eine SMS eingeht.

Dokumentation

Platfone MCP Server

Platfone bietet virtuelle Telefonnummern für Kontoverifizierung, Tests und Automatisierungs-Workflows. Der Platfone MCP Server ermöglicht es KI-Agenten, temporäre Nummern zu beziehen und SMS-Nachrichten von MCP-kompatiblen Clients wie Claude, VS Code Copilot, Codex usw. zu empfangen.

📖 Dokumentation · 🔧 Einrichtungsanleitung · 🔑 API-Schlüssel erhalten · 📦 npm

Warum MCP?

Anstatt die API manuell zu integrieren, können KI-Agenten:

Nummern autonom nach Land und Dienstname bestellen
Auf SMS-Codes warten
Aktivierungen wiederholen oder abbrechen

Alles über strukturierte Tool-Aufrufe – kein benutzerdefiniertes Backend erforderlich.

Funktionen

Vollständiger Aktivierungslebenszyklus – von der Bestellung einer Nummer bis zum SMS-Empfang
ETag-gecachter Katalog – Länder und Dienste werden mit 5-minütiger TTL und ETag-basierter bedingter Aktualisierung im Speicher zwischengespeichert – niemals an den Agenten gesendet
Benutzerfreundliche Eingaben – verwenden Sie "Israel" oder "Telegram" anstelle von IDs; Namen werden serverseitig automatisch aufgelöst
Dualer Transport – stdio und http aus einer einzigen Codebasis
API-Schlüssel-Authentifizierung – funktioniert mit Ihrem vorhandenen Platfone-API-Schlüssel

Installation

Siehe die vollständige Installationsanleitung für detaillierte Anweisungen.

Schnellstart

NPM:

PLATFONE_API_KEY=your_key npx @platfone/mcp

Agenten-Richtlinien

Rufen Sie immer zuerst check_price auf, um Kosten und Verfügbarkeit zu prüfen
Rufen Sie dann order_number auf, um eine Nummer zu mieten
Rufen Sie check_sms auf, bis eine SMS empfangen wurde oder abgelaufen ist
Verwenden Sie retry_activation, wenn keine SMS ankommt
Verwenden Sie cancel_activation, um Guthaben freizugeben, wenn es nicht mehr benötigt wird

Tools

Tool	Beschreibung
`get_balance`	Kontostand prüfen: Gesamt-, reservierte und verfügbare Mittel.
`check_price`	Preis und Verfügbarkeit für ein Land + Dienst-Paar vor der Bestellung prüfen.
`order_number`	Eine virtuelle Telefonnummer bestellen. Akzeptiert Namen ("Israel") oder IDs ("il"). Gibt `activation_id` + `phone` zurück.
`check_sms`	Aktivierungsstatus abfragen. Gibt den SMS-Code bei Empfang zurück oder den aktuellen Status mit Abfrageanweisungen.
`retry_activation`	Eine weitere SMS auf derselben Nummer anfordern. Kostenlos.
`cancel_activation`	Eine aktive Aktivierung abbrechen, bevor eine SMS empfangen wird. Reservierten Betrag zurückerstatten.

Hinweis: Länder- und Dienstkataloge werden serverseitig zwischengespeichert und automatisch aus lesbaren Namen aufgelöst. Der Agent erhält niemals den vollständigen Katalog – nur aufgelöste IDs oder Hinweise zur Begriffsklärung.

Typischer KI-Agenten-Ablauf

1. check_price         (country: "Israel", service: "Telegram")  → verify cost & availability
2. order_number        (country: "Israel", service: "Telegram")  → returns activation_id + phone
3. check_sms           (activation_id)                            → poll or check once for SMS

Optionale Schritte:

retry_activation – eine weitere SMS auf derselben Nummer anfordern (kostenlos)
cancel_activation – abbrechen, bevor eine SMS eintrifft (Guthaben wird zurückerstattet)

Entwicklung

Lesen Sie den vollständigen Entwicklungsleitfaden für Einrichtungsanweisungen und Testtipps.

Fehlerbehebung

Fehler	Lösung
`UnauthorizedException`	Überprüfen Sie, ob Ihr `PLATFONE_API_KEY` gültig ist
`PaymentRequiredException`	Laden Sie Ihr Platfone-Guthaben auf
`NoNumbersAvailableException`	Versuchen Sie ein anderes Land oder einen anderen Dienst
`TooManyRequestsException`	Ratenbegrenzung – warten und erneut versuchen
`MaxPriceExceededException`	Wiederholen Sie `order_number` mit dem vorgeschlagenen `max_price` und dem zurückgegebenen `order_id`
`TooManyActivationsException`	Maximale Anzahl gleichzeitiger aktiver Aktivierungen erreicht – abbrechen oder auf Ablauf warten

Lizenz

Siehe LICENSE.md. Lizenziert unter der MIT-Lizenz.

Die Nutzung der Platfone-API unterliegt den Nutzungsbedingungen und der Datenschutzrichtlinie.