Wavix

Server MCP Wavix

Server Model Context Protocol yang memberikan akses langsung kepada LLM dan agen AI ke platform telekomunikasi Wavix — SMS/MMS, panggilan suara, 2FA, SIP trunking, manajemen nomor telepon, registrasi 10DLC, rekaman panggilan, analitik ucapan, dan penagihan.

Wavix adalah platform komunikasi global untuk mengirim SMS, melakukan panggilan suara, dan menjalankan alur 2FA melalui satu API. Uji coba gratis tersedia; penggunaan berbayar mengikuti paket harga Wavix yang terpasang di akun Anda.

Cara tercepat menggunakan server MCP ini adalah endpoint yang di-hosting di https://mcp.wavix.com/mcp — arahkan klien yang kompatibel dengan MCP ke sana dan sambungkan dengan masuk menggunakan akun Wavix Anda atau dengan kunci API Wavix. Jika Anda perlu self-host (deployment Wavix khusus, di belakang firewall, instance khusus), lihat Jalankan sendiri.

Daftar isi

• Endpoint
• Instalasi — masuk dengan akun, kunci API, instalasi sekali klik, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
• Jalankan sendiri (self-host)
• Contoh
• Perkakas → katalog lengkap di TOOLS.md
• Sumber daya
• Autentikasi (praktik terbaik, jika token disusupi)
• Pemecahan masalah
• Kompatibilitas & batasan
• Dukungan, Kontribusi, Keamanan, Lisensi

Endpoint

Bidang	Nilai
URL	https://mcp.wavix.com/mcp
Transport	Streamable HTTP
Auth	Masuk dengan akun Wavix (OAuth 2.1), atau Authorization: Bearer <api_key>
Perkakas	lihat TOOLS.md
Sumber daya	Dokumentasi Wavix + spesifikasi OpenAPI (ditemukan otomatis)

Dapatkan kunci API Wavix dari Konsol Wavix → Administrasi → Kunci API → Buat baru.

Instalasi

Dua cara untuk terhubung — pilih mana yang didukung klien Anda; tidak ada yang lebih diutamakan dari yang lain.

Masuk dengan akun Wavix

Jika klien MCP Anda mendukung OAuth (Claude Desktop / Web, dan klien lain yang mendukung OAuth), sambungkan tanpa kunci API: tambahkan konektor untuk https://mcp.wavix.com/mcp dan, saat klien meminta, masuk dengan akun Wavix Anda dan setujui akses. Klien menjalankan alur OAuth 2.1 dan menyimpan tokennya sendiri — tidak ada yang perlu ditempel. Perkakas yang Anda dapatkan dibatasi sesuai yang Anda setujui dan peran akun Anda izinkan (lihat Pemecahan masalah).

Sambungkan dengan kunci API

Sebelum memulai: ambil kunci API Wavix Anda.

1. Masuk di https://wavix.com.
2. Buka Administrasi → Kunci API.
3. Klik Buat baru (atau salin kunci yang ada). Simpan baik-baik — Anda akan menempelkannya menggantikan YOUR_API_KEY di bawah.

Instalasi sekali klik

⚠️ Tombol di bawah mengisi konfigurasi MCP editor Anda dengan token placeholder YOUR_API_KEY. Setelah editor selesai menginstal, buka konfigurasi yang dihasilkan dan ganti placeholder dengan kunci API asli Anda sebelum mengirim permintaan apa pun — jika tidak, setiap panggilan akan mengembalikan 401 Unauthorized.

Untuk menghapus nanti: buka file konfigurasi yang sama (~/.cursor/mcp.json, .vscode/mcp.json, atau yang setara untuk editor Anda) dan hapus entri wavix, atau hapus konektor melalui UI MCP / Konektor editor Anda.

Claude Code

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

Gunakan claude mcp list untuk memverifikasi dan /mcp di dalam sesi untuk status.

Claude Desktop / Claude Web

Pengaturan → Konektor → Tambahkan konektor kustom:

• Nama: Wavix
• URL: https://mcp.wavix.com/mcp
• Transport: Streamable HTTP
• Header autentikasi: Authorization: Bearer <api_key>

Untuk terhubung dengan masuk sebagai gantinya, tambahkan konektor tanpa header autentikasi dan masuk dengan akun Wavix Anda saat klien meminta.

Cursor (manual)

Tambahkan ke ~/.cursor/mcp.json (atau .cursor/mcp.json tingkat proyek):

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

Cursor 2.4+ menampilkan katalog lengkap; versi sebelumnya dibatasi 40.

VS Code (manual, GitHub Copilot Chat)

Buat .vscode/mcp.json di ruang kerja Anda (atau tambahkan objek servers yang sama di bawah kunci "mcp" di settings.json pengguna):

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

Lihat panduan server MCP VS Code untuk skema terbaru.

Codex CLI

Codex CLI mendukung MCP melalui stdio. Jembatani ke server yang di-hosting melalui mcp-remote. Edit ~/.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 / klien lain

Klien MCP apa pun yang mendukung transport Streamable HTTP dengan header kustom akan berfungsi. Gunakan:

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

Menyiapkan melalui agen AI? Arahkan agen Anda ke llms-install.md — ini adalah panduan instalasi yang dapat dibaca mesin yang memberi model URL, header, dan konfigurasi per-klien dalam format deterministik sehingga tidak mengarang nilai endpoint.

Jalankan sendiri

Server yang di-hosting berfungsi langsung untuk sebagian besar pengguna. Self-host jika Anda perlu menunjuk ke deployment Wavix yang tidak publik, berjalan di belakang firewall, atau beroperasi di dalam infrastruktur Anda sendiri.

Docker

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

Server mendengarkan di port 8000 dan mengekspos endpoint MCP di /mcp. Arahkan klien Anda ke http://<host>:8000/mcp.

Dari sumber

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

Membutuhkan Python 3.10+.

Konfigurasi

Variabel env	Default	Tujuan
WAVIX_API_BASE_URL	https://api.wavix.com	Menimpa endpoint API Wavix hulu (untuk deployment internal atau staging)
OAUTH_ISSUER	tidak diatur	URL dasar server otorisasi OAuth 2.1. JWKS-nya dibaca dari <issuer>/.well-known/jwks.json
OAUTH_RESOURCE	tidak diatur	URL dasar publik tempat server ini diakses, digunakan sebagai pengidentifikasi sumber daya
OAUTH_API_KEY_PASSTHROUGH	true	Dengan OAuth aktif, tetap terima bearer yang bukan JWT OAuth dan teruskan ke hulu (kunci API tetap berfungsi). Setel false untuk mewajibkan JWT
MCP_PATH	/mcp	Jalur tempat endpoint MCP dilayani

Tidak ada kredensial Wavix yang diperlukan untuk menjalankan server — kredensial diteruskan per-permintaan dari header Authorization: Bearer <api_key> klien MCP. Pengguna self-host bertanggung jawab menghentikan TLS di depan server (nginx, Caddy, penyeimbang beban cloud) sebelum mengeksposnya secara publik.

OAuth 2.1 (opsional)

Setel OAUTH_ISSUER dan OAUTH_RESOURCE bersama-sama untuk mengubah server menjadi sumber daya yang dilindungi OAuth 2.1. Server kemudian menerbitkan metadata RFC 9728 di /.well-known/oauth-protected-resource<MCP_PATH>, memvalidasi token akses masuk sebagai JWT terhadap JWKS penerbit, dan menjawab permintaan tidak terautentikasi dengan tantangan WWW-Authenticate yang menunjuk ke metadata tersebut. Klien MCP yang mendukung OAuth menggunakan ini untuk menjalankan alur otorisasi sendiri, sehingga pengguna tidak lagi menempelkan kunci API ke konfigurasi klien mereka.

Audiens yang harus dibawa setiap token adalah OAUTH_RESOURCE + MCP_PATH, yang juga merupakan nilai resource yang diterbitkan dalam metadata. Server otorisasi yang mengimplementasikan RFC 8707 membandingkan parameter resource klien dengan string itu secara persis, jadi keduanya harus dikonfigurasi agar cocok — termasuk jalurnya.

Mengaktifkan OAuth tidak memutus klien yang terautentikasi dengan kunci API Wavix. Token bearer yang bukan JWT OAuth yang valid diteruskan ke hulu tanpa verifikasi, persis seperti sebelumnya, meninggalkan API Wavix sebagai satu-satunya otoritas — sehingga deployment yang ada dapat mengaktifkan OAuth untuk klien baru tanpa merusak yang sudah terhubung. Permintaan yang tidak membawa token sama sekali tetap mendapatkan tantangan WWW-Authenticate, yang memungkinkan klien yang mendukung OAuth menemukan server otorisasi. Hanya koneksi yang terautentikasi OAuth yang difilter cakupan; koneksi kunci API melihat seluruh permukaan perkakas.

Setel OAUTH_API_KEY_PASSTHROUGH=false untuk menghapus fallback itu dan mewajibkan JWT yang valid — mode ketat yang harus dialihkan setelah akses kunci API dihentikan.

Meninggalkan salah satu dari OAUTH_ISSUER / OAUTH_RESOURCE tidak diatur mempertahankan perilaku sebelumnya: tidak ada metadata yang diterbitkan dan token bearer apa pun yang dikirim klien diteruskan ke hulu tanpa verifikasi.

Contoh

Prompt konkret yang dapat Anda tempel ke klien mana pun yang terhubung.

Nomor telepon di bawah (+1 310 555 0100, +44 7700 900123) berada dalam rentang uji yang dicadangkan (NANP 555 dan Ofcom 070 09xx) — aman disalin apa adanya, tidak ada pelanggan asli yang dapat dijangkau melaluinya.

Kirim SMS transaksional

Prompt: "Kirim SMS dari +13105550100 ke +447700900123 berisi 'Kode verifikasi Anda adalah 4821'."

Agen memanggil sms_and_mms_messages_send dengan from, to, dan text. Mengembalikan ID pesan dan status pengiriman.

Jalankan verifikasi 2FA

Prompt: "Kirim kode verifikasi 2FA ke +13105550100 melalui SMS. Saat saya memberi Anda kode yang saya terima, periksa apakah benar."

Agen memanggil two_fa_verification_create, menunggu Anda membagikan kode yang tiba melalui SMS, lalu memanggil two_fa_verification_check. Berguna untuk membuat prototipe alur tanpa kata sandi tanpa menulis kode integrasi.

Temukan dan beli nomor telepon

Prompt: "Temukan nomor bebas pulsa AS yang tersedia dengan kemampuan SMS, tambahkan ke keranjang saya, dan selesaikan pembayaran."

Agen merangkai buy_numbers_list (memfilter berdasarkan negara dan fitur), cart_add, dan cart_checkout. cart_checkout pertama mengembalikan pratinjau dengan nomor dan biayanya, dan membebankan biaya ke akun hanya saat dipanggil lagi dengan confirmation_token-nya.

Cari transkrip panggilan

Prompt: "Tampilkan semua panggilan masuk dari kemarin yang lebih lama dari dua menit di mana penelepon menyebut 'refund'."

Agen menggunakan cdrs_search terhadap transkripsi, lalu memperkaya setiap hasil melalui cdrs_get untuk metadata panggilan lengkap.

Ambil rekaman dan transkripsikan

Prompt: "Ambil rekaman untuk panggilan abc-123, minta Wavix mentranskripsikannya, dan kembalikan transkripsinya."

Agen memanggil call_recording_get_by_call (mengembalikan URL unduhan yang telah ditandatangani), cdrs_retranscribe, lalu melakukan polling cdrs_transcription_get.

Audit penagihan

Prompt: "Berapa yang kami keluarkan untuk SMS bulan lalu, dan faktur apa yang diterbitkan?"

Agen memanggil billing_transactions_list yang difilter berdasarkan jenis dan tanggal, lalu billing_invoices_list. Mengunduh PDF faktur itu sendiri tidak diekspos melalui MCP — ambil dari API Wavix atau dasbor.

Perkakas

Dihasilkan dari spesifikasi OpenAPI Wavix. Argumen mencerminkan parameter permintaan dan bidang isi. Perkakas yang ditampilkan bergantung pada izin yang Anda setujui saat masuk dan fitur yang diaktifkan di akun Anda.

Grup	Cakupan
SMS dan MMS	Kirim, daftar, ambil pesan; ID pengirim; opt-out
WhatsApp	Akun Bisnis; pengirim; templat; kirim / daftar / ambil pesan
Kontrol panggilan	Mulai / jawab / akhiri panggilan; putar audio; kumpulkan DTMF
Rekaman panggilan	Daftar, unduh (URL pra-tanda tangan), hapus
Streaming panggilan	Mulai / hentikan streaming media
Webhook panggilan	Daftar, buat, hapus
CDR	Daftar, ambil; pencarian transkripsi dan transkripsi ulang
Analitik Ucapan	Transkripsi, ambil file asli
2FA	Buat / periksa / batalkan / kirim ulang verifikasi; peristiwa
Nomor saya	Daftar, perbarui, lepaskan; perutean SMS / suara
Beli	Negara, wilayah, kota; pencarian nomor yang tersedia
Keranjang	Tambah, hapus, ambil, checkout
Validator nomor	Validasi tunggal dan massal
Trunk SIP	CRUD lengkap
10DLC	Merek, kampanye, vetting, bukti, langganan peristiwa
Profil	Dapatkan / perbarui profil; konfigurasi akun
Kunci API	Daftar, buat, perbarui, hapus
Sub-akun	Daftar, buat, dapatkan, perbarui; transaksi
Penagihan	Transaksi; daftar faktur / laporan
Kampanye suara	Picu dan ambil
Wavix Embeddable (WebRTC)	CRUD token widget
Pemendek tautan	Buat tautan pendek; metrik

Lihat TOOLS.md untuk daftar alat lengkap dengan deskripsi satu baris. Sumber otoritatif adalah spesifikasi OpenAPI Wavix — klien Anda selalu melihat katalog langsung terkini.

Sumber Daya

Selain alat, server mengekspos dokumentasi Wavix sebagai Sumber Daya MCP, sehingga model dapat menarik konteks otoritatif sesuai permintaan alih-alih menebak dari pengetahuan sebelumnya.

Skema URI	Isi
wavix://docs/<path>	Halaman dokumentasi dari docs.wavix.com (ditemukan otomatis melalui llms.txt).
wavix://api/openapi.yaml	Spesifikasi lengkap OpenAPI 3.0 Wavix.

Kedua sumber — docs.wavix.com dan spesifikasi OpenAPI Wavix — tersedia untuk publik dan dapat dijelajahi langsung tanpa autentikasi.

Sumber daya diambil secara lambat pada resources/read dan di-cache di sisi server dengan TTL 1 jam. Token Bearer upstream tidak pernah diteruskan ke host dokumentasi — hanya ke api.wavix.com.

Autentikasi

Server yang di-host menerima dua metode koneksi — tidak ada yang lebih diutamakan:

• Masuk dengan akun Wavix (OAuth 2.1). Untuk klien yang mendukung OAuth. Klien menjalankan alur otorisasi dan pengguna masuk; tidak ada kunci API yang disimpan. Akses dibatasi cakupan sesuai yang disetujui pengguna dan diizinkan oleh peran akun mereka. Lihat Masuk dengan akun Wavix.
• Kunci API Wavix (Bearer). Untuk klien Streamable-HTTP apa pun. Setiap permintaan harus menyertakan:

Authorization: Bearer <api_key>

Server meneruskan header ini ke api.wavix.com per permintaan. Token:

• tidak pernah dicatat,
• tidak pernah diteruskan pada pengalihan lintas-host (mis. URL unduhan S3 pra-tanda tangan),
• tidak pernah dikirim ke host dokumentasi.

Jika klien Anda mengikuti URL unduhan pra-tanda tangan yang dikembalikan oleh call_recording_get_by_call, speech_analytics_file_get, atau ten_dlc_brand_evidence_get, ambil langsung tanpa header Authorization.

Praktik terbaik

• Gunakan kunci API khusus untuk MCP. Buat kunci API terpisah di https://wavix.com → Administrasi → Kunci API (atau melalui alat api_keys_create itu sendiri, dari sesi lain). Ini memungkinkan Anda mencabut akses MCP tanpa mengganggu integrasi lain.

• Rotasi secara berkala. Perlakukan kunci API seperti rahasia produksi lainnya: rotasi sesuai jadwal dan pada kecurigaan kebocoran apa pun.

• Jauhkan kunci API dari git. Konfigurasi klien MCP mudah ter-commit secara tidak sengaja, membawa token ke dalam riwayat dan log CI. Sebagian besar klien mendukung substitusi ${env:VAR} dalam nilai header — simpan kunci API di variabel env atau keychain OS Anda dan rujuk dari konfigurasi. Sebagai jaring pengaman, tambahkan jalur konfigurasi klien umum ke .gitignore proyek Anda:

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

Jika kredensial disusupi

Jika Anda terhubung dengan kunci API:

1. Di Konsol Wavix, nonaktifkan atau hapus kunci tersebut segera (atau panggil api_keys_delete).
2. Buat pengganti melalui api_keys_create atau Konsol.
3. Perbarui konfigurasi klien dan sambungkan kembali.

Jika Anda terhubung dengan masuk ke akun Wavix:

1. Cabut koneksi dari halaman manajemen hibah portal Wavix, yang mencantumkan koneksi yang Anda otorisasi dan mencabut yang Anda pilih — ini membatalkan token koneksi tersebut. Tidak ada kunci API yang terlibat.
2. Sambungkan kembali dan masuk lagi.

Dalam kedua kasus, tinjau billing_transactions_list dan cdrs_list untuk aktivitas yang tidak terduga.

Pemecahan Masalah

Gejala	Kemungkinan penyebab / perbaikan
401 Unauthorized dari alat apa pun	Autentikasi gagal. Dengan kunci API: header Authorization: Bearer … hilang, atau kunci tidak valid atau tidak aktif — verifikasi di Konsol Wavix. Dengan masuk akun: sesi/token Anda kedaluwarsa atau dicabut, atau masuk tidak pernah selesai — sambungkan kembali dan masuk lagi.
Alat mengembalikan download_url, bukan file itu sendiri	Diharapkan. Titik akhir rekaman, analitik ucapan, dan bukti 10DLC mengembalikan URL pra-tanda tangan (lihat Autentikasi). Ambil URL langsung tanpa header Authorization.
Klien hanya menampilkan sebagian katalog	Klien lama memberlakukan batas alat per server. Tingkatkan (Cursor 2.4+, VS Code terbaru, Claude terbaru).
Lebih sedikit alat tersedia setelah masuk dengan akun Wavix	Diharapkan. Masuk akun difilter cakupan — Anda mendapatkan alat yang diizinkan oleh cakupan yang disetujui dan peran akun Anda, bukan katalog lengkap. Koneksi kunci API melihat permukaan alat penuh. Untuk memperluas set, setujui lebih banyak cakupan saat masuk (tergantung peran Anda) atau sambungkan dengan kunci API yang membawanya.
Tool not found untuk alat yang tercantum di README ini	Klien lokal mungkin menyimpan daftar alat lama. Mulai ulang klien, atau hapus dan tambahkan kembali server.
4xx dengan array errors	Kesalahan validasi dari API Wavix. Periksa errors; rujuk silang halaman wavix://docs/* yang relevan atau spesifikasi OpenAPI.
Tidak dapat menjangkau server	Konfirmasi DNS dan HTTPS keluar ke mcp.wavix.com:443.
Agen memanggil alat destruktif secara tidak terduga	Sebagian besar klien dapat meminta konfirmasi sebelum panggilan alat — aktifkan pengaturan itu dan rotasi ke kunci API MCP khusus (lihat Praktik terbaik).

Kompatibilitas & batasan

• Kompatibel dengan klien MCP apa pun yang mendukung transport Streamable HTTP (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, SDK MCP kustom) dan kerangka kerja agen apa pun dengan adaptor klien MCP.
• Setiap alat yang dianotasi dengan destructiveHint, plus call_webhooks_create, sip_trunks_update dan sub_accounts_update, berjalan dalam dua langkah: panggilan pertama mengembalikan pratinjau dan confirmation_token sekali pakai (berlaku 5 menit), dan tindakan berjalan hanya ketika alat dipanggil lagi dengan argumen yang sama dan token tersebut. Klien MCP apa pun dapat melakukan ini; tidak diperlukan dukungan konfirmasi sisi klien.
• Klien lama mungkin memberlakukan batas alat per server; tingkatkan ke versi terbaru untuk mengakses katalog lengkap.
• Batas kecepatan dan biaya penggunaan mengikuti paket akun Wavix Anda. Lihat Harga Wavix.

Riwayat perubahan

Server yang di-host diperbarui terus-menerus seiring evolusi spesifikasi OpenAPI Wavix; alat baru muncul otomatis dan argumen alat yang ada dapat memperoleh bidang opsional. Perubahan dokumentasi untuk repositori ini dilacak di bawah Rilis. Untuk perubahan perilaku substansial yang memengaruhi input alat atau autentikasi, kami akan menerbitkan pemberitahuan baik di sana maupun di catatan rilis Wavix.

Dukungan

• Dokumentasi produk: https://docs.wavix.com
• Referensi API: https://docs.wavix.com/api-reference
• Pertanyaan / umpan balik: support@wavix.com

Kontribusi

Repositori ini tersedia sumbernya tetapi tidak terbuka untuk kontribusi eksternal. Pull request ditutup otomatis, dan Issues / Discussions dinonaktifkan. Kirim laporan bug, permintaan fitur, dan umpan balik ke support@wavix.com. Lihat CONTRIBUTING.md untuk detail.

Jika Anda menemukan bug di kerangka kerja FastMCP yang mendasarinya, harap laporkan ke hulu di sana.

Keamanan

Untuk melaporkan kerentanan keamanan, silakan email support@wavix.com dengan subjek Security: <short summary> alih-alih membuka masalah publik. Lihat SECURITY.md untuk detail.

Lisensi

MIT © Wavix