Platfone - Receive SMS & Virtual Numbers MCP

Platfone MCP Server

Platfone menyediakan nomor telepon virtual untuk verifikasi akun, pengujian, dan alur kerja otomatisasi. Server MCP Platfone memungkinkan agen AI memperoleh nomor sementara dan menerima pesan SMS dari klien yang kompatibel dengan MCP seperti Claude, VS Code Copilot, Codex, dll.

📖 Dokumentasi · 🔧 Panduan Pengaturan · 🔑 Dapatkan Kunci API · 📦 npm

Mengapa MCP?

Alih-alih mengintegrasikan API secara manual, agen AI dapat:

• Memesan nomor secara mandiri berdasarkan negara dan nama layanan
• Menunggu kode SMS
• Mencoba ulang atau membatalkan aktivasi

Semua melalui panggilan alat terstruktur — tidak perlu backend kustom.

Fitur

• Siklus hidup aktivasi penuh — dari pemesanan nomor hingga menerima SMS
• Katalog cache ETag — negara dan layanan di-cache dalam memori dengan TTL 5 menit dan penyegaran bersyarat berbasis ETag — tidak pernah dikirim ke agen
• Input ramah pengguna — gunakan "Israel" atau "Telegram" alih-alih ID; nama diselesaikan secara otomatis di sisi server
• Transport ganda — stdio dan http dari basis kode tunggal
• Otentikasi kunci API — berfungsi dengan kunci API Platfone Anda yang sudah ada

Instalasi

Lihat Panduan Instalasi lengkap untuk instruksi detail.

Mulai Cepat

NPM:

PLATFONE_API_KEY=your_key npx @platfone/mcp

Panduan Agen

• Selalu panggil check_price terlebih dahulu untuk memverifikasi biaya dan ketersediaan
• Kemudian panggil order_number untuk menyewa nomor
• Panggil check_sms hingga SMS diterima atau kedaluwarsa
• Gunakan retry_activation jika tidak ada SMS yang tiba
• Gunakan cancel_activation untuk melepaskan dana jika tidak lagi diperlukan

Alat

Alat	Deskripsi
get_balance	Periksa saldo akun: total, dana yang dicadangkan, dan dana yang tersedia.
check_price	Periksa harga dan ketersediaan untuk pasangan negara + layanan sebelum memesan.
order_number	Pesan nomor telepon virtual. Menerima nama ("Israel") atau ID ("il"). Mengembalikan activation_id + phone.
check_sms	Polling status aktivasi. Mengembalikan kode SMS saat diterima, atau status saat ini dengan instruksi polling.
retry_activation	Minta SMS lain pada nomor yang sama. Gratis.
cancel_activation	Batalkan aktivasi aktif sebelum SMS diterima. Mengembalikan jumlah yang dicadangkan.

Catatan: Katalog negara dan layanan di-cache di sisi server dan diselesaikan secara otomatis dari nama yang dapat dibaca manusia. Agen tidak pernah menerima katalog lengkap — hanya ID yang diselesaikan atau petunjuk disambiguasi.

Alur Agen AI Umum

1. check_price         (country: "Israel", service: "Telegram")  → verify cost & availability
2. order_number        (country: "Israel", service: "Telegram")  → returns activation_id + phone
3. check_sms           (activation_id)                            → poll or check once for SMS

Langkah opsional:

• retry_activation — minta SMS lain pada nomor yang sama (gratis)
• cancel_activation — batalkan sebelum SMS tiba (mengembalikan saldo)

Pengembangan

Baca Panduan Pengembangan lengkap untuk instruksi pengaturan dan tips pengujian.

Pemecahan Masalah

Kesalahan	Solusi
UnauthorizedException	Periksa apakah PLATFONE_API_KEY Anda valid
PaymentRequiredException	Isi ulang saldo Platfone Anda
NoNumbersAvailableException	Coba negara atau layanan yang berbeda
TooManyRequestsException	Terkena batas laju — tunggu dan coba lagi
MaxPriceExceededException	Coba lagi order_number dengan max_price yang disarankan dan order_id yang dikembalikan
TooManyActivationsException	Maksimum aktivasi aktif bersamaan tercapai — batalkan atau tunggu kedaluwarsa

Lisensi

Lihat LICENSE.md. Dilisensikan di bawah Lisensi MIT.

Penggunaan API Platfone tunduk pada Ketentuan Layanan dan Kebijakan Privasi.