Wiederverwendbare Miete · REST + MCP

Eine Nummer, die Ihnen bleibt

Mieten Sie eine private Nummer für einen Tag oder länger und empfangen Sie die ganze Zeit Nachrichten. Prüfen Sie, welche Intervalle verfügbar sind und was sie kosten, mieten Sie eines und verlängern Sie es, wenn eine Aufgabe länger dauert – oder kündigen Sie, wenn Sie fertig sind.

KI-Client verbinden Zum REST-Schnellstart springen
Laufzeit
Ein Tag oder länger
Was Sie bekommen
Mehrere SMS-Nachrichten
Am besten für
Sitzungen, Tests und dauerhaften Zugriff
800+ unterstützte Dienste
200+ Länder verfügbar
Ohne Anmeldung Preise ansehen
Pro Nummer niemals ein Abo

Jetzt loslegen

In unter einer Minute zum API-Schlüssel

Anmeldung per E-Mail-Adresse – ohne Karte, ohne Vertriebsgespräch. Der Anmeldelink bringt Sie direkt auf diese Seite zurück und übergibt Ihnen einen Schlüssel, der mit der REST-API und dem MCP-Server funktioniert.

Kostenlos anzulegen. Sie zahlen pro Nummer, nie ein Abo.

So funktioniert es

Vier Schritte von Anfang bis Ende

Jeder Schritt unten entspricht echten Endpunkten und echten Tools. Behalten Sie die id, die ein Kauf zurückgibt – alles Weitere hängt daran.

  1. 1

    Aktuelles Angebot abrufen

    Listen Sie Dienste, Länder und mietbare Intervalle mit ihren exakten aktuellen USD-Preisen auf.

    GET /v1/sms/rental/servicesGET /v1/sms/rental/countriesGET /v1/sms/rental/intervals sms_rental_list_servicessms_rental_list_countriessms_rental_list_intervals
  2. 2

    Für ein Intervall mieten

    Wählen Sie Prepaid-Guthaben oder kontenloses x402 und behalten Sie die zurückgegebene Miet-id.

    POST /v1/sms/rental/numbers sms_rental_buy_number
  3. 3

    Nachrichten einsammeln

    Pollen Sie während der gesamten Miete und nutzen Sie Cursor, um mehrere Nachrichten ohne Duplikate abzuholen.

    GET /v1/sms/rental/numbers/{id}/codes sms_rental_get_codes
  4. 4

    Kündigen oder verlängern

    Kündigen Sie, solange eine Erstattung möglich ist, oder listen Sie die verfügbaren Verlängerungen mit Preisen auf und verlängern Sie eine aktive Miete.

    POST /v1/sms/rental/numbers/{id}/cancelGET /v1/sms/rental/numbers/{id}/extend-optionsPOST /v1/sms/rental/numbers/{id}/extend sms_rental_cancelsms_rental_list_extend_optionssms_rental_extend

Einmal einrichten

Voxisim in Ihren KI-Client holen

Verbinden Sie den gehosteten Endpunkt, und Ihr Agent kann Optionen bepreisen, eine Nummer kaufen und Ihnen den Code liefern, ohne dass Sie einen Request schreiben. Nichts zu installieren: kein Paket, kein lokaler Server, kein Container – nur eine URL und eine Anmeldung im Browser.

Gehosteter Endpunkt https://api.voxisim.com/mcp
Streamable HTTP · OAuth oder Bearer-Schlüssel
  1. 01

    Endpunkt hinzufügen

    Wählen Sie unten Ihren Client und kopieren Sie den Block, den er braucht.

  2. 02

    Einmal anmelden

    Bestätigen Sie die OAuth-Abfrage im Browser oder übergeben Sie einen vxs_-Schlüssel aus Ihrem Secret-Manager, wenn Sie kein OAuth möchten.

  3. 03

    Einfach fragen

    Ihr Agent wählt die passenden Tools und reicht ids zwischen ihnen weiter, sodass ein einziger Satz den ganzen Ablauf abdeckt.

Claude

Web + Desktop

OAuth

Öffnen Sie Einstellungen → Connectors, fügen Sie einen eigenen Connector namens Voxisim hinzu und fügen Sie den gehosteten Endpunkt ein.

Keine Konfigurationsdatei 
https://api.voxisim.com/mcp

Wählen Sie „Verbinden“ und schließen Sie die Anmeldung im Browser ab. Aktivieren Sie Voxisim im Chat unter „Suche und Tools“.

Agenten-Workflow

Was Ihr Agent tatsächlich tut

Die Tools sind typisiert und nach Aufgabe benannt, Ergebnisse kommen deshalb als strukturierte Felder zurück statt als Fließtext, den ein Agent erneut lesen muss. Käufe laufen über Ihr Guthaben oder antworten mit einer Zahlungsaufforderung, die Ihr Agent aus einer Wallet begleicht.

9 Tools für dieses Produkt

  • sms_rental_list_services
  • sms_rental_list_countries
  • sms_rental_list_intervals
  • sms_rental_buy_number
  • sms_rental_get_codes
  • sms_rental_list_numbers
  • sms_rental_cancel
  • sms_rental_list_extend_options
  • sms_rental_extend

Fragen Sie Ihren Agenten

Vergleiche die aktuellen Mietintervalle für WhatsApp in den USA und zeig mir die exakten Preise.
Miete eine Nummer für das kürzeste verfügbare Intervall und beobachte sie auf neue Nachrichten.
Liste meine aktiven Mieten auf und verlängere die am schnellsten ablaufende um ein verfügbares Intervall.

REST

REST-Schnellstart

Discovery ist öffentlich – den ersten Block können Sie sofort ohne Konto ausführen. Für den Kauf brauchen Sie entweder einen Prepaid-Schlüssel oder eine signierte x402-Zahlung; der Request-Body ist in beiden Fällen identisch.

Zwei Zahlwege, ein Kaufaufruf

Ein Prepaid-Guthaben ist einfacher, wenn Sie häufig kaufen. Kontenloses x402 passt besser zum einmaligen autonomen Kauf – sichern Sie das receipt_token aus der ersten bezahlten Antwort, um später nachzulesen, was Sie gekauft haben.

1. Kostenlos erkunden

Kein Konto nötig. Rufen Sie aktuelle Verfügbarkeit und exakte Preise vor dem Kauf ab.

curl 'https://api.voxisim.com/v1/sms/rental/services'
curl 'https://api.voxisim.com/v1/sms/rental/countries?service_id=SERVICE_ID'
curl 'https://api.voxisim.com/v1/sms/rental/intervals?service_id=SERVICE_ID&country_id=COUNTRY_ID'

2A. Prepaid-Guthaben nutzen

Legen Sie einmal ein Konto an, laden Sie es per x402 auf und nutzen Sie den zurückgegebenen vxs_-Schlüssel für Käufe.

curl -X POST https://api.voxisim.com/v1/signup \
  -H 'content-type: application/json' \
  -d '{"label":"docs-quickstart"}'

curl -X POST https://api.voxisim.com/v1/sms/rental/numbers \
  -H 'authorization: Bearer YOUR_VXS_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"hours":HOURS}'

2B. Oder kontenlos per x402 zahlen

Senden Sie den Kauf ohne Zugangsdaten, signieren Sie eine Anforderung aus der 402-Antwort und wiederholen Sie denselben Request.

curl -i -X POST https://api.voxisim.com/v1/sms/rental/numbers \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"hours":HOURS}'

curl -X POST https://api.voxisim.com/v1/sms/rental/numbers \
  -H 'content-type: application/json' \
  -H 'X-PAYMENT: BASE64_SIGNED_AUTHORIZATION' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID,"hours":HOURS}'

3. Nachrichten abrufen

Pollen Sie während der gesamten Miete; nutzen Sie last_id, um nur neuere Nachrichten abzurufen.

curl 'https://api.voxisim.com/v1/sms/rental/numbers/YOUR_RENTAL_ID/codes' \
  -H 'authorization: Bearer YOUR_VXS_API_KEY'
Methode Route Was sie tut
GET /v1/sms/rental/services Mietbare Dienste auflisten
GET /v1/sms/rental/countries Länder zu einem Dienst auflisten
GET /v1/sms/rental/intervals Intervalle und exakte Preise auflisten
POST /v1/sms/rental/numbers Eine Nummer mieten
GET /v1/sms/rental/numbers Aktive oder archivierte Mieten auflisten
GET /v1/sms/rental/numbers/{id}/codes Empfangene SMS abrufen
POST /v1/sms/rental/numbers/{id}/cancel Eine aktive Miete kündigen
GET /v1/sms/rental/numbers/{id}/extend-options Verlängerungsdauern und Preise auflisten
POST /v1/sms/rental/numbers/{id}/extend Eine aktive Miete verlängern

Betriebshinweise

Erstattungen, Ablauf und sauberes Wiederaufsetzen

Ablauf und Aussetzer beim Anbieter sind normale Zustände, keine Ausnahmen. Verzweigen Sie über den typisierten Fehler, wiederholen Sie vorher die Discovery und gehen Sie nie davon aus, dass der Preis vom letzten Lauf noch gilt.

Intervalle kommen aus der Discovery

Dauern und Preise sind keine feste Auswahl – sie kommen aus der Live-Discovery der Intervalle. Der hours-Wert, den Sie beim Kauf senden, muss zu einer der Optionen passen, die in diesem Moment tatsächlich angeboten werden.

Nachrichten ohne Duplikate lesen

Pollen Sie mit last_id, damit jeder Aufruf nur Neues zurückgibt, und bewahren Sie die Miet-id auf – Sie brauchen sie zum Kündigen oder Verlängern.

Früh kündigen, spät verlängern

Kündigen Sie innerhalb des erstattungsfähigen Zeitfensters, wenn Sie die Nummer nicht mehr brauchen, oder verlängern Sie eine aktive Miete um jedes noch verfügbare Intervall.

Wenn etwas schiefgeht

  • invalid_argument – Ihr Dienst, Land oder Intervall ist veraltet. Wiederholen Sie die Discovery und senden Sie eine aktuell gültige Kombination.
  • payment_required – auf dem x402-Weg erwartet. Signieren Sie eine der angebotenen Anforderungen und wiederholen Sie exakt denselben Request.
  • number_unavailable oder ein Konflikt – diese Option ist gerade ausverkauft. Führen Sie die Discovery erneut aus und wählen Sie eine andere, statt denselben Kauf zu wiederholen.
  • provider_unavailable oder Rate-Limiting – warten Sie ab und beachten Sie den Retry-Hinweis im Fehler. Sofortiges Wiederholen macht es schlimmer.

Noch unsicher?

Aktivierung und Miete lösen unterschiedliche Probleme

Nehmen Sie die kürzeste Laufzeit, die Ihren Ablauf noch abdeckt. Verfügbarkeit und Preise sind für beide aktuell.

SMS-Miete

Sie sind hier

Mieten Sie eine Rufnummer für einen gewählten Zeitraum und empfangen Sie ihre SMS.

  • Ein Tag oder länger
  • Mehrere SMS-Nachrichten
  • Sitzungen, Tests und dauerhaften Zugriff

Wo eine Miete passt

Sitzungen mit mehreren NachrichtenLängere IntegrationstestsDauerhafter KontozugriffVon Agenten überwachte Postfächer

FAQ

Fragen zur Miete

  • Ein Tag ist das Minimum, längere Intervalle gehen von dort aus weiter. Fragen Sie den Intervall-Endpunkt, was für Ihren Dienst und Ihr Land tatsächlich angeboten wird, statt von einem festen Satz auszugehen – die Optionen unterscheiden sich.

  • So viele, wie während der Miete ankommen. Genau das ist der Unterschied zur Aktivierung, die nach einem Code endet.

  • Übergeben Sie beim Pollen last_id. Jeder Aufruf liefert dann nur Nachrichten, die neuer sind als die vorhandene – Sie können also häufig pollen, ohne auf Ihrer Seite zu deduplizieren.

  • Ja, solange sie aktiv ist, um jedes aktuell dafür verfügbare Intervall. Verlängern ist günstiger und weniger störend, als eine neue Nummer zu mieten, denn die Nummer selbst bleibt gleich.

  • Eine Kündigung im erstattungsfähigen Zeitfenster erstattet die Miete. Außerhalb dieses Fensters läuft die Miete einfach bis zum Ende ihrer Laufzeit – kündigen Sie also, sobald Sie wissen, dass Sie fertig sind.

  • Ja. Der x402-Weg funktioniert genau wie bei Aktivierungen: Kauf senden, die zurückkommende Challenge signieren und exakt denselben Request wiederholen.

Referenz

Die generierten Verträge

Diese Seite erklärt den Ablauf. Für jeden Parameter, jedes Antwortfeld und jede Tool-Eingabe gehen Sie in die Referenz – sie wird aus dem aktiven Vertrag erzeugt und kann deshalb nicht abweichen.

Interaktive APIOperationen in Scalar erkunden REST als MarkdownAus OpenAPI erzeugt MCP als MarkdownAus den Tool-Metadaten erzeugt OpenAPI JSONMaschinenlesbarer Vertrag

Bereit für Ihre erste Nummer?

Verbinden Sie einen MCP-Client und fragen Sie ihn – oder kopieren Sie den REST-Schnellstart und führen Sie ihn aus.

API-Referenz öffnen Beide Produkte vergleichen