ThunderPhone-কে MCP সার্ভার হিসেবে ব্যবহার করুন

ThunderPhone এখানে একটি Model Context Protocol সার্ভার উন্মুক্ত করে:

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

আপনার প্রতিষ্ঠানের এজেন্ট ও কলগুলোকে টুল হিসেবে উপলভ্য করতে একটি MCP ক্লায়েন্টকে সেই Streamable HTTP এন্ডপয়েন্টে নির্দেশ করুন। এটি একটি ভয়েস এজেন্টের সঙ্গে রিমোট MCP সার্ভার সংযুক্ত করা-র বিপরীত দিক:

দিক	ফলাফল
রিমোট MCP সার্ভার → ThunderPhone এজেন্ট	আপনার ভয়েস এজেন্ট রিমোট সার্ভারের টুল কল করতে পারে।
ThunderPhone → আপনার MCP ক্লায়েন্ট	আপনার MCP ক্লায়েন্ট এজেন্ট ও কলের জন্য ThunderPhone টুল কল করতে পারে।

প্রমাণীকরণ

প্রতিষ্ঠান → কীসমূহ-এর অধীনে একটি sk_live_ কী তৈরি করুন এবং এটি Bearer টোকেন হিসেবে পাঠান। MCP এন্ডপয়েন্ট প্রতিষ্ঠান API কী গ্রহণ করে, ড্যাশবোর্ড সেশন কুকি বা প্রকাশযোগ্য উইজেট কী নয়।

{
  "mcpServers": {
    "thunderphone": {
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_YOUR_API_KEY"
      }
    }
  }
}

উপলভ্য টুল

টুল	আর্গুমেন্ট	কাজ
`list_agents`	নেই	আইডি, নাম, পণ্য ও ভয়েসসহ প্রতিষ্ঠানের এজেন্টগুলোর তালিকা দেয়।
`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 কী-এর সঙ্গে যুক্ত প্রতিষ্ঠানের মধ্যে সীমাবদ্ধ। অন্য প্রতিষ্ঠানের একটি আইডি অনুপলভ্য হিসেবে আচরণ করে।

প্রোটোকল মেথড

এন্ডপয়েন্টটি 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 দেখুন।