Open in

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

Claude، ChatGPT، Claude Code، Codex، Cursor، VS Code، یا کسی دوسرے Streamable HTTP MCP کلائنٹ سے ThunderPhone وائس ایجنٹس بنائیں، ٹیسٹ کریں، توثیق کریں، اور چلائیں۔

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

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

یہ ریموٹ MCP سرور کو وائس ایجنٹ سے منسلک کرنے کی مخالف سمت ہے:

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

توثیق کریں

ڈائریکٹری کلائنٹس کے لیے بطور ڈیفالٹ OAuth استعمال کریں: سائن ان کریں، ایک تنظیم منتخب کریں، اور مطلوبہ اجازتوں کی منظوری دیں۔ رسائی کو تنظیم → API کلیدیں → مجاز ایپس کے تحت منسوخ کریں۔

API کلید کے ساتھ ترتیب دیے گئے کلائنٹس کے لیے، تنظیم → کلیدیں کے تحت ایک sk_live_ کلید بنائیں اور اسے اپنے MCP کلائنٹ کے لیے THUNDERPHONE_API_KEY کے طور پر فراہم کریں۔ یہ کلید ایک تنظیم سے منسلک ہوتی ہے؛ کسی دوسری تنظیم کی ملکیت والا شناخت کار موجود نہ ہونے کی طرح برتاؤ کرتا ہے۔

CLI اور stdio کے متبادل

ThunderPhone CLI غیر متعلقہ سرورز کو برقرار رکھتے ہوئے کلائنٹ کی ترتیب لکھ سکتا ہے:

npx -y @thunderphone/mcp setup --client cursor --api-key-env THUNDERPHONE_API_KEY
npx thunderphone mcp setup --client claude-desktop --scope user

@thunderphone/mcp کی عالمی تنصیب کے بعد، انہی اختیارات کے ساتھ thunderphone-mcp setup استعمال کریں۔ سیٹ اپ Claude Code، Codex، Cursor، VS Code، Gemini، Claude Desktop اور Windsurf کو سپورٹ کرتا ہے۔ براہ راست HTTP کو ترجیح دی جاتی ہے؛ Desktop stdio استعمال کرتا ہے۔

کسی بھی stdio کی صلاحیت رکھنے والے کلائنٹ کے لیے، command: "npx" کو args: ["-y", "@thunderphone/mcp"] کے ساتھ ترتیب دیں۔ ریپر پہلے THUNDERPHONE_API_KEY استعمال کرتا ہے، پھر thunderphone login کی اسناد استعمال کرتا ہے، میعاد ختم شدہ ٹوکنز کو تازہ کرتا ہے، اور پھر mcp-remote کے ذریعے OAuth استعمال کرتا ہے۔ ڈیوائس لاگ ان اور OAuth کے لیے متعلقہ API OAuth رول آؤٹ درکار ہے۔ API کلید کے راستے کے لیے نہیں۔ براہ راست HTTP ترتیبات CLI اسناد کے ذخیرے کو نہیں پڑھتیں؛ ڈیوائس لاگ ان دوبارہ استعمال کرنے کے لیے stdio ریپر استعمال کریں۔

یہ ذیل میں دی گئی دستی کلائنٹ ترتیبات کے متبادل ہیں۔

کلائنٹ کنفیگریشن

Claude اور ChatGPT OAuth کے ساتھ سائن ان کرتے ہیں؛ اس میں کوئی API کلید شامل نہیں ہوتی۔ اگر آپ کے پاس ابھی ThunderPhone اکاؤنٹ نہیں ہے، تو سائن ان صفحے پر اکاؤنٹ بنائیں منتخب کریں، اور اپنی ای میل کی تصدیق کے بعد آپ منظوری کی اسکرین پر واپس آ جائیں گے۔

Claude (ویب، ڈیسک ٹاپ، اور موبائل)

حسب ضرورت بنائیں → کنیکٹرز کھولیں (پرانے ورژنز میں ترتیبات → کنیکٹرز)۔ اگر ThunderPhone کنیکٹر ڈائریکٹری میں نظر آئے تو اسے منتخب کریں۔ بصورت دیگر حسب ضرورت کنیکٹر شامل کریں منتخب کریں، اس کا نام ThunderPhone رکھیں، اور https://api.thunderphone.com/v1/mcp درج کریں۔
رابطہ کریں منتخب کریں، ThunderPhone میں سائن ان کریں، تنظیم منتخب کریں، اور اجازتوں کی منظوری دیں۔
چیٹ میں، ٹولز مینو سے ThunderPhone فعال کریں اور اپنی ضرورت کے مطابق سوال کریں، مثلاً "میرے ایجنٹس کی فہرست بنائیں"۔

Claude ہر ٹول کو پہلی بار استعمال کرنے سے پہلے پوچھتا ہے۔ ان میں سے زیادہ تر پرامپٹس چھوڑنے کے لیے، حسب ضرورت بنائیں → کنیکٹرز → ThunderPhone کھولیں اور صرف پڑھنے کے ٹولز کو ہمیشہ اجازت دینے پر سیٹ کریں۔ یہ ٹولز صرف معلومات تلاش کرتے ہیں: ایجنٹس، کالز، ٹرانسکرپٹس، بیلنس، دستاویزات۔ اگر آپ ہر تبدیلی ہونے سے پہلے دیکھنا چاہتے ہیں تو لکھنے اور حذف کرنے والے ٹولز کو منظوری پر رہنے دیں۔

حسب ضرورت کنیکٹرز کے لیے Claude کا بامعاوضہ پلان درکار ہے۔ Team اور Enterprise پلانز میں، تنظیم کا مالک پہلے تنظیم کی کنیکٹر ترتیبات کے تحت کنیکٹر شامل کرتا ہے، پھر ہر رکن اپنا ThunderPhone اکاؤنٹ منسلک کرتا ہے۔

ChatGPT

اگر ThunderPhone ChatGPT ایپ ڈائریکٹری میں نظر آئے، تو اسے منتخب کریں اور منسلک کریں۔
بصورت دیگر ترتیبات → ایپس اور کنیکٹرز → جدید ترتیبات کھولیں، ڈیولپر موڈ آن کریں، اور URL https://api.thunderphone.com/v1/mcp اور OAuth توثیق کے ساتھ ایک کنیکٹر بنائیں۔
ThunderPhone میں سائن ان کریں، تنظیم منتخب کریں، اور اجازتوں کی منظوری دیں۔ ٹولز مینو سے ThunderPhone کو چیٹ میں شامل کریں۔

ایجنٹ یا فون نمبر حذف کرنے، ڈرافٹ مسترد کرنے، مہم شروع کرنے، اور بیرونی سسٹم میں لکھ سکنے والی ٹیسٹ درخواست بھیجنے کے لیے دونوں میں سے کسی بھی ایپ میں دوسری تصدیق درکار ہوتی ہے؛ تباہ کن اقدامات کی تصدیق دیکھیں۔

Claude Code

claude mcp add --transport http thunderphone https://api.thunderphone.com/v1/mcp \
  --header "Authorization: Bearer $THUNDERPHONE_API_KEY"

Codex

اسے ~/.codex/config.toml میں شامل کریں:

[mcp_servers.thunderphone]
url = "https://api.thunderphone.com/v1/mcp"
bearer_token_env_var = "THUNDERPHONE_API_KEY"

Cursor

.cursor/mcp.json بنائیں:

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

Claude Desktop

Claude Desktop کنفیگریشن میں mcp-remote برج شامل کریں:

{
  "mcpServers": {
    "thunderphone": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.thunderphone.com/v1/mcp",
        "--header",
        "Authorization: Bearer ${THUNDERPHONE_API_KEY}"
      ],
      "env": {
        "THUNDERPHONE_API_KEY": "sk_live_YOUR_API_KEY"
      }
    }
  }
}

VS Code

.vscode/mcp.json بنائیں اور VS Code کے ان پٹ پرامپٹ کے ذریعے کلید درج کریں:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "thunderphone-api-key",
      "description": "ThunderPhone organization API key",
      "password": true
    }
  ],
  "servers": {
    "thunderphone": {
      "type": "http",
      "url": "https://api.thunderphone.com/v1/mcp",
      "headers": {
        "Authorization": "Bearer ${input:thunderphone-api-key}"
      }
    }
  }
}

ٹولز

ہر ٹول MCP تشریحات رکھتا ہے۔ جدولوں میں، R کا مطلب صرف پڑھنے کے لیے، D کا مطلب تخریبی، I کا مطلب یکساں نتیجہ دینے والا، اور O کا مطلب اوپن ورلڈ یا نیٹ ورک تعامل ہے۔ ڈیش کا مطلب ہے کہ کوئی اشارہ مقرر نہیں ہے۔

کنکشن

ٹول	بنیادی آرگیومنٹس	تشریحات	یہ کیا کرتا ہے
`get_connection_identity`	—	R, I	اسناد کی توثیق کرتا ہے اور اس کی تنظیم اور محفوظ اسناد کا میٹا ڈیٹا واپس کرتا ہے۔

ایجنٹس

ٹول	اہم آرگیومنٹس	اینوٹیشنز	یہ کیا کرتا ہے
`list_agents`	—	R, I	ایجنٹس کی فہرست دیتا ہے۔
`get_agent`	`agent_id`	R, I	ایک ایجنٹ حاصل کرتا ہے۔
`create_agent`	ایجنٹ کی کنفیگریشن	—	ایک ایجنٹ بناتا ہے۔
`update_agent`	`agent_id`، تبدیل شدہ فیلڈز	D	ایجنٹ ڈرافٹ میں فیلڈز اس طرح مرحلہ وار شامل کرتا ہے کہ ڈرافٹ میں موجود اقدار تبدیل ہو جائیں۔ تصدیقی مرحلے کے بغیر چلتا ہے: جب تک `deploy_agent` نہ چلایا جائے، ڈیپلائے شدہ ایجنٹ میں کوئی تبدیلی نہیں ہوتی، اور `discard_agent_draft` ڈرافٹ کو واپس کر دیتا ہے۔
`deploy_agent`	`agent_id`، اختیاری `if_updated_at`	D, I	ڈرافٹ کو پروڈکشن میں منتقل کرتا ہے۔
`discard_agent_draft`	`agent_id`، اختیاری `if_updated_at`، دوسری درخواست پر `confirmation_token`	D, I	مرحلہ وار شامل کی گئی تبدیلیاں مسترد کرتا ہے۔ دو مرحلوں پر مشتمل ہے، تباہ کن کارروائیوں کی تصدیق دیکھیں۔
`duplicate_agent`	`agent_id`، اختیاری `name`	—	تنظیم کے اندر ایک ایجنٹ کی نقل بناتا ہے۔
`delete_agent`	`agent_id`، دوسری درخواست پر `confirmation_token`	D, I	ایک ایجنٹ کو مستقل طور پر حذف کرتا ہے۔ دو مرحلوں پر مشتمل ہے۔
`list_agent_versions`	`agent_id`	R, I	ڈیپلائے شدہ کنفیگریشن ورژنز کی فہرست دیتا ہے۔

فون نمبرز اور کیریئرز

ٹول	بنیادی آرگیومنٹس	تشریحات	یہ کیا کرتا ہے
`list_phone_numbers`	—	R, I	تنظیم کے نمبرز اور روٹنگ کی فہرست دیتا ہے۔
`get_phone_number_limits`	—	R, I	منظم نمبرز کے استعمال اور حدود حاصل کرتا ہے۔
`provision_phone_number`	اختیاری `area_code`، `city`، `state`، `idempotency_key`	D, O	ThunderPhone کے زیرِ انتظام آنے والا نمبر خریدتا ہے۔
`list_voip_connections`	—	R, I	منسلک کسٹمر کیریئرز کی فہرست دیتا ہے۔
`search_voip_numbers`	`connection_id`، `country`، `type`، اختیاری `area_code`	R, I, O	کیریئر کی انوینٹری میں تلاش کرتا ہے۔
`import_voip_numbers`	`connection_id`، `numbers`	D, O	کیریئر پر پہلے سے موجود نمبرز درآمد کرتا ہے۔
`update_phone_number`	`phone_number_id`، روٹنگ/لیبل/webhook فیلڈز	D	نمبر کی روٹنگ اپ ڈیٹ کرتا ہے، بشمول ایجنٹ کی تفویض۔
`delete_phone_number`	`phone_number_id`، `confirm`، اختیاری `release_at_provider`، دوسری درخواست پر `confirmation_token`	D, I, O	نمبر جاری کرتا ہے۔ دو مرحلے۔

SMS

ٹول	مرکزی آرگیومنٹس	تشریحات	یہ کیا کرتا ہے
`send_sms`	`from_number`, `to`, `body`, `idempotency_key`	D, I, O	منسلک Twilio یا Telnyx نمبر کے ذریعے ایک سادہ متنی SMS بھیجتا ہے۔

کالز

ٹول	بنیادی آرگیومنٹس	تشریحات	یہ کیا کرتا ہے
`list_calls`	اختیاری فلٹرز، `limit`، `offset`	R, I	REST کال ہسٹری کے فلٹرز کے ساتھ کالز کی فہرست دیتا ہے۔
`get_call`	`call_id`	R, I	کال کی حیثیت اور میٹا ڈیٹا حاصل کرتا ہے۔
`get_call_transcript`	`call_id`، اختیاری `live`	R, I	کال کا ٹرانسکرپٹ حاصل کرتا ہے۔
`get_call_audio_url`	`call_id`، اختیاری `download`	R, I, O	دستخط شدہ آڈیو URL واپس کرتا ہے؛ یہ کبھی بھی MCP کے ذریعے آڈیو اسٹریم نہیں کرتا۔
`get_call_grade`	`call_id`	R, I	کال کی تازہ ترین گریڈ حاصل کرتا ہے۔
`place_call`	`agent_id`، `from_number`، `to_number`	D, O	ایک غیر آئیڈیمپوٹنٹ آؤٹ باؤنڈ کال کرتا ہے۔
`export_calls`	کال فلٹرز، `export_format`	R, I	REST اینڈپوائنٹ کی حد تک JSON یا CSV میں ایکسپورٹ کرتا ہے۔

ٹیسٹنگ اور توثیق

ٹول	بنیادی آرگیومنٹس	تشریحات	یہ کیا کرتا ہے
`list_test_scenarios`	`agent_id`	R, I	ٹیسٹ منظرناموں کی فہرست دیتا ہے۔
`create_test_scenario`	`agent_id`, `title`, `scenario_prompt`، اختیاری شرائط	—	ایک منظرنامہ بناتا ہے۔
`generate_test_scenarios`	`agent_id`، اختیاری `count`، `include_edge_cases`، `locale`	O	ایجنٹ کے prompt سے منظرنامے تیار کرتا ہے۔
`run_agent_tests`	`agent_id`، `channel`، `consent_to_charge`، اختیاری انتخاب/میٹرکس	D, O	ویب یا ٹیلی فونی کے ذریعے منظرنامے چلاتا ہے۔
`get_test_run`	`agent_id`, `batch_id`	R, I	بیچ کی حیثیت اور ہر منظرنامے کے نتائج حاصل کرتا ہے۔
`list_validation_runs`	`agent_id`	R, I	حالیہ ڈرافٹ ویلیڈیشن رنز کی فہرست دیتا ہے۔
`get_validation_status`	`agent_id`	R, I	تازہ ترین ویلیڈیشن حالت اور ڈرافٹ میچ حاصل کرتا ہے۔

نالج

ٹول	بنیادی آرگیومنٹس	تشریحات	یہ کیا کرتا ہے
`list_knowledge_bases`	—	R, I	نالج بیسز کی فہرست دیتا ہے۔
`create_knowledge_base`	`name`, اختیاری `description`	—	ایک نالج بیس بناتا ہے۔
`add_knowledge_document`	`knowledge_base_id`, `name`, `content`	—	متن یا Markdown شامل کرتا ہے۔
`import_knowledge_url`	`url`, اختیاری `name`	O	محفوظ ادخال کے لیے ایک عوامی صفحہ قطار میں شامل کرتا ہے۔
`search_knowledge`	`knowledge_base_id`, `query`	R, I	پروڈکشن ریٹریول میں تلاش کرتا ہے۔

انٹیگریشنز، webhooks، اور ریموٹ MCP سرورز

ٹول	بنیادی آرگیومنٹس	تشریحات	کیا کرتا ہے
`list_integrations`	—	R, I	HTTP فنکشن انٹیگریشنز کی فہرست دیتا ہے۔
`create_integration`	`display_name`، فنکشن `spec`، اختیاری اینڈپوائنٹ فیلڈز	—	ایک HTTP ٹول بناتا ہے۔ ڈیش بورڈ میں توثیقی ہیڈرز شامل کریں۔
`test_integration`	`url`، اختیاری میتھڈ/باڈی/ٹائم آؤٹ، `header_names` کے ساتھ `integration_id`، دوسری درخواست پر `confirmation_token`	D, O	ایک محدود، SSRF سے محفوظ ٹیسٹ درخواست بھیجتا ہے۔ محفوظ کردہ ہیڈر ویلیوز انٹیگریشن سے بھری جاتی ہیں اور صرف اس کے اپنے ہوسٹ کو بھیجی جاتی ہیں۔ `POST` (ڈیفالٹ)، `PUT`، `PATCH` اور `DELETE` دو مرحلوں والے ہیں؛ `GET` فوراً چلتا ہے۔
`list_webhook_endpoints`	—	R, I	دستخط شدہ ویب ہک اینڈپوائنٹس کی فہرست دیتا ہے۔
`list_webhook_deliveries`	اختیاری `agent_id`، اختیاری `endpoint_id`	R, I	حالیہ پے لوڈ کے بغیر ویب ہک ڈیلیوری نتائج کی فہرست دیتا ہے۔
`create_webhook_endpoint`	`label`، `url`، اختیاری ایونٹس/اسٹیٹس	O	ایک دستخط شدہ ویب ہک اینڈپوائنٹ بناتا ہے۔
`test_webhook_endpoint`	`endpoint_id`	O	عام ڈیلیوری کے ذریعے ایک مصنوعی ایونٹ بھیجتا ہے۔
`list_mcp_servers`	—	R, I	ان ریموٹ سرورز کی فہرست دیتا ہے جنہیں وائس ایجنٹس کال کر سکتے ہیں۔
`create_mcp_server`	`display_name`، `url`	O	ایک ریموٹ سرور رجسٹر اور ہم آہنگ کرتا ہے۔ جن سرورز کو توثیقی ہیڈرز درکار ہوں، انہیں ڈیش بورڈ میں شامل کیا جاتا ہے۔
`sync_mcp_server_tools`	`server_id`	D, O	ریموٹ سرور کے ٹول کیٹلاگ کو تازہ کرتا ہے۔

مہمات

ٹول	بنیادی آرگیومنٹس	تشریحات	یہ کیا کرتا ہے
`list_campaigns`	—	R, I	آؤٹ باؤنڈ مہمات کی فہرست دیتا ہے۔
`create_campaign`	مہم فیلڈز	—	ایک ڈرافٹ مہم بناتا ہے۔
`add_campaign_contacts`	`campaign_id`, `contacts`	—	5,000 تک JSON رابطے شامل کرتا ہے۔
`campaign_action`	`campaign_id`, `action`, اختیاری `consent_to_charge`, دوسری درخواست پر `confirmation_token`	D, O	`start`, `pause`, `resume`، یا `stop` چلاتا ہے۔ `start` اور `resume` دو مرحلوں پر مشتمل ہیں؛ `pause` اور `stop` فوری طور پر چلتے ہیں۔
`get_campaign_stats`	`campaign_id`	R, I	کاؤنٹرز اور حالیہ نتائج حاصل کرتا ہے۔

آوازیں، بلنگ، اور دستاویزات

ٹول	بنیادی آرگیومنٹس	تشریحات	یہ کیا کرتا ہے
`list_voices`	—	R, I	آوازوں اور معاون زبانوں کی فہرست دیتا ہے۔
`preview_voice`	`voice`, `language`, `text`	O	ایک نمونہ تیار کرتا ہے اور دستخط شدہ URL واپس کرتا ہے۔
`list_voice_clones`	—	R, I	حسبِ ضرورت وائس کلونز کی فہرست دیتا ہے۔
`get_billing_summary`	—	R, I	بیلنس اور مستند ٹئیر قیمتیں حاصل کرتا ہے؛ ادائیگی میں کوئی تبدیلی دستیاب نہیں ہے۔
`search_docs`	`query`، اختیاری `limit`	R, I, O	عوامی دستاویزات کے انڈیکس میں تلاش کرتا ہے۔
`get_doc_page`	`path`	R, I, O	ایک عوامی Markdown دستاویزات کا صفحہ حاصل کرتا ہے۔

تمام پروڈکٹ ٹولز عوامی API جیسے ہی REST کوڈ پاتھز استعمال کرتے ہیں۔ لہٰذا REST توثیق، تنظیمی اسکوپنگ، کردار، بلنگ داخلہ، کوٹے، TCPA تصدیق، فراہم کنندہ کی حفاظت، اور آڈٹ رویہ بغیر تبدیلی کے لاگو ہوتے ہیں۔

ناقابلِ واپسی اقدامات کی تصدیق

D سے نشان زد ٹولز کسی چیز کو تبدیل یا حذف کرتے ہیں، یا حقیقی افراد کو کال ملانا شروع کرتے ہیں۔ جن اقدامات کو واپس نہیں لیا جا سکتا، ان کے لیے دو درخواستیں درکار ہوتی ہیں۔ پہلی درخواست میں کچھ تبدیل نہیں ہوتا اور یہ واپس آتا ہے:

{
  "status": "confirmation_required",
  "action": "Delete agent",
  "target": { "id": 195, "name": "Front Desk Receptionist" },
  "confirmation_token": "…",
  "expires_in_seconds": 600,
  "next_step": "…"
}

اسسٹنٹ صارف کو دکھاتا ہے کہ کیا متاثر ہوگا اور ہاں میں جواب مانگتا ہے۔ پھر وہی دلائل اور confirmation_token شامل کر کے درخواست دہرائی جاتی ہے۔ ٹوکن 10 منٹ تک درست رہتا ہے اور ایک تنظیم، ایک ٹول، اور دلائل کے ایک عین مجموعے کے لیے کارآمد ہوتا ہے، اس لیے 3 ایجنٹس حذف کرنے کے لیے 3 تصدیقات درکار ہوتی ہیں۔ pause یا stop کے ساتھ campaign_action یہ مرحلہ چھوڑ دیتا ہے تاکہ جاری مہم کو ہمیشہ فوراً روکا جا سکے، اور GET کے ساتھ test_integration بھی ایسا ہی کرتا ہے۔ کچھ D ٹولز ایک ہی درخواست میں چلتے ہیں کیونکہ D ان کے اثر کو ظاہر کرتا ہے، سرور سائیڈ تصدیق کو نہیں: update_agent ڈرافٹ میں موجود مواد کو بدل دیتا ہے (discard_agent_draft اسے واپس کر دیتا ہے)، deploy_agent لائیو کنفیگریشن کو بدل دیتا ہے، update_phone_number لائیو کالز کو دوبارہ روٹ کرتا ہے، sync_mcp_server_tools ریموٹ سرور کی ٹول فہرست کو بدل دیتا ہے، import_voip_numbers نمبروں کو آپ کے کیریئر کی طرف دوبارہ پوائنٹ کرتا ہے، run_agent_tests کریڈٹ خرچ کر سکتا ہے، send_sms اور place_call کسی حقیقی شخص تک پہنچتے ہیں (place_call اپنی رضامندی کی تصدیق برقرار رکھتا ہے)، اور provision_phone_number ایک نمبر خریدتا ہے۔ آپ کا MCP کلائنٹ پھر بھی آپ سے ان کی منظوری مانگ سکتا ہے۔

ابتدائی prompts

prompts/list پانچ دوبارہ استعمال کیے جانے والے ورک فلو فراہم کرتا ہے:

create_inbound_receptionist
run_agent_tests
buy_and_attach_number
review_low_grade_calls
add_url_to_agent_knowledge

فوری استعمال کے لیے تیار صارف پیغام حاصل کرنے کے لیے فہرست میں موجود prompt نام اور اس کے بیان کردہ دلائل کے ساتھ prompts/get استعمال کریں۔

وسائل

resources/list عوامی، کیش شدہ حوالہ جات فراہم کرتا ہے:

URI	مواد
`thunderphone://docs/llms.txt`	عوامی دستاویزات کا اشاریہ۔
`thunderphone://docs/quickstart`	فوری آغاز Markdown۔
`thunderphone://pricing`	موجودہ عوامی قیمتوں کا Markdown۔

ایک حوالہ resources/read کے ذریعے پڑھیں۔ عوامی fetches ایک مختصر ٹائم آؤٹ، 2 MiB کی حد، اور عمل کے اندر 10 منٹ کی کیش استعمال کرتے ہیں۔

پروٹوکول اور خرابیاں

سرور پروٹوکول ورژنز 2025-06-18 اور 2025-03-26 کو سپورٹ کرتا ہے؛ یہ معاونت یافتہ کلائنٹ ورژن واپس بھیجتا ہے اور بصورتِ دیگر 2025-06-18 منتخب کرتا ہے۔ یہ initialize، ping، ٹولز، prompts، وسائل، اور اطلاعات نافذ کرتا ہے۔ اطلاعات 202 Accepted واپس کرتی ہیں۔ یہ اسٹیٹ لیس سرور SSE listener یا سیشن حذف کرنے کی سہولت نہیں دیتا، اس لیے GET اور DELETE، Allow: POST کے ساتھ 405 Method Not Allowed واپس کرتے ہیں۔

ٹول کی ناکامیاں isError: true کے ساتھ کامیاب JSON-RPC جوابات ہی رہتی ہیں۔ ان کے متن میں ایک مختصر جملے کے بعد JSON بلاک شامل ہوتا ہے:

{
  "code": "insufficient_balance",
  "detail": "There is not enough prepaid balance.",
  "next_step": "Call get_billing_summary, add funds in Organization > Billing, then retry."
}

place_call کے لیے منفرد outbound_tcpa_confirmation_required: سابقہ برقرار رکھا جاتا ہے۔ نامعلوم JSON-RPC طریقے HTTP 200 جواب میں -32601 واپس کرتے ہیں۔ JSON-RPC بیچز کو MCP 2025-06-18 سپورٹ نہیں کرتا اور وہ صاف -32600 غلط درخواست کی خرابی واپس کرتے ہیں۔