ThunderPhone کو MCP سرور کے طور پر استعمال کریں

ThunderPhone ایک Model Context Protocol سرور یہاں فراہم کرتا ہے:

https://api.thunderphone.com/v1/mcp

اپنی تنظیم کے ایجنٹس اور کالز کو ٹولز کے طور پر دستیاب بنانے کے لیے کسی MCP کلائنٹ کو اس Streamable HTTP اینڈپوائنٹ کی طرف اشارہ کریں۔ یہ ریموٹ MCP سرور کو وائس ایجنٹ سے منسلک کرنے کی مخالف سمت ہے:

سمت	نتیجہ
ریموٹ MCP سرور → ThunderPhone ایجنٹ	آپ کا وائس ایجنٹ ریموٹ سرور کے ٹولز کو کال کر سکتا ہے۔
ThunderPhone → آپ کا MCP کلائنٹ	آپ کا MCP کلائنٹ ایجنٹس اور کالز کے لیے ThunderPhone ٹولز کو کال کر سکتا ہے۔

توثیق کریں

Organization → Keys کے تحت ایک sk_live_ کلید بنائیں اور اسے Bearer ٹوکن کے طور پر بھیجیں۔ MCP اینڈپوائنٹ تنظیم کی API کلیدیں قبول کرتا ہے، ڈیش بورڈ سیشن کوکیز یا قابلِ اشاعت ویجیٹ کلیدیں نہیں۔

{
  "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 کلید سے منسلک تنظیم تک محدود ہوتے ہیں۔ کسی دوسری تنظیم کی id دستیاب نہ ہونے کی طرح عمل کرتی ہے۔

پروٹوکول طریقے

اینڈپوائنٹ Streamable HTTP کلائنٹس کے لیے درکار MCP JSON-RPC طریقے نافذ کرتا ہے:

initialize
notifications/initialized
tools/list
tools/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 تک رسائی رکھنے والے کلائنٹ کو پروڈکشن کالر سمجھیں۔ طے کریں کہ کلائنٹ کو کون استعمال کر سکتا ہے، اس کے اپنے prompt میں مطلوبہ ایجنٹ اور نمبر واضح رکھیں، اور کال ہسٹری میں کالز کا جائزہ لیں۔

مکمل وائر حوالہ

رسپانس کی مثالوں، JSON-RPC خرابیوں اور ریموٹ سرور مینجمنٹ API کے لیے MCP Servers API دیکھیں۔