Wavix

offiziell

Wavix ist eine globale Kommunikationsplattform, die APIs für Sprache, SMS, 2FA und Telefonnummern anbietet. Unser MCP-Server bringt diese Funktionen in KI-Agenten und agentische Workflows.

GitHub

Was kann man mit Wavix MCP machen?

SMS- oder MMS-Nachrichten senden — Bitten Sie den Assistenten, eine Text- oder Mediennachricht mit sms_and_mms_messages_send zu senden.
Einen 2FA-Verifizierungsablauf durchführen — Lassen Sie den Assistenten eine Verifizierung mit two_fa_verification_create erstellen und den erhaltenen Code mit two_fa_verification_check überprüfen.
Telefonnummern suchen und kaufen — Finden Sie verfügbare Nummern nach Land und Fähigkeit mit buy_numbers_list, fügen Sie sie Ihrem Warenkorb hinzu und schließen Sie den Kauf ab.
Gesprächstranskripte analysieren — Durchsuchen Sie Anrufaufzeichnungen nach bestimmten Phrasen mit cdrs_search und rufen Sie vollständige Metadaten mit cdrs_get ab.
Aufnahmen und Transkriptionen herunterladen — Erhalten Sie eine Anrufaufzeichnungs-URL über call_recording_get, fordern Sie eine Transkription mit cdrs_retranscribe an und rufen Sie das Ergebnis ab.
Abrechnung prüfen und Rechnungen herunterladen — Überprüfen Sie Transaktionen mit billing_transactions_list und erhalten Sie einen vorab signierten PDF-Download-Link über billing_invoices_download.

Dokumentation

Wavix MCP Server

Ein Model Context Protocol-Server, der LLMs und KI-Agenten direkten Zugriff auf die Wavix-Telekommunikationsplattform gewährt – SMS/MMS, Sprachanrufe, 2FA, SIP-Trunking, Rufnummernverwaltung, 10DLC-Registrierung, Anrufaufzeichnungen, Sprachanalytik und Abrechnung.

Wavix ist eine globale Kommunikationsplattform zum Versenden von SMS, Tätigen von Sprachanrufen und Ausführen von 2FA-Abläufen über eine einzige API. Eine kostenlose Testphase ist verfügbar; die kostenpflichtige Nutzung richtet sich nach dem mit Ihrem Konto verknüpften Wavix-Preismodell.

Der schnellste Weg, diesen MCP-Server zu nutzen, ist der gehostete Endpunkt unter https://mcp.wavix.com/mcp – verbinden Sie einen beliebigen MCP-kompatiblen Client damit und authentifizieren Sie sich mit Ihrem Wavix-API-Schlüssel. Falls Sie Self-Hosting benötigen (benutzerdefinierte Wavix-Instanz, hinter einer Firewall, dedizierte Instanz), lesen Sie Eigenen Server betreiben.

Inhaltsverzeichnis

Endpunkt
Installation – Ein-Klick, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
Eigenen Server betreiben (Self-Host)
Beispiele
Werkzeuge → vollständiger Katalog in TOOLS.md
Ressourcen
Authentifizierung (Best Practices, bei Kompromittierung eines Tokens)
Fehlerbehebung
Kompatibilität & Einschränkungen
Support, Mitwirken, Sicherheit, Lizenz

Endpunkt

Feld	Wert
URL	`https://mcp.wavix.com/mcp`
Transport	Streamable HTTP
Authentifizierung	`Authorization: Bearer <api_key>`
Werkzeuge	siehe TOOLS.md
Ressourcen	Wavix-Dokumentation + OpenAPI-Spezifikation (automatisch erkannt)

Beziehen Sie einen Wavix-API-Schlüssel über die Wavix-Konsole → Administration → API-Schlüssel → Neu erstellen.

Installation

Bevor Sie beginnen: Besorgen Sie sich Ihren Wavix-API-Schlüssel.

Melden Sie sich unter https://wavix.com an.
Öffnen Sie Administration → API-Schlüssel.
Klicken Sie auf Neu erstellen (oder kopieren Sie einen vorhandenen Schlüssel). Halten Sie ihn bereit – Sie fügen ihn unten anstelle von YOUR_API_KEY ein.

Ein-Klick-Installation

⚠️ Die folgenden Schaltflächen befüllen die MCP-Konfiguration Ihres Editors mit einem Platzhalter-Token YOUR_API_KEY. Nachdem der Editor die Installation abgeschlossen hat, öffnen Sie die generierte Konfiguration und ersetzen Sie den Platzhalter durch Ihren echten API-Schlüssel, bevor Sie eine Anfrage senden – andernfalls gibt jeder Aufruf 401 Unauthorized zurück.

Zum späteren Entfernen: Öffnen Sie dieselbe Konfigurationsdatei (~/.cursor/mcp.json, .vscode/mcp.json oder das Äquivalent für Ihren Editor) und löschen Sie den Eintrag wavix oder entfernen Sie den Connector über die MCP-/Connector-Benutzeroberfläche Ihres Editors.

Claude Code

claude mcp add --transport http wavix https://mcp.wavix.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Verwenden Sie claude mcp list zur Überprüfung und /mcp innerhalb einer Sitzung für den Status.

Claude Desktop / Claude Web

Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen:

Name: Wavix
URL: https://mcp.wavix.com/mcp
Transport: Streamable HTTP
Authentifizierungs-Header: Authorization: Bearer <api_key>

Cursor (manuell)

Zu ~/.cursor/mcp.json (oder .cursor/mcp.json auf Projektebene) hinzufügen:

{
  "mcpServers": {
    "wavix": {
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Cursor 2.4+ stellt den vollständigen Katalog bereit; frühere Versionen sind auf 40 begrenzt.

VS Code (manuell, GitHub Copilot Chat)

Erstellen Sie .vscode/mcp.json in Ihrem Arbeitsbereich (oder fügen Sie dasselbe servers-Objekt unter dem Schlüssel "mcp" in der Benutzer-settings.json hinzu):

{
  "servers": {
    "wavix": {
      "type": "http",
      "url": "https://mcp.wavix.com/mcp",
      "headers": {
        "Authorization": "Bearer <api_key>"
      }
    }
  }
}

Siehe den VS Code MCP-Server-Leitfaden für das aktuelle Schema.

Codex CLI

Codex CLI unterstützt MCP über stdio. Verbinden Sie sich über mcp-remote mit dem gehosteten Server. Bearbeiten Sie ~/.codex/config.toml:

[mcp_servers.wavix]
command = "npx"
args = [
  "-y",
  "mcp-remote",
  "https://mcp.wavix.com/mcp",
  "--header",
  "Authorization:Bearer ${WAVIX_API_KEY}"
]

[mcp_servers.wavix.env]
WAVIX_API_KEY = "YOUR_API_KEY"

Windsurf / andere Clients

Jeder MCP-Client, der Streamable HTTP-Transport mit benutzerdefinierten Headern unterstützt, funktioniert. Verwenden Sie:

URL: https://mcp.wavix.com/mcp
Header: Authorization: Bearer <api_key>

Einrichtung über einen KI-Agenten? Verweisen Sie Ihren Agenten auf llms-install.md – es handelt sich um eine maschinenlesbare Installationsanleitung, die dem Modell die URL, den Header und die client-spezifische Konfiguration in einem deterministischen Format bereitstellt, sodass es keine Endpunktwerte improvisiert.

Eigenen Server betreiben

Der gehostete Server funktioniert für die meisten Benutzer sofort. Self-Hosting ist sinnvoll, wenn Sie auf eine nicht-öffentliche Wavix-Instanz verweisen, hinter einer Firewall betreiben oder in Ihrer eigenen Infrastruktur ausführen müssen.

Docker

docker build -t wavix-mcp-server .
docker run --rm -p 8000:8000 wavix-mcp-server

Der Server lauscht auf Port 8000 und stellt den MCP-Endpunkt unter /mcp bereit. Verweisen Sie Ihren Client auf http://<host>:8000/mcp.

Aus dem Quellcode

git clone https://github.com/Wavix/wavix-mcp-server.git
cd wavix-mcp-server
pip install -e .
wavix-mcp

Erfordert Python 3.10+.

Konfiguration

Umgebungsvariable	Standard	Zweck
`WAVIX_API_BASE_URL`	`https://api.wavix.com`	Überschreibt den vorgelagerten Wavix-API-Endpunkt (für interne Bereitstellungen oder Staging)

Es sind keine Wavix-Anmeldeinformationen erforderlich, um den Server auszuführen – sie werden pro Anfrage vom Authorization: Bearer <api_key>-Header des MCP-Clients weitergeleitet. Self-Hoster sind dafür verantwortlich, TLS vor dem Server zu terminieren (nginx, Caddy, Cloud-Load-Balancer), bevor er öffentlich zugänglich gemacht wird.

Beispiele

Konkrete Prompts, die Sie in jeden verbundenen Client einfügen können.

Die folgenden Telefonnummern (+1 310 555 0100, +44 7700 900123) befinden sich in reservierten Testbereichen (NANP 555 und Ofcom 070 09xx) – können bedenkenlos wörtlich kopiert werden, es sind keine echten Teilnehmer darüber erreichbar.

Eine transaktionale SMS senden

Prompt: "Sende eine SMS von +13105550100 an +447700900123 mit dem Text 'Ihr Bestätigungscode lautet 4821'."

Der Agent ruft sms_and_mms_messages_send mit from, to und text auf. Gibt die Nachrichten-ID und den Zustellstatus zurück.

Eine 2FA-Überprüfung durchführen

Prompt: "Sende einen 2FA-Bestätigungscode per SMS an +13105550100. Wenn ich dir den erhaltenen Code mitteile, prüfe, ob er korrekt ist."

Der Agent ruft two_fa_verification_create auf, wartet darauf, dass Sie den per SMS eingegangenen Code mitteilen, und ruft dann two_fa_verification_check auf. Nützlich für das Prototyping passwortloser Abläufe ohne Integration-Code schreiben zu müssen.

Eine Telefonnummer suchen und kaufen

Prompt: "Finde eine verfügbare gebührenfreie US-Nummer mit SMS-Funktion, lege sie in meinen Warenkorb und checke aus."

Der Agent verkettet buy_numbers_list (Filterung nach Land und Funktion), cart_add und cart_checkout. Vor dem Checkout mit dem Benutzer bestätigen – es belastet das Konto.

Anruftranskripte durchsuchen

Prompt: "Zeige mir alle eingehenden Anrufe von gestern, die länger als zwei Minuten dauerten und bei denen der Anrufer 'Rückerstattung' erwähnte."

Der Agent verwendet cdrs_search für Transkriptionen und reichert dann jedes Ergebnis über cdrs_get mit vollständigen Anrufmetadaten an.

Eine Aufzeichnung abrufen und transkribieren

Prompt: "Hole die Aufzeichnung für Anruf abc-123, lass Wavix sie transkribieren und gib die Transkription zurück."

Der Agent ruft call_recording_get auf (gibt eine vorab signierte Download-URL zurück), cdrs_retranscribe und fragt dann cdrs_transcription_get ab.

Abrechnung prüfen

Prompt: "Wie viel haben wir letzten Monat für SMS ausgegeben? Gib mir einen Download-Link für die aktuellste Rechnungs-PDF."

Der Agent ruft billing_transactions_list gefiltert nach Typ und Datum auf, dann billing_invoices_list + billing_invoices_download. Das Download-Werkzeug gibt eine vorab signierte URL zur PDF zurück, nicht die Datei selbst – öffnen Sie die URL in einem Browser oder übergeben Sie sie an Ihren Client, um das eigentliche Dokument abzurufen.

Werkzeuge

122 Werkzeuge, generiert aus der Wavix OpenAPI-Spezifikation. Argumente spiegeln Anfrageparameter und Body-Felder wider.

Gruppe	#	Abdeckung
SMS und MMS	10	Senden, auflisten, Nachrichten abrufen; Absender-IDs; Opt-outs
Anrufsteuerung	9	Anrufe starten / annehmen / beenden; Audio abspielen; DTMF sammeln
Anrufaufzeichnung	3	Auflisten, herunterladen (vorab signierte URL), löschen
Anruf-Streaming	2	Medienstream starten / stoppen
Anruf-Webhooks	3	Auflisten, erstellen, löschen
CDRs	6	Auflisten, exportieren, abrufen; Transkriptionssuche und erneute Transkription
Sprachanalytik	4	Hochladen, transkribieren, Originaldatei abrufen
2FA	6	Erstellen / prüfen / abbrechen / erneut senden der Verifikation; Ereignisse
Meine Nummern	7	Auflisten, aktualisieren, freigeben; SMS-/Sprach-Routing; Dokumentenupload
Kaufen	5	Länder, Regionen, Städte; verfügbare Nummernsuche
Warenkorb	4	Hinzufügen, entfernen, abrufen, Checkout
Nummernvalidator	3	Einzel- und Massenvalidierung
SIP-Trunks	5	Vollständiges CRUD
10DLC	30	Marken, Kampagnen, Überprüfung, Nachweise, Ereignisabonnements
Profil	3	Profil abrufen / aktualisieren; Kontokonfiguration
API-Schlüssel	5	Auflisten, erstellen, aktivieren / deaktivieren, löschen
Unterkonten	5	Auflisten, erstellen, abrufen, aktualisieren; Transaktionen
Abrechnung	3	Transaktionen, Rechnungen, Kontoauszug-Download
Sprachkampagnen	2	Auslösen und abrufen
Wavix Embeddable (WebRTC)	5	Widget-Token CRUD
Link-Shortener	2	Kurzlinks erstellen; Metriken

Siehe TOOLS.md für die vollständige Werkzeugliste mit einzeiligen Beschreibungen. Die maßgebliche Quelle ist die Wavix OpenAPI-Spezifikation – Ihr Client sieht stets den aktuellen Live-Katalog.

Ressourcen

Zusätzlich zu den Werkzeugen stellt der Server die Wavix-Dokumentation als MCP-Ressourcen bereit, sodass das Modell bei Bedarf autoritativen Kontext abrufen kann, anstatt aus Vorwissen zu raten.

URI-Schema	Inhalt
`wavix://docs/<path>`	Dokumentationsseiten von docs.wavix.com (automatisch erkannt über `llms.txt`).
`wavix://api/openapi.yaml`	Die vollständige Wavix OpenAPI 3.0-Spezifikation.

Beide Quellen – docs.wavix.com und die Wavix OpenAPI-Spezifikation – sind öffentlich verfügbar und können ohne Authentifizierung direkt durchsucht werden.

Ressourcen werden bei resources/read verzögert abgerufen und serverseitig mit einer TTL von 1 Stunde zwischengespeichert. Das vorgelagerte Bearer-Token wird niemals an Dokumentations-Hosts weitergeleitet – nur an api.wavix.com.

Authentifizierung

Jede Anfrage vom Client muss enthalten:

Authorization: Bearer <api_key>

Der Server leitet diesen Header pro Anfrage an api.wavix.com weiter. Das Token:

wird niemals protokolliert,
wird niemals bei hostübergreifenden Weiterleitungen weitergeleitet (z. B. vorab signierte S3-Download-URLs),
wird niemals an Dokumentations-Hosts gesendet.

Wenn Ihr Client einer vorab signierten Download-URL folgt, die von call_recording_get, billing_invoices_download, speech_analytics_file_get oder ten_dlc_brand_evidence_get zurückgegeben wurde, rufen Sie sie direkt ohne den Authorization-Header ab.

Best Practices

Verwenden Sie einen dedizierten API-Schlüssel für MCP. Erstellen Sie einen separaten API-Schlüssel unter https://wavix.com → Administration → API-Schlüssel (oder über das api_keys_create-Werkzeug selbst, aus einer anderen Sitzung). So können Sie den MCP-Zugriff widerrufen, ohne andere Integrationen zu stören.
Regelmäßig rotieren. Behandeln Sie den API-Schlüssel wie jedes Produktionsgeheimnis: rotieren Sie ihn planmäßig und bei jedem Verdacht auf Kompromittierung.
API-Schlüssel aus Git heraushalten. MCP-Client-Konfigurationen können leicht versehentlich committet werden, wodurch das Token in den Verlauf und die CI-Protokolle gelangt. Die meisten Clients unterstützen die Substitution von ${env:VAR} im Header-Wert – speichern Sie den API-Schlüssel in einer Umgebungsvariable oder Ihrem OS-Schlüsselbund und referenzieren Sie ihn aus der Konfiguration. Als Sicherheitsnetz fügen Sie die gängigen Client-Konfigurationspfade zur .gitignore Ihres Projekts hinzu:
```
.cursor/mcp.json
.vscode/mcp.json
claude_desktop_config.json
.claude/mcp.json
.codex/config.toml
```

Bei Kompromittierung eines Tokens

Deaktivieren Sie den Schlüssel sofort in der Wavix-Konsole (oder rufen Sie api_keys_deactivate auf).
Erstellen Sie einen Ersatz über api_keys_create oder die Konsole.
Aktualisieren Sie die Client-Konfiguration und stellen Sie die Verbindung wieder her.
Überprüfen Sie billing_transactions_list und cdrs_list auf unerwartete Aktivitäten.

Fehlerbehebung

Symptom	Wahrscheinliche Ursache / Lösung
`401 Unauthorized` von einem beliebigen Tool	Fehlender oder ungültiger `Authorization: Bearer …`-Header. Überprüfen Sie, ob der API-Schlüssel in der Wavix-Konsole aktiv ist.
Tool gibt eine `download_url` zurück, nicht die Datei selbst	Erwartetes Verhalten. Endpunkte für Aufzeichnungen, Rechnungen, Sprachanalysen und 10DLC-Nachweise liefern vorab signierte URLs (siehe Authentifizierung). Rufen Sie die URL direkt ohne den `Authorization`-Header ab.
Client zeigt nur ~40 Tools an, nicht den vollständigen Katalog	Ältere Clients erzwingen eine Tool-Obergrenze pro Server. Führen Sie ein Upgrade durch (Cursor 2.4+, neueste VS Code, neueste Claude).
`Tool not found` für ein in dieser README aufgeführtes Tool	Der lokale Client speichert möglicherweise eine veraltete Tool-Liste im Cache. Starten Sie den Client neu oder entfernen und fügen Sie den Server erneut hinzu.
4xx mit einem `errors`-Array	Validierungsfehler der Wavix-API. Überprüfen Sie `errors`; gleichen Sie dies mit der entsprechenden `wavix://docs/*`-Seite oder der OpenAPI-Spezifikation ab.
Server ist nicht erreichbar	Überprüfen Sie DNS und ausgehende HTTPS-Verbindungen zu `mcp.wavix.com:443`.
Agent ruft unerwartet ein destruktives Tool auf	Die meisten Clients können eine Bestätigung vor Tool-Aufrufen verlangen – aktivieren Sie diese Einstellung und wechseln Sie zu einem dedizierten MCP-API-Schlüssel (siehe Bewährte Methoden).

Kompatibilität & Einschränkungen

Kompatibel mit jedem MCP-Client, der Streamable HTTP-Transport unterstützt (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, benutzerdefinierte MCP-SDKs) und jedem Agenten-Framework mit einem MCP-Client-Adapter.
Ältere Clients können eine Tool-Obergrenze pro Server erzwingen; führen Sie ein Upgrade auf eine aktuelle Version durch, um auf den vollständigen Katalog zuzugreifen.
Ratenbegrenzungen und Nutzungsgebühren richten sich nach Ihrem Wavix-Kontoplan. Siehe Wavix-Preise.

Änderungsprotokoll

Der gehostete Server wird kontinuierlich aktualisiert, sobald sich die Wavix-OpenAPI-Spezifikation weiterentwickelt; neue Tools erscheinen automatisch und bestehende Tool-Argumente können optionale Felder erhalten. Dokumentationsänderungen für dieses Repository werden unter Releases verfolgt. Bei wesentlichen Verhaltensänderungen, die Tool-Eingaben oder die Authentifizierung betreffen, veröffentlichen wir eine Mitteilung sowohl dort als auch in den Wavix-Versionshinweisen.

Support

Produktdokumentation: https://docs.wavix.com
API-Referenz: https://docs.wavix.com/api-reference
Fragen / Feedback: support@wavix.com

Mitwirken

Dieses Repository ist quelloffen verfügbar, aber nicht für externe Beiträge geöffnet. Pull Requests werden automatisch geschlossen und Issues / Diskussionen sind deaktiviert. Senden Sie Fehlerberichte, Funktionswünsche und Feedback an support@wavix.com. Siehe CONTRIBUTING.md für Details.

Wenn Sie einen Fehler im zugrunde liegenden FastMCP-Framework finden, melden Sie ihn bitte direkt dort.

Sicherheit

Um eine Sicherheitslücke zu melden, senden Sie bitte eine E-Mail an support@wavix.com mit dem Betreff Security: <short summary>, anstatt ein öffentliches Issue zu eröffnen. Siehe SECURITY.md für Details.