Einmalige Aktivierung · REST + MCP

Eine Nummer, ein Code

Kaufen Sie eine private Nummer, fangen Sie den Bestätigungscode ab, weiter geht's. Die Aktivierung lebt etwa 20 Minuten – und kommt nie eine SMS an, behalten Sie Ihr Geld: Prepaid-Guthaben wird gutgeschrieben, eine nicht abgerechnete x402-Reservierung wird freigegeben.

Laufzeit
Etwa 20 Minuten
Was Sie bekommen
Ein Bestätigungscode
Am besten für
Kontobestätigung und OTP-Abläufe
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 auf, dann Länder. Verfügbarkeit und exakte USD-Preise kommen live zurück.

    GET /v1/sms/activation/servicesGET /v1/sms/activation/countries sms_activation_list_servicessms_activation_list_countries
  2. 2

    Eine Nummer kaufen

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

    POST /v1/sms/activation/numbers sms_activation_buy_number
  3. 3

    Auf den Code pollen

    Lesen Sie den Status alle paar Sekunden, bis ein Code ankommt oder die Aktivierung abgeschlossen ist.

    GET /v1/sms/activation/numbers/{id} sms_activation_get_code
  4. 4

    Abschließen oder erstatten

    Nutzen Sie den Code sofort. Kommt vor Ablauf keine SMS an, wird die Aktivierung automatisch erstattet.

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.

5 Tools für dieses Produkt

  • sms_activation_list_services
  • sms_activation_list_countries
  • sms_activation_buy_number
  • sms_activation_get_code
  • sms_activation_list_numbers

Fragen Sie Ihren Agenten

Finde das günstigste verfügbare Land für WhatsApp, kaufe eine Aktivierung und warte auf den Bestätigungscode.
Zeig mir die verfügbaren Länder und die exakten aktuellen Preise für eine Telegram-Aktivierung, bevor du etwas kaufst.
Prüfe meine aktiven SMS-Aktivierungen und melde jeden eingegangenen Code.

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/activation/services'
curl 'https://api.voxisim.com/v1/sms/activation/countries?service_id=SERVICE_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/activation/numbers \
  -H 'authorization: Bearer YOUR_VXS_API_KEY' \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID}'

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/activation/numbers \
  -H 'content-type: application/json' \
  -d '{"service_id":"SERVICE_ID","country_id":COUNTRY_ID}'

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

3. Auf den Code pollen

Pollen Sie alle paar Sekunden, bis codes nicht mehr leer oder done wahr ist.

curl 'https://api.voxisim.com/v1/sms/activation/numbers/YOUR_ACTIVATION_ID' \
  -H 'authorization: Bearer YOUR_VXS_API_KEY'
Methode Route Was sie tut
GET /v1/sms/activation/services Dienste und die günstigsten aktuellen Optionen auflisten
GET /v1/sms/activation/countries Länder, Verfügbarkeit und exakte Preise auflisten
POST /v1/sms/activation/numbers Eine einmalige Nummer kaufen
GET /v1/sms/activation/numbers/{id} Status und empfangene Codes lesen
GET /v1/sms/activation/numbers Aktive oder archivierte Aktivierungen auflisten

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.

Keine SMS, keine Kosten

Kommt vor Ablauf der rund 20 Minuten nichts an, erfolgt die Erstattung automatisch. Prepaid-Guthaben wird gutgeschrieben und eine x402-Autorisierung wird freigegeben, ohne je abgerechnet zu werden – Sie müssen nicht danach fragen.

Ein Code, dann ist er verbraucht

Pollen Sie, bis codes nicht mehr leer oder done wahr ist, und nutzen Sie den Code zügig. Eine Aktivierung fängt keine zweite Nachricht ab; starten Sie für einen weiteren Versuch eine neue.

Secrets gehören nicht in Prompts

vxs_-Schlüssel und x402-receipt_token-Werte gehören in einen Secret-Manager – nicht in Prompts, in die Versionsverwaltung oder in Logs.

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-Aktivierung

Sie sind hier

Kaufen Sie eine einmalige Rufnummer und empfangen Sie deren Bestätigungscode.

  • Etwa 20 Minuten
  • Ein Bestätigungscode
  • Kontobestätigung und OTP-Abläufe

SMS-Miete

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
Leitfaden „SMS-Miete“ lesen

Wo eine einmalige Aktivierung passt

EinmalpasswörterKontobestätigungRegistrierungs- und QA-AutomatisierungKurze Agentenaufgaben

FAQ

Fragen zur Aktivierung

  • Etwa 20 Minuten ab Kauf. Dieses Zeitfenster dient dem Empfang des Codes, nicht dem Behalten der Nummer – nach Ablauf ist die Nummer weg und lässt sich nicht verlängern.

  • Sie werden bei Ablauf automatisch erstattet. Es gibt kein Support-Ticket und keinen Antrag: Prepaid-Guthaben wird gutgeschrieben, und eine nie abgerechnete x402-Autorisierung wird einfach freigegeben.

  • Nein. Eine Aktivierung gilt für genau eine Verifizierung. Müssen Sie erneut verifizieren, kaufen Sie eine weitere – auch deshalb ist sie pro Code die günstigste Option.

  • Meist innerhalb von Sekunden, nachdem der Dienst sie gesendet hat, aber das hängt allein am Dienst, nicht an uns. Pollen Sie alle paar Sekunden, statt auf einen einzelnen langen Request zu warten.

  • Nein. Rufen Sie den Länder-Endpunkt unmittelbar vor dem Kauf auf – er liefert aktuelle Verfügbarkeit und den exakten Preis, und beides bewegt sich mit dem realen Angebot.

  • Ja. Senden Sie den Kauf ohne Zugangsdaten, signieren Sie die zurückkommende x402-Challenge und wiederholen Sie den Request. Für die Discovery brauchten Sie ohnehin nie Zugangsdaten.

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.

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.