Platfone - Receive SMS & Virtual Numbers MCP

Platfone MCP सर्वर

Platfone खाता सत्यापन, परीक्षण और स्वचालन वर्कफ़्लो के लिए वर्चुअल फ़ोन नंबर प्रदान करता है। Platfone MCP सर्वर AI एजेंटों को अस्थायी नंबर प्राप्त करने और Claude, VS Code Copilot, Codex आदि जैसे MCP-संगत क्लाइंट से SMS संदेश प्राप्त करने में सक्षम बनाता है।

📖 दस्तावेज़ · 🔧 सेटअप गाइड · 🔑 API कुंजी प्राप्त करें · 📦 npm

MCP क्यों?

API को मैन्युअल रूप से एकीकृत करने के बजाय, AI एजेंट यह कर सकते हैं:

• देश और सेवा नाम के आधार पर स्वायत्त रूप से नंबर ऑर्डर करना
• SMS कोड की प्रतीक्षा करना
• सक्रियणों को पुनः प्रयास या रद्द करना

सब कुछ संरचित टूल कॉल के माध्यम से — किसी कस्टम बैकएंड की आवश्यकता नहीं।

विशेषताएँ

• पूर्ण सक्रियण जीवनचक्र — नंबर ऑर्डर करने से लेकर SMS प्राप्त करने तक
• ETag-कैश्ड कैटलॉग — देश और सेवाएँ 5-मिनट की TTL और ETag-आधारित सशर्त रिफ्रेश के साथ इन-मेमोरी कैश्ड हैं — एजेंट को कभी नहीं भेजी जातीं
• मानव-अनुकूल इनपुट — ID के बजाय "Israel" या "Telegram" का उपयोग करें; नाम सर्वर-साइड स्वतः हल हो जाते हैं
• दोहरा ट्रांसपोर्ट — एकल कोडबेस से stdio और http
• API कुंजी प्रमाणीकरण — आपकी मौजूदा Platfone API कुंजी के साथ काम करता है

स्थापना

विस्तृत निर्देशों के लिए पूर्ण स्थापना गाइड देखें।

त्वरित शुरुआत

NPM:

PLATFONE_API_KEY=your_key npx @platfone/mcp

एजेंट दिशानिर्देश

• लागत और उपलब्धता सत्यापित करने के लिए हमेशा पहले check_price कॉल करें
• फिर नंबर किराए पर लेने के लिए order_number कॉल करें
• SMS प्राप्त या समाप्त होने तक check_sms कॉल करें
• यदि कोई SMS न आए तो retry_activation का उपयोग करें
• यदि अब आवश्यकता न हो तो धनराशि जारी करने के लिए cancel_activation का उपयोग करें

उपकरण

उपकरण	विवरण
get_balance	खाता शेष जाँचें: कुल, आरक्षित और उपलब्ध धनराशि।
check_price	ऑर्डर करने से पहले किसी देश + सेवा जोड़ी के लिए मूल्य निर्धारण और उपलब्धता जाँचें।
order_number	एक वर्चुअल फ़ोन नंबर ऑर्डर करें। नाम ("Israel") या ID ("il") स्वीकार करता है। activation_id + phone लौटाता है।
check_sms	सक्रियण स्थिति पोल करें। SMS कोड प्राप्त होने पर, या पोलिंग निर्देशों के साथ वर्तमान स्थिति लौटाता है।
retry_activation	उसी नंबर पर दूसरे SMS का अनुरोध करें। निःशुल्क।
cancel_activation	SMS प्राप्त होने से पहले एक सक्रिय सक्रियण रद्द करें। आरक्षित राशि वापस करता है।

नोट: देश और सेवा कैटलॉग सर्वर-साइड कैश्ड हैं और मानव-पठनीय नामों से स्वतः हल हो जाते हैं। एजेंट को कभी भी पूर्ण कैटलॉग प्राप्त नहीं होता — केवल हल की गई ID या असंदिग्धता संकेत।

विशिष्ट AI एजेंट प्रवाह

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

वैकल्पिक चरण:

• retry_activation — उसी नंबर पर दूसरे SMS का अनुरोध करें (मुफ़्त)
• cancel_activation — SMS आने से पहले रद्द करें (शेष राशि वापस)

विकास

सेटअप निर्देशों और परीक्षण युक्तियों के लिए पूर्ण विकास गाइड पढ़ें।

समस्या निवारण

त्रुटि	समाधान
UnauthorizedException	जाँचें कि आपकी PLATFONE_API_KEY मान्य है
PaymentRequiredException	अपनी Platfone शेष राशि टॉप-अप करें
NoNumbersAvailableException	कोई भिन्न देश या सेवा आज़माएँ
TooManyRequestsException	दर सीमित — प्रतीक्षा करें और पुनः प्रयास करें
MaxPriceExceededException	सुझाए गए max_price और लौटाए गए order_id के साथ order_number पुनः प्रयास करें
TooManyActivationsException	अधिकतम समवर्ती सक्रिय सक्रियण सीमा तक पहुँच गए — रद्द करें या समाप्ति की प्रतीक्षा करें

लाइसेंस

LICENSE.md देखें। MIT लाइसेंस के तहत लाइसेंस प्राप्त।

Platfone API का उपयोग सेवा की शर्तें और गोपनीयता नीति के अधीन है।