Wavix

Wavix MCP Server

Sebuah server Model Context Protocol yang memberikan LLM dan agen AI akses langsung 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 pada akun Anda.

Cara tercepat untuk menggunakan server MCP ini adalah endpoint terhosting di https://mcp.wavix.com/mcp — arahkan klien yang kompatibel dengan MCP ke sana dan autentikasi dengan kunci API Wavix Anda. Jika Anda perlu self-host (penerapan Wavix kustom, di balik firewall, instans khusus), lihat Jalankan sendiri.

Daftar isi

• Endpoint
• Instal — sekali klik, Claude Code, Claude Desktop / Web, Cursor, VS Code, Codex CLI, Windsurf
• Jalankan sendiri (self-host)
• Contoh
• Alat → katalog lengkap di TOOLS.md
• Sumber daya
• Autentikasi (praktik terbaik, jika token disusupi)
• Pemecahan masalah
• Kompatibilitas & batasan
• Dukungan, Berkontribusi, Keamanan, Lisensi

Endpoint

Kolom	Nilai
URL	https://mcp.wavix.com/mcp
Transport	HTTP Streamable
Auth	Authorization: Bearer <api_key>
Alat	lihat TOOLS.md
Sumber daya	Dokumen Wavix + spesifikasi OpenAPI (ditemukan otomatis)

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

Instal

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 sudah ada). Simpan baik-baik — Anda akan menempelkannya di tempat YOUR_API_KEY di bawah.

Instal 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 → Tambah konektor kustom:

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

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 hingga 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 terhosting 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 HTTP Streamable 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 instal yang dapat dibaca mesin yang memberikan model URL, header, dan konfigurasi per-klien dalam format deterministik sehingga tidak mengimprovisasi nilai endpoint.

Jalankan sendiri

Server terhosting berfungsi langsung untuk sebagian besar pengguna. Self-host jika Anda perlu mengarahkan ke penerapan Wavix non-publik, berjalan di balik 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 pada 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

Var env	Default	Tujuan
WAVIX_API_BASE_URL	https://api.wavix.com	Timpa endpoint API Wavix upstream (untuk penerapan internal atau staging)

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

Contoh

Prompt konkret yang dapat Anda masukkan ke klien 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 untuk disalin kata demi kata, tidak ada pelanggan nyata yang dapat dihubungi melaluinya.

Kirim SMS transaksional

Prompt: "Kirim SMS dari +13105550100 ke +447700900123 yang bertuliskan '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. Ketika saya memberikan kode yang saya terima, periksa apakah itu 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.

Cari dan beli nomor telepon

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

Agen merangkai buy_numbers_list (memfilter berdasarkan negara dan fitur), cart_add, dan cart_checkout. Konfirmasikan dengan pengguna sebelum checkout — ini membebani akun.

Cari transkrip panggilan

Prompt: "Tampilkan semua panggilan masuk dari kemarin yang lebih lama dari dua menit di mana penelepon menyebutkan 'pengembalian dana'."

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

Tarik rekaman dan transkripsikan

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

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

Audit penagihan

Prompt: "Berapa banyak yang kami habiskan untuk SMS bulan lalu? Beri saya tautan unduhan untuk faktur PDF terbaru."

Agen memanggil billing_transactions_list yang difilter berdasarkan jenis dan tanggal, lalu billing_invoices_list + billing_invoices_download. Alat unduhan mengembalikan URL yang telah ditandatangani sebelumnya ke PDF, bukan file itu sendiri — buka URL di browser atau berikan ke klien Anda untuk mengambil dokumen sebenarnya.

Alat

122 alat, dihasilkan dari spesifikasi OpenAPI Wavix. Argumen mencerminkan parameter permintaan dan bidang isi.

Grup	#	Cakupan
SMS dan MMS	10	Kirim, daftar, ambil pesan; ID pengirim; opt-out
Kontrol panggilan	9	Mulai / jawab / akhiri panggilan; putar audio; kumpulkan DTMF
Rekaman panggilan	3	Daftar, unduh (URL yang telah ditandatangani sebelumnya), hapus
Streaming panggilan	2	Mulai / hentikan streaming media
Webhook panggilan	3	Daftar, buat, hapus
CDR	6	Daftar, ekspor, ambil; pencarian transkripsi dan transkripsi ulang
Analitik Ucapan	4	Unggah, transkripsikan, ambil file asli
2FA	6	Buat / periksa / batalkan / kirim ulang verifikasi; acara
Nomor saya	7	Daftar, perbarui, lepaskan; perutean SMS / suara; unggah dokumen
Beli	5	Negara, wilayah, kota; pencarian nomor yang tersedia
Keranjang	4	Tambah, hapus, ambil, checkout
Validator nomor	3	Validasi tunggal dan massal
SIP trunk	5	CRUD penuh
10DLC	30	Merek, kampanye, pemeriksaan, bukti, langganan acara
Profil	3	Dapatkan / perbarui profil; konfigurasi akun
Kunci API	5	Daftar, buat, aktifkan / nonaktifkan, hapus
Sub-akun	5	Daftar, buat, dapatkan, perbarui; transaksi
Penagihan	3	Transaksi, faktur, unduh pernyataan
Kampanye suara	2	Picu dan ambil
Wavix Embeddable (WebRTC)	5	Token widget CRUD
Pemendek tautan	2	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 saat ini.

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 OpenAPI 3.0 Wavix lengkap.

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

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

Autentikasi

Setiap permintaan dari klien 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 (misalnya URL unduhan S3 yang telah ditandatangani sebelumnya),
• tidak pernah dikirim ke host dokumentasi.

Jika klien Anda mengikuti URL unduhan yang telah ditandatangani sebelumnya yang dikembalikan oleh call_recording_get, billing_invoices_download, 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 jika ada kecurigaan kebocoran.

• Jauhkan kunci API dari git. Konfigurasi klien MCP mudah dilakukan 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 var 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 token disusupi

1. Di Konsol Wavix, nonaktifkan kunci segera (atau hubungi api_keys_deactivate).
2. Buat pengganti melalui api_keys_create atau Konsol.
3. Perbarui konfigurasi klien dan sambungkan kembali.
4. Tinjau billing_transactions_list dan cdrs_list untuk aktivitas tak terduga.

Pemecahan Masalah

Gejala	Kemungkinan penyebab / perbaikan
401 Unauthorized dari alat apa pun	Header Authorization: Bearer … hilang atau tidak valid. Verifikasi kunci API aktif di Konsol Wavix.
Alat mengembalikan download_url, bukan berkas itu sendiri	Diharapkan. Endpoint rekaman, faktur, analitik ucapan, dan bukti 10DLC mengembalikan URL pra-tanda tangan (lihat Autentikasi). Ambil URL langsung tanpa header Authorization.
Klien hanya menampilkan ~40 alat, bukan katalog lengkap	Klien lama memberlakukan batas alat per server. Tingkatkan (Cursor 2.4+, VS Code terbaru, Claude terbaru).
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 mencapai server	Konfirmasi DNS dan HTTPS keluar ke mcp.wavix.com:443.
Agen memanggil alat destruktif secara tak terduga	Sebagian besar klien dapat memerlukan 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 HTTP Streamable (Claude Desktop / Web / Code, Cursor 2.4+, VS Code, Windsurf, SDK MCP kustom) dan kerangka agen apa pun dengan adaptor klien MCP.
• Klien lama mungkin memberlakukan batas alat per server; tingkatkan ke versi terbaru untuk mengakses katalog lengkap.
• Batas laju dan biaya penggunaan mengikuti paket akun Wavix Anda. Lihat Harga Wavix.

Changelog

Server yang dihosting diperbarui terus-menerus seiring berkembangnya spesifikasi OpenAPI Wavix; alat baru muncul secara otomatis dan argumen alat yang ada mungkin mendapatkan 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 di sana dan di Catatan rilis Wavix.

Dukungan

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

Berkontribusi

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 detailnya.

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

Keamanan

Untuk melaporkan kerentanan keamanan, silakan email support@wavix.com dengan subjek Security: <short summary> daripada membuka isu publik. Lihat SECURITY.md untuk detailnya.

Lisensi

MIT © Wavix