ThunderPhone को MCP सर्वर के रूप में इस्तेमाल करें
एजेंट की सूची देखने, कॉल और ट्रांसक्रिप्ट जांचने, और संगठन API key के साथ आउटबाउंड कॉल करने के लिए किसी भी Streamable HTTP MCP क्लाइंट को ThunderPhone से कनेक्ट करें।
ThunderPhone इस पते पर एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल सर्वर एक्सपोज़ करता है:
https://api.thunderphone.com/v1/mcpअपने संगठन के एजेंट और कॉल को टूल के रूप में उपलब्ध कराने के लिए किसी MCP क्लाइंट को उस Streamable HTTP एंडपॉइंट पर पॉइंट करें। यह किसी रिमोट MCP सर्वर को वॉइस एजेंट से कनेक्ट करने की विपरीत दिशा है:
| दिशा | परिणाम |
|---|---|
| रिमोट MCP सर्वर → ThunderPhone एजेंट | आपका वॉइस एजेंट रिमोट सर्वर के टूल कॉल कर सकता है। |
| ThunderPhone → आपका MCP क्लाइंट | आपका MCP क्लाइंट एजेंट और कॉल के लिए ThunderPhone टूल कॉल कर सकता है। |
ऑथेंटिकेट करें
संगठन → कीज़ के अंतर्गत sk_live_ की बनाएँ और इसे बेयरर टोकन के रूप में भेजें। MCP एंडपॉइंट संगठन API key स्वीकार करता है, डैशबोर्ड सेशन कुकी या पब्लिशेबल विजेट कीज़ नहीं।
{
"mcpServers": {
"thunderphone": {
"url": "https://api.thunderphone.com/v1/mcp",
"headers": {
"Authorization": "Bearer sk_live_YOUR_API_KEY"
}
}
}
}उपलब्ध टूल
| टूल | आर्ग्युमेंट | यह क्या करता है |
|---|---|---|
list_agents | कोई नहीं | ID, नाम, प्रोडक्ट और वॉइस के साथ संगठन एजेंट की सूची देता है। |
get_agent | agent_id | एक एजेंट प्राप्त करता है। |
place_call | agent_id, from_number, to_number | REST कॉल एंडपॉइंट के समान वैलिडेशन और बिलिंग गेट के साथ आउटबाउंड कॉल करता है। |
get_call | call_id | कॉल स्टेटस, समरी और ग्रेड प्राप्त करता है। |
list_calls | वैकल्पिक limit (1–100), वैकल्पिक status | हाल की कॉल की सूची देता है। |
get_call_transcript | call_id | किसी कॉल का पूरा ट्रांसक्रिप्ट प्राप्त करता है। |
सभी टूल API key से संबद्ध संगठन तक सीमित हैं। किसी अन्य संगठन की ID अनुपलब्ध मानी जाती है।
प्रोटोकॉल मेथड
एंडपॉइंट Streamable HTTP क्लाइंट के लिए आवश्यक MCP JSON-RPC मेथड इंप्लीमेंट करता है:
initializenotifications/initializedtools/listtools/call
आप टूल कैटलॉग को सीधे इंस्पेक्ट कर सकते हैं:
curl -X POST https://api.thunderphone.com/v1/mcp \
-H "Authorization: Bearer sk_live_YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list",
"params": {}
}'किसी टूल को उसके नाम और आर्ग्युमेंट के साथ कॉल करें:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "list_calls",
"arguments": { "limit": 20, "status": "completed" }
}
}टूल परिणाम MCP टेक्स्ट-कॉन्टेंट आइटम होते हैं। टूल विफलताएँ isError: true के साथ परिणाम में लौटाई जाती हैं; अज्ञात JSON-RPC मेथड प्रोटोकॉल एरर लौटाते हैं।
कॉल सुरक्षित रूप से करना
place_call वही नियम अपनाता है जो
POST /v1/call अपनाता है: एजेंट और नंबर की के संगठन से संबंधित होने चाहिए, नंबर आउटबाउंड कॉलिंग के लिए योग्य होना चाहिए, संगठन के पास पर्याप्त बैलेंस होना चाहिए और लागू होने पर आउटबाउंड-कॉलिंग कन्फर्मेशन पूरा होना चाहिए।
place_call एक्सेस वाले क्लाइंट को प्रोडक्शन कॉलर की तरह मानें। क्लाइंट का उपयोग कौन कर सकता है इसे सीमित करें, उसके अपने प्रॉम्प्ट में इच्छित एजेंट और नंबर स्पष्ट करें, और कॉल हिस्ट्री में कॉल की समीक्षा करें।
पूर्ण वायर रेफ़रेंस
रिस्पॉन्स उदाहरण, JSON-RPC एरर और रिमोट-सर्वर मैनेजमेंट API के लिए MCP सर्वर्स API देखें।