> ## Documentation Index
> Fetch the complete documentation index at: https://docs.thunderphone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# ThunderPhone को MCP सर्वर के रूप में इस्तेमाल करें

> एजेंट की सूची देखने, कॉल और ट्रांसक्रिप्ट जांचने, और संगठन API key के साथ आउटबाउंड कॉल करने के लिए किसी भी Streamable HTTP MCP क्लाइंट को ThunderPhone से कनेक्ट करें।

ThunderPhone इस पते पर एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल सर्वर एक्सपोज़ करता है:

```text theme={null}
https://api.thunderphone.com/v1/mcp
```

अपने संगठन के एजेंट और कॉल को टूल के रूप में उपलब्ध कराने के लिए किसी MCP क्लाइंट को उस Streamable HTTP एंडपॉइंट पर पॉइंट करें। यह [किसी रिमोट MCP सर्वर को वॉइस एजेंट से कनेक्ट करने](/hi/guides/mcp-servers) की विपरीत दिशा है:

| दिशा                                 | परिणाम                                                                |
| ------------------------------------ | --------------------------------------------------------------------- |
| रिमोट MCP सर्वर → ThunderPhone एजेंट | आपका वॉइस एजेंट रिमोट सर्वर के टूल कॉल कर सकता है।                    |
| ThunderPhone → आपका MCP क्लाइंट      | आपका MCP क्लाइंट एजेंट और कॉल के लिए ThunderPhone टूल कॉल कर सकता है। |

## ऑथेंटिकेट करें

**संगठन → कीज़** के अंतर्गत `sk_live_` की बनाएँ और इसे बेयरर टोकन के रूप में भेजें। MCP एंडपॉइंट संगठन API key स्वीकार करता है, डैशबोर्ड सेशन कुकी या पब्लिशेबल विजेट कीज़ नहीं।

```json Generic client configuration theme={null}
{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}
```

<Warning>
  `sk_live_` की संगठन डेटा एक्सेस कर सकती है और कॉल कर सकती है। इसे ब्राउज़र कोड, रिपॉज़िटरी, स्क्रीनशॉट और चैट लॉग से दूर रखें। अपने MCP क्लाइंट द्वारा समर्थित सीक्रेट स्टोर का उपयोग करें और किसी की के एक्सपोज़ होने पर उसे तुरंत रिवोक करें।
</Warning>

## उपलब्ध टूल

| टूल                   | आर्ग्युमेंट                                 | यह क्या करता है                                                               |
| --------------------- | ------------------------------------------- | ----------------------------------------------------------------------------- |
| `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 मेथड इंप्लीमेंट करता है:

* `initialize`
* `notifications/initialized`
* `tools/list`
* `tools/call`

आप टूल कैटलॉग को सीधे इंस्पेक्ट कर सकते हैं:

```bash theme={null}
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": {}
  }'
```

किसी टूल को उसके नाम और आर्ग्युमेंट के साथ कॉल करें:

```json theme={null}
{
  "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`](/api-reference/outbound-calls) अपनाता है: एजेंट और नंबर की के संगठन से संबंधित होने चाहिए, नंबर आउटबाउंड कॉलिंग के लिए योग्य होना चाहिए, संगठन के पास पर्याप्त बैलेंस होना चाहिए और लागू होने पर आउटबाउंड-कॉलिंग कन्फर्मेशन पूरा होना चाहिए।

`place_call` एक्सेस वाले क्लाइंट को प्रोडक्शन कॉलर की तरह मानें। क्लाइंट का उपयोग कौन कर सकता है इसे सीमित करें, उसके अपने प्रॉम्प्ट में इच्छित एजेंट और नंबर स्पष्ट करें, और कॉल हिस्ट्री में कॉल की समीक्षा करें।

## पूर्ण वायर रेफ़रेंस

रिस्पॉन्स उदाहरण, JSON-RPC एरर और रिमोट-सर्वर मैनेजमेंट API के लिए [MCP सर्वर्स API](/api-reference/mcp-servers#thunderphone-as-an-mcp-server) देखें।