Platfone - Receive SMS & Virtual Numbers MCP

Platfone MCP Sunucusu

Platfone, hesap doğrulama, test ve otomasyon iş akışları için sanal telefon numaraları sağlar. Platfone MCP sunucusu, yapay zeka ajanlarının Claude, VS Code Copilot, Codex gibi MCP uyumlu istemcilerden geçici numaralar edinmesini ve SMS mesajları almasını sağlar.

📖 Dokümanlar · 🔧 Kurulum Kılavuzu · 🔑 API Anahtarı Al · 📦 npm

Neden MCP?

API'yi manuel olarak entegre etmek yerine, yapay zeka ajanları şunları yapabilir:

• Ülke ve hizmet adına göre otonom olarak numara siparişi verme
• SMS kodlarını bekleme
• Aktivasyonları yeniden deneme veya iptal etme

Tümü yapılandırılmış araç çağrıları aracılığıyla — özel bir arka uç gerektirmez.

Özellikler

• Tam aktivasyon yaşam döngüsü — numara siparişinden SMS almaya kadar
• ETag önbellekli katalog — ülkeler ve hizmetler, 5 dakikalık TTL ve ETag tabanlı koşullu yenileme ile bellekte önbelleğe alınır — ajana asla gönderilmez
• İnsan dostu girdiler — ID'ler yerine "Israel" veya "Telegram" kullanın; adlar sunucu tarafında otomatik olarak çözümlenir
• Çift taşıma — tek bir kod tabanından stdio ve http
• API anahtarı kimlik doğrulaması — mevcut Platfone API anahtarınızla çalışır

Kurulum

Ayrıntılı talimatlar için tam Kurulum Kılavuzuna bakın.

Hızlı Başlangıç

NPM:

PLATFONE_API_KEY=your_key npx @platfone/mcp

Ajan Yönergeleri

• Maliyet ve kullanılabilirliği doğrulamak için her zaman önce check_price çağrısı yapın
• Ardından bir numara kiralamak için order_number çağrısı yapın
• SMS alınana veya süresi dolana kadar check_sms çağrısı yapın
• SMS gelmezse retry_activation kullanın
• Artık gerekmiyorsa fonları serbest bırakmak için cancel_activation kullanın

Araçlar

Araç	Açıklama
get_balance	Hesap bakiyesini kontrol edin: toplam, ayrılmış ve kullanılabilir fonlar.
check_price	Sipariş vermeden önce bir ülke + hizmet çifti için fiyatlandırma ve kullanılabilirliği kontrol edin.
order_number	Sanal bir telefon numarası sipariş edin. Adları ("Israel") veya ID'leri ("il") kabul eder. activation_id + phone döndürür.
check_sms	Aktivasyon durumunu sorgulayın. SMS kodu alındığında veya yoklama talimatlarıyla mevcut durumu döndürür.
retry_activation	Aynı numarada başka bir SMS isteyin. Ücretsizdir.
cancel_activation	SMS alınmadan önce aktif bir aktivasyonu iptal edin. Ayrılmış tutarı iade eder.

Not: Ülke ve hizmet katalogları sunucu tarafında önbelleğe alınır ve insan tarafından okunabilir adlardan otomatik olarak çözümlenir. Ajan asla tam kataloğu almaz — yalnızca çözümlenmiş ID'ler veya belirsizlik giderme ipuçları.

Tipik Yapay Zeka Ajanı Akışı

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

İsteğe bağlı adımlar:

• retry_activation — aynı numarada başka bir SMS isteyin (ücretsiz)
• cancel_activation — SMS gelmeden önce iptal edin (bakiyeyi iade eder)

Geliştirme

Kurulum talimatları ve test ipuçları için tam Geliştirme Kılavuzunu okuyun.

Sorun Giderme

Hata	Çözüm
UnauthorizedException	PLATFONE_API_KEY değerinizin geçerli olup olmadığını kontrol edin
PaymentRequiredException	Platfone bakiyenizi yükseltin
NoNumbersAvailableException	Farklı bir ülke veya hizmet deneyin
TooManyRequestsException	Hız sınırlaması — bekleyin ve yeniden deneyin
MaxPriceExceededException	Önerilen max_price ve döndürülen order_id ile order_number işlemini yeniden deneyin
TooManyActivationsException	Maksimum eşzamanlı aktif aktivasyon sayısına ulaşıldı — iptal edin veya sürenin dolmasını bekleyin

Lisans

LICENSE.md dosyasına bakın. MIT Lisansı altında lisanslanmıştır.

Platfone API'sinin kullanımı Hizmet Şartları ve Gizlilik Politikasına tabidir.