Wavix

Wavix MCP Server

Ein Model Context Protocol-Server, der LLMs und KI-Agenten direkten Zugriff auf die Wavix-Telekommunikationsplattform bietet — SMS/MMS, Sprachrufe, 2FA, SIP-Trunks, Telefonnummernverwaltung, 10DLC-Registrierung, Anrufaufzeichnungen, Sprachanalysen und Abrechnung.

Wavix ist eine globale Kommunikationsplattform zum Senden von SMS, Tätigen von Sprachrufen und Ausführen von 2FA-Abläufen über eine einzige API. Eine kostenlose Testversion ist verfügbar; bezahlte Nutzung folgt dem Wavix-Preisplan, der mit Ihrem Konto verknüpft ist.

Der schnellste Weg, diesen MCP-Server zu nutzen, ist der gehostete Endpunkt unter https://mcp.wavix.com/mcp — richten Sie einen beliebigen MCP-kompatiblen Client darauf aus und authentifizieren Sie sich mit Ihrem Wavix-API-Schlüssel. Wenn Sie selbst hosten müssen (benutzerdefinierte Wavix-Bereitstellung, hinter einer Firewall, dedizierte Instanz), siehe Eigenen Server ausführen.

Inhaltsverzeichnis

• Endpunkt
• Installation — Ein-Klick, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
• Eigenen Server ausführen (Self-Hosting)
• Beispiele
• Tools → vollständiger Katalog in TOOLS.md
• Ressourcen
• Authentifizierung (Best Practices, wenn ein Token kompromittiert ist)
• Fehlerbehebung
• Kompatibilität & Grenzen
• Support, Mitwirken, Sicherheit, Lizenz

Endpunkt

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

Holen Sie sich einen Wavix-API-Schlüssel aus der Wavix Console → Verwaltung → API-Schlüssel → Neu erstellen.

Installation

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

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

Ein-Klick-Installation

⚠️ Die Schaltflächen unten fügen in die MCP-Konfiguration Ihres Editors einen Platzhalter-Token YOUR_API_KEY ein. 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.

Zur späteren Entfernung: Ö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-/Connectors-Oberflä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)

Hinzufügen zu ~/.cursor/mcp.json (oder projektweiter .cursor/mcp.json):

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

Cursor 2.4+ zeigt den vollständigen Katalog; frühere Versionen begrenzen auf 40.

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" im 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. Überbrücken Sie zum gehosteten Server über mcp-remote. 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? Richten Sie Ihren Agenten auf llms-install.md — dies ist eine maschinenlesbare Installationsanleitung, die dem Modell URL, Header und client-spezifische Konfiguration in einem deterministischen Format liefert, sodass es keine Endpunktwerte improvisiert.

Eigenen Server ausführen

Der gehostete Server funktioniert für die meisten Benutzer sofort. Hosten Sie selbst, wenn Sie auf eine nicht öffentliche Wavix-Bereitstellung zeigen, hinter einer Firewall laufen oder innerhalb Ihrer eigenen Infrastruktur arbeiten 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. Richten Sie Ihren Client auf http://<host>:8000/mcp aus.

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	Überschreiben des Upstream-Wavix-API-Endpunkts (für interne Bereitstellungen oder Staging)

Zum Ausführen des Servers sind keine Wavix-Anmeldeinformationen erforderlich — 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 sie ihn öffentlich verfügbar machen.

Beispiele

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

Telefonnummern unten (+1 310 555 0100, +44 7700 900123) liegen in reservierten Testbereichen (NANP 555 und Ofcom 070 09xx) — sicher, sie wörtlich zu übernehmen; keine echten Teilnehmer sind darüber erreichbar.

Transaktions-SMS senden

Prompt: „Senden Sie eine SMS von +13105550100 an +447700900123 mit dem Text ‚Ihr Verifizierungscode ist 4821‘."

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

2FA-Verifizierung ausführen

Prompt: „Senden Sie einen 2FA-Verifizierungscode per SMS an +13105550100. Wenn ich Ihnen den Code gebe, den ich erhalte, prüfen Sie, ob er korrekt ist."

Der Agent ruft two_fa_verification_create auf, wartet darauf, dass Sie den per SMS eingegangenen Code teilen, und ruft dann two_fa_verification_check auf. Nützlich zum Prototyping passwortloser Abläufe, ohne Integrationscode zu schreiben.

Telefonnummer finden und kaufen

Prompt: „Finden Sie eine verfügbare US-gebührenfreie Nummer mit SMS-Funktion, fügen Sie sie meinem Warenkorb hinzu und checken Sie aus."

Der Agent verknüpft buy_numbers_list (gefiltert nach Land und Funktion), cart_add und cart_checkout. Bestätigen Sie mit dem Benutzer vor dem Checkout — er belastet das Konto.

Anruf-Transkripte durchsuchen

Prompt: „Zeigen Sie mir alle eingehenden Anrufe von gestern, die länger als zwei Minuten dauerten und in denen der Anrufer ‚Rückerstattung‘ erwähnt hat."

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

Aufnahme abrufen und transkribieren

Prompt: „Holen Sie die Aufnahme für Anruf abc-123, bitten Sie Wavix, sie zu transkribieren, und geben Sie 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? Geben Sie mir einen Download-Link für die aktuellste Rechnungs-PDF."

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

Tools

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

Gruppe	#	Abdeckung
SMS und MMS	10	Senden, auflisten, abrufen von Nachrichten; Absender-IDs; Opt-outs
Anrufsteuerung	9	Anrufe starten / beantworten / beenden; Audio abspielen; DTMF sammeln
Anrufaufzeichnung	4	Auflisten, herunterladen (vorab signierte URL), löschen
Anruf-Streaming	2	Medienstream starten / stoppen
Anruf-Webhooks	3	Auflisten, erstellen, löschen
CDRs	7	Auflisten, exportieren, abrufen; Transkriptionssuche und erneutes Transkribieren
Sprachanalysen	4	Hochladen, transkribieren, Originaldatei abrufen
2FA	6	Verifizierung erstellen / prüfen / abbrechen / erneut senden; Ereignisse
Meine Nummern	6	Auflisten, aktualisieren, freigeben; SMS-/Sprach-Routing; Dokument-Upload
Kaufen	5	Länder, Regionen, Städte; Suche nach verfügbaren Nummern
Warenkorb	4	Hinzufügen, entfernen, abrufen, auschecken
Nummernvalidator	3	Einzel- und Massenvalidierung
SIP-Trunks	5	Vollständiges CRUD
10DLC	30	Marken, Kampagnen, Vetting, Nachweise, Ereignisabonnements
Profil	3	Profil abrufen / aktualisieren; Kontokonfiguration
API-Schlüssel	4	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 Tool-Liste mit einzeiligen Beschreibungen. Die maßgebliche Quelle ist die Wavix-OpenAPI-Spezifikation — Ihr Client sieht immer den aktuellen Live-Katalog.

Ressourcen

Zusätzlich zu den Tools stellt der Server die Wavix-Dokumentation als MCP-Ressourcen bereit, sodass das Modell bei Bedarf maßgeblichen Kontext abrufen kann, statt aus früherem Wissen 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 direkt ohne Authentifizierung durchsucht werden.

Ressourcen werden lazy bei resources/read abgerufen und serverseitig mit einer TTL von 1 Stunde zwischengespeichert. Das Upstream-Bearer-Token wird niemals an Dokumentations-Hosts weitergeleitet — nur an api.wavix.com.

Authentifizierung

Jede Anfrage vom Client muss Folgendes 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 → Verwaltung → API-Schlüssel (oder über das api_keys_create-Tool selbst, aus einer anderen Sitzung). So können Sie den MCP-Zugriff widerrufen, ohne andere Integrationen zu beeinträchtigen.

• Rotieren Sie regelmäßig. Behandeln Sie den API-Schlüssel wie jedes Produktionsgeheimnis: Rotieren Sie nach Plan und bei jedem Verdacht auf Leckage.

• Halten Sie API-Schlüssel aus Git heraus. MCP-Client-Konfigurationen lassen sich leicht versehentlich committen und nehmen das Token mit in die Historie und CI-Protokolle. Die meisten Clients unterstützen die ${env:VAR}-Substitution im Header-Wert — speichern Sie den API-Schlüssel in einer Umgebungsvariable oder im OS-Schlüsselbund und referenzieren Sie ihn aus der Konfiguration. Als Sicherheitsnetz fügen Sie die gängigen Client-Konfigurationspfade zu Ihrer .gitignore hinzu:

  .cursor/mcp.json
  .vscode/mcp.json
  claude_desktop_config.json
  .claude/mcp.json
  .codex/config.toml
  

Wenn ein Token kompromittiert ist

1. In der Wavix Console deaktivieren Sie den Schlüssel sofort (oder rufen Sie api_keys_deactivate an).
2. Erstellen Sie einen Ersatz über api_keys_create oder die Console.
3. Aktualisieren Sie die Client-Konfiguration und verbinden Sie sich erneut.
4. Überprüfen Sie billing_transactions_list und cdrs_list auf unerwartete Aktivitäten.

Fehlerbehebung

Symptom	Wahrscheinliche Ursache / Lösung
401 Unauthorized von jedem Tool	Fehlender oder ungültiger Authorization: Bearer …-Header. Überprüfen Sie, ob der API-Schlüssel in der Wavix Console aktiv ist.
Tool gibt ein download_url zurück, nicht die Datei selbst	Erwartet. Aufnahme-, Rechnungs-, Speech-Analytics- und 10DLC-Nachweis-Endpunkte geben vorab signierte URLs zurück (siehe Authentifizierung). Rufen Sie die URL direkt ohne den Authorization-Header ab.
Client zeigt nur ~40 Tools, nicht den vollständigen Katalog	Ältere Clients erzwingen eine Obergrenze für Tools pro Server. Aktualisieren Sie (Cursor 2.4+, neueste VS Code, neueste Claude).
Tool not found für ein in dieser README aufgeführtes Tool	Der lokale Client könnte eine alte Tool-Liste zwischenspeichern. Starten Sie den Client neu oder entfernen und fügen Sie den Server erneut hinzu.
4xx mit einem errors-Array	Validierungsfehler von der Wavix-API. Überprüfen Sie errors; vergleichen Sie die relevante wavix://docs/*-Seite oder die OpenAPI-Spezifikation.
Server nicht erreichbar	Bestätigen Sie DNS und ausgehendes HTTPS 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 und Grenzen

• 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 Agent-Framework mit einem MCP-Client-Adapter.
• Ältere Clients können eine Obergrenze für Tools pro Server erzwingen; aktualisieren Sie auf eine aktuelle Version, um den vollständigen Katalog zu nutzen.
• Ratenbegrenzungen und Nutzungsgebühren richten sich nach Ihrem Wavix-Kontoplan. Siehe Wavix-Preise.

Änderungsprotokoll

Der gehostete Server wird kontinuierlich aktualisiert, während sich die Wavix-OpenAPI-Spezifikation weiterentwickelt; neue Tools erscheinen automatisch und vorhandene 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 einen Hinweis 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 quellenverfügbar, aber nicht für externe Beiträge geöffnet. Pull-Requests werden automatisch geschlossen, und Issues / Diskussionen sind deaktiviert. Senden Sie Fehlerberichte, Funktionsanfragen 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 dort upstream.

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.

Lizenz

MIT © Wavix