Wavix

resmi

Wavix adalah platform komunikasi global yang menyediakan API untuk suara, SMS, 2FA, dan nomor telepon. Server MCP kami menghadirkan kemampuan ini ke agen AI dan alur kerja agen.

GitHub

Coba MCP iniDisponsori

Apa yang bisa Anda lakukan dengan Wavix MCP?

Kirim SMS/MMS transaksional — Minta pengiriman pesan melalui sms_and_mms_messages_send, yang mengembalikan ID pesan dan status pengiriman.
Jalankan alur verifikasi 2FA — Buat kode dengan two_fa_verification_create, lalu validasi melalui two_fa_verification_check.
Cari dan beli nomor telepon — Temukan nomor yang tersedia dengan buy_numbers_list, tambahkan ke keranjang via cart_add, dan selesaikan pembelian dengan cart_checkout.
Cari transkrip panggilan — Gunakan cdrs_search untuk menemukan panggilan berdasarkan kata kunci transkripsi, lalu perkaya hasil dengan cdrs_get.
Ambil dan transkripsikan rekaman — Dapatkan rekaman melalui call_recording_get, minta transkripsi dengan cdrs_retranscribe, dan ambil hasilnya via cdrs_transcription_get.
Audit penagihan dan faktur — Tinjau pengeluaran dengan billing_transactions_list dan unduh PDF faktur melalui billing_invoices_download.

Dokumentasi

Server MCP Wavix

Sebuah server Model Context Protocol yang memberi LLM dan agen AI akses langsung ke platform telekomunikasi Wavix — SMS/MMS, panggilan suara, 2FA, trunking SIP, 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 autentikasi dengan kunci API Wavix Anda. Jika Anda perlu self-host (deployment Wavix khusus, di belakang firewall, instance khusus), lihat Jalankan sendiri.

Daftar isi

Endpoint
Instal — satu-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

Bidang	Nilai
URL	`https://mcp.wavix.com/mcp`
Transportasi	Streamable HTTP
Autentikasi	`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.

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

Instal satu-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 khusus:

Nama: Wavix
URL: https://mcp.wavix.com/mcp
Transportasi: 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 pengguna settings.json):

{
  "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 transportasi Streamable HTTP dengan header khusus 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 yang 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 lingkungan	Default	Tujuan
`WAVIX_API_BASE_URL`	`https://api.wavix.com`	Menimpa endpoint API Wavix upstream (untuk deployment internal atau staging)

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

Contoh

Prompt konkret yang dapat Anda masukkan 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 untuk 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 merantai buy_numbers_list (menyaring berdasarkan negara dan fitur), cart_add, dan cart_checkout. Konfirmasi dengan pengguna sebelum checkout — ini akan membebani akun.

Cari transkrip panggilan

Prompt: "Tampilkan semua panggilan masuk dari kemarin yang berdurasi lebih 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.

Ambil rekaman dan transkripsikan

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

Agen memanggil call_recording_get (mengembalikan URL unduhan pra-tanda tangan), cdrs_retranscribe, lalu memeriksa cdrs_transcription_get.

Audit penagihan

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

Agen memanggil billing_transactions_list yang disaring berdasarkan jenis dan tanggal, lalu billing_invoices_list + billing_invoices_download. Alat unduhan mengembalikan URL pra-tanda tangan 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 badan.

Grup	#	Cakupan
SMS dan MMS	10	Kirim, daftar, ambil pesan; ID pengirim; keluar
Kontrol panggilan	9	Mulai / jawab / akhiri panggilan; putar audio; kumpulkan DTMF
Rekaman panggilan	4	Daftar, unduh (URL pra-tanda tangan), hapus
Streaming panggilan	2	Mulai / hentikan aliran media
Webhook panggilan	3	Daftar, buat, hapus
CDR	7	Daftar, ekspor, ambil; pencarian transkripsi dan transkripsi ulang
Analitik ucapan	4	Unggah, transkripsikan, ambil file asli
2FA	6	Buat / periksa / batalkan / kirim ulang verifikasi; peristiwa
Nomor saya	6	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
Trunk SIP	5	CRUD lengkap
10DLC	30	Merek, kampanye, vetting, bukti, langganan peristiwa
Profil	3	Dapatkan / perbarui profil; konfigurasi akun
Kunci API	4	Daftar, buat, aktifkan / nonaktifkan, hapus
Sub-akun	5	Daftar, buat, dapatkan, perbarui; transaksi
Penagihan	3	Transaksi, faktur, unduh laporan
Kampanye suara	2	Picu dan ambil
Wavix Embeddable (WebRTC)	5	CRUD token widget
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	Konten
`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 publik dan dapat dijelajahi langsung tanpa autentikasi.

Sumber daya diambil secara malas 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

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 pra-tanda tangan),
tidak pernah dikirim ke host dokumentasi.

Jika klien Anda mengikuti URL unduhan pra-tanda tangan 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: rotasi sesuai jadwal dan pada setiap kecurigaan kebocoran.
Jauhkan kunci API dari git. Konfigurasi klien MCP mudah ter-commit secara tidak sengaja, membawa token ke riwayat dan log CI. Sebagian besar klien mendukung substitusi ${env:VAR} di nilai header — simpan kunci API di variabel lingkungan 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

Di Konsol Wavix, nonaktifkan kunci tersebut segera (atau panggil api_keys_deactivate).
Buat penggantinya melalui api_keys_create atau Konsol.
Perbarui konfigurasi klien dan sambungkan kembali.
Tinjau billing_transactions_list dan cdrs_list untuk aktivitas yang tidak terduga.

Pemecahan Masalah

Gejala	Kemungkinan penyebab / perbaikan
`401 Unauthorized` dari alat mana pun	Header `Authorization: Bearer …` hilang atau tidak valid. Pastikan kunci API aktif di Konsol Wavix.
Alat mengembalikan `download_url`, bukan file itu sendiri	Wajar. Endpoint rekaman, faktur, analitik ucapan, dan bukti 10DLC mengembalikan URL pra-tanda tangan (lihat Autentikasi). Ambil URL tersebut langsung tanpa header `Authorization`.
Klien hanya menampilkan ~40 alat, bukan katalog lengkap	Klien lama menerapkan batas alat per-server. Tingkatkan (Cursor 2.4+, VS Code terbaru, Claude terbaru).
`Tool not found` untuk alat yang tercantum dalam README ini	Klien lokal mungkin menyimpan cache daftar alat lama. Mulai ulang klien, atau hapus dan tambahkan kembali server.
4xx dengan array `errors`	Kesalahan validasi dari API Wavix. Periksa `errors`; bandingkan dengan halaman `wavix://docs/*` yang relevan atau spesifikasi OpenAPI.
Tidak dapat menjangkau server	Pastikan DNS dan HTTPS keluar ke `mcp.wavix.com:443`.
Agen memanggil alat destruktif secara tidak terduga	Sebagian besar klien dapat meminta konfirmasi sebelum pemanggilan alat — aktifkan pengaturan tersebut dan gunakan 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, MCP SDK kustom) dan kerangka kerja agen apa pun dengan adaptor klien MCP.
Klien lama mungkin menerapkan 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.

Log perubahan

Server yang dihosting diperbarui secara berkelanjutan seiring berkembangnya spesifikasi OpenAPI Wavix; alat baru muncul secara otomatis dan argumen alat yang ada dapat memperoleh kolom opsional. Perubahan dokumentasi untuk repositori ini dilacak di bawah Rilis. Untuk perubahan perilaku besar 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 / masukan: support@wavix.com

Kontribusi

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

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

Keamanan

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