# AI ایجنٹس کو MCP کے ذریعے BroadNet سے جوڑیں۔

- کینونیکل URL: https://www.broadnet.me/ur/developers/mcp
- زبان: ur
- آخری اپ ڈیٹ: 2026-10-21
- ناشر: BroadNet (https://www.broadnet.me)
- اوپر والے صفحے کا Markdown ورژن، جو رینڈر شدہ صفحے سے تیار کیا گیا ہے۔

Model Context Protocol· /developers/mcp

BroadNet MCP سرور BroadNet میسجنگ API کو ایسے ٹولز کے طور پر فراہم کرتا ہے جنہیں AI ایجنٹ کال کر سکتا ہے۔ کسی بھی MCP کلائنٹ کو جو ریموٹ سرورز کو سپورٹ کرتا ہے ایک اینڈ پوائنٹ پر پوائنٹ کریں، اپنے BroadNet ٹوکن کے ساتھ تصدیق کریں، اور ایجنٹ آپ کے اکاؤنٹ پر میسجز بھیج اور ٹریک کر سکتا ہے۔

**اینڈ پوائنٹ**

https://mcp.broadnet.me/mcp

**ٹرانسپورٹ**

MCP اسٹریمیبل HTTP

**تصدیق (Authentication)**

Authorization: Bearer <token>

**چینلز**

WhatsApp، SMS، RCS، Telegram، Push، Email، Messenger، Instagram

## MCP سرور کیا ہے

ماڈل کانٹیکسٹ پروٹوکول (MCP) ایک اوپن اسٹینڈرڈ ہے جو AI اسسٹنٹس کو بیرونی ٹولز تلاش کرنے اور کال کرنے کی اجازت دیتا ہے۔ BroadNet MCP سرور ایک ریموٹ MCP سرور ہے: آپ کا کلائنٹ HTTPS پر اس سے منسلک ہوتا ہے، اس کے پیش کردہ ٹولز کی فہرست دیکھتا ہے، اور آپ کی طرف سے انہیں کال کرتا ہے۔

یہ ٹولز اسی BroadNet API کے مطابق ہیں جو API ریفرنس اور OpenAPI اسپیک میں درج ہیں — پیغامات بھیجنا، WhatsApp ٹیمپلیٹس کے ساتھ کام کرنا، اور ڈیلیوری رپورٹس پڑھنا۔ ایجنٹ آپ کے دیے گئے ٹوکن کی اجازت کے ساتھ کام کرتا ہے، بالکل ویسے ہی جیسے آپ کا اپنا کوڈ کام کرے گا۔

## دو MCP سرورز: نالج اور میسجنگ

BroadNet دو MCP سرورز چلاتا ہے۔ اس صفحے پر بیان کردہ میسجنگ سرور آپ کے اکاؤنٹ پر عمل درآمد کرتا ہے۔ نالج سرور عوامی ہے: ایک ایجنٹ لاگ ان کے بغیر BroadNet کی کوریج، سینڈر ID کے قواعد، شائع شدہ لسٹ قیمتیں، ریگولیشنز اور کمپنی کے حقائق کے بارے میں اس سے پوچھ سکتا ہے۔

نالج سرور (پبلک)

اسی ویب سائٹ کے ڈیٹا سے حاصل کردہ صرف پڑھنے کے قابل (Read-only) جوابات۔ کوئی اکاؤنٹ نہیں، کوئی ٹوکن نہیں، کوئی ذاتی ڈیٹا نہیں۔

**Endpoint**

https://www.broadnet.me/mcp

**تصدیق (Authentication)**

کوئی نہیں

**رسائی**

صرف پڑھنے کے لیے

**ٹولز**

search_site, get_facts, check_coverage, sender_id_rules, estimate_price, count_sms_segments, get_regulation, list_answers, get_answer, list_case_studies, get_case_study, get_changelog, get_status

**ریٹ لمیٹ**

فی آئی پی (IP) فی منٹ 60 درخواستیں

میسجنگ سرور (آپ کا اکاؤنٹ)

آپ کے BroadNet ٹوکن کی اجازت کے ساتھ میسجز بھیجتا اور ٹریک کرتا ہے۔

**Endpoint**

https://mcp.broadnet.me/mcp

**تصدیق (Authentication)**

Authorization: Bearer <token>

**رسائی**

آپ کے اکاؤنٹ پر عمل کرتا ہے

ٹرمینل سے نالج سرور آزمائیں: پہلے ہینڈ شیک کو انیشلائز کریں، پھر ٹول کال کریں۔

initialize (نالج سرور)

```
curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1.0"}}}'
```

tools/call (نالج سرور)

```
curl -X POST https://www.broadnet.me/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"sender_id_rules","arguments":{"country":"ae"}}}'
```

نالج سرور MCP 2026-07-28 (فی درخواست میٹا ڈیٹا، server/discover) اور 2024-11-05 تک کے پرانے انیشلائز پر مبنی ریویژنز کو سپورٹ کرتا ہے۔ اس کے ذریعے بتائی گئی قیمتیں صرف اشارہ کرنے والی لسٹ ریٹس ہیں، کوٹیشنز نہیں؛ ریگولیشن سے متعلق جوابات منصوبہ بندی کے لیے رہنمائی ہیں، قانونی مشورہ نہیں ہیں۔

## اینڈ پوائنٹ اور تصدیق

ہر اکاؤنٹ کے لیے ایک اینڈ پوائنٹ ہے: https://mcp.broadnet.me/mcp۔ ہر ریکوئسٹ کے Authorization ہیڈر میں آپ کا BroadNet ٹوکن ہونا ضروری ہے۔

آپ کو یہ ٹوکن اپنے BroadNet اکاؤنٹ سے حاصل ہوتا ہے۔ ڈیمو میں، یہ BroadAdmin پورٹل میں Integrations ← MCP Integration کے تحت “Get temporary key” کے ذریعے جنریٹ کیا جاتا ہے؛ پورٹل یہ نوٹ کرتا ہے کہ مستقل کی (key) آپ کے اکاؤنٹ ایڈمن یا ماسٹر اکاؤنٹ کی طرف سے جاری کی جاتی ہے۔

ہیڈر کے بغیر درخواست کو پروٹوکول کی سطح پر مسترد کر دیا جاتا ہے — یہ غیر تصدیق شدہ انیشلائز کال (initialize call) کا سرور کا اصل جواب ہے:

ٹکن کے بغیر رسپانس

```
event: message
data: {"jsonrpc":"2.0","id":1,"error":{"code":-32001,
  "message":"Authorization bearer token is required. Connect with an
  'Authorization: Bearer <BroadNet token>' header."}}
```

## ایک MCP کلائنٹ کو کنیکٹ کریں

زیادہ تر MCP کلائنٹس سرور URL اور ریکوسٹ ہیڈرز کے ساتھ JSON کنفیگریشن استعمال کرتے ہیں۔ ایک عام انٹری اس طرح نظر آتی ہے:

mcp.json

```
{
  "mcpServers": {
    "broadnet": {
      "type": "http",
      "url": "https://mcp.broadnet.me/mcp",
      "headers": {
        "Authorization": "Bearer ${BROADNET_TOKEN}"
      }
    }
  }
}
```

کلائنٹس کے درمیان فیلڈ کے نام تھوڑے مختلف ہو سکتے ہیں (کچھ "http" یا "streamable-http" کی قسم کی توقع رکھتے ہیں، کچھ الگ سیٹنگ سے ہیڈرز پڑھتے ہیں)۔ اپنے کلائنٹ کی MCP دستاویزات چیک کریں، اور ٹوکن کو ان فائلوں میں نہ رکھیں جنہیں آپ کمٹ کرتے ہیں — جہاں ممکن ہو اپنے کلائنٹ کی انوائرمنٹ ویری ایبل سپورٹ استعمال کریں۔

کلائنٹ کے بغیر کنکشن کو ٹیسٹ کرنے کے لیے، خود MCP انیشلائز (initialize) درخواست بھیجیں:

initialize ہینڈ شیک

```
curl -X POST https://mcp.broadnet.me/mcp \
  -H "Authorization: Bearer $BROADNET_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize",
       "params":{"protocolVersion":"2025-06-18","capabilities":{},
                 "clientInfo":{"name":"curl","version":"1.0"}}}'
```

## ڈیمو کیا دکھاتا ہے

پروڈکٹ ٹیم کی ریکارڈنگ MCP کلائنٹ کے طور پر Cursor کا استعمال کرتے ہوئے، پانچ مراحل میں پورے فلو کی وضاحت کرتی ہے:

1. 1 سائن ان کریں اپنے BroadNet اکاؤنٹ کے ساتھ BroadAdmin پورٹل میں لاگ ان کریں۔
2. 2 کلید اور کنفیگریشن حاصل کریں Integrations ← MCP Integration کھولیں، ایک عارضی کلید جنریٹ کریں اور تیار شدہ کلائنٹ کنفیگریشن کاپی کریں۔
3. 3 کلائنٹ میں سرور شامل کریں MCP کلائنٹ میں، ایک نیا MCP سرور شامل کریں اور کنفیگریشن کو mcp.json میں پیسٹ کریں — Bearer ہیڈر کے ساتھ URL https://mcp.broadnet.me/mcp۔
4. 4 ٹولز کا جائزہ لیں کلائنٹ کنیکٹ کرتا ہے اور BroadNet ٹولز کی فہرست بناتا ہے، جن میں سے ہر ایک کو آن یا آف کیا جا سکتا ہے۔
5. 5 سادہ زبان میں پوچھیں صارف ایجنٹ سے ایک نمبر پر WhatsApp پیغام بھیجنے کا کہتا ہے۔ ایجنٹ WhatsApp سینڈ ٹول کا انتخاب کرتا ہے، API پیغام کی قبولیت کے ساتھ HTTP 200 کا جواب دیتا ہے، اور پیغام بزنس اکاؤنٹ سے WhatsApp میں پہنچ جاتا ہے۔

ریکارڈنگ میں کلائنٹ 380 BroadNet ٹولز کی رپورٹ کرتا ہے، جن میں send_message، post_sms_send، post_whatsapp_message_send، get_whatsapp_template_list، post_whatsapp_template_send، post_rcs_message_send، post_telegram_message_send، post_instagram_message_send، post_messenger_message_send، post_push_message_send اور get_report_delivery شامل ہیں۔ اصل فہرست سرور ورژن اور آپ کے اکاؤنٹ پر منحصر ہے۔

اسی ریکارڈنگ کا ایک بیانیہ ورژن ایک اوور ویو کارڈ شامل کرتا ہے: ایک MCP اینڈ پوائنٹ، اور ہر ایجنٹ کے لیے وہی کاپی اور پیسٹ والے مراحل۔

ڈیمو ریکارڈنگ (1 منٹ 10 س، بغیر آواز کے): BroadAdmin میں سائن ان کریں، Cursor کو BroadNet MCP سرور سے جوڑیں، اور سادہ زبان میں WhatsApp پیغام بھیجیں۔

اسی فلو کا بیانیہ ورژن (1 منٹ 20 سیکنڈ، وائس اوور کے ساتھ)، شروع میں ایک اوور ویو کارڈ کے ساتھ۔

## سیکیورٹی نوٹس

- ٹکن ایک بھیجنے کی سند ہے اسے رکھنے والا کوئی بھی شخص آپ کے اکاؤنٹ سے میسجز بھیج سکتا ہے۔ اسے پاس ورڈ کی طرح محفوظ رکھیں، کبھی بھی کسی شیئرڈ یا کمٹڈ فائل میں نہ رکھیں۔
- تجربات کے لیے عارضی کیز کو ترجیح دیں جب آپ چیزیں آزما رہے ہوں تو عارضی کی (key) استعمال کریں، اور پروڈکشن ایجنٹ کے لیے مستقل کی (key) کے لیے اپنے اکاؤنٹ ایڈمن سے درخواست کریں۔
- صرف وہی ٹولز استعمال کریں جن کی آپ کو ضرورت ہے MCP کلائنٹس آپ کو انفرادی ٹولز بند کرنے کی اجازت دیتے ہیں۔ ایک ایجنٹ جو صرف SMS بھیجتا ہے، اسے ٹیمپلیٹ، آن بورڈنگ یا اکاؤنٹ ٹولز کی ضرورت نہیں ہوتی۔
- انسانی نگرانی برقرار رکھیں ایجنٹس قدرتی زبان کی ہدایات پر عمل کرتے ہیں۔ ان ٹولز سے پہلے کنفرمیشن مانگنے والا کلائنٹ رکھیں جو میسجز بھیجتے ہیں، خاص طور پر بہت سے وصول کنندگان کو۔
- لیک شدہ ٹوکن کو منسوخ کریں اگر کوئی ٹوکن ظاہر ہو جائے، تو اسے منسوخ کرنے اور نیا جاری کرنے کے لیے اپنے اکاؤنٹ ایڈمن یا BroadNet سپورٹ سے رابطہ کریں۔

## متعلقہ

[API ریفرنس Bearer auth کے ساتھ MCP ٹولز کے پیچھے REST اینڈ پوائنٹس۔](https://www.broadnet.me/developers/api) [OpenAPI 3.1 spec مکمل مشین ریڈ ایبل API تفصیل۔](https://www.broadnet.me/developers/openapi.yaml) [کوئیک اسٹارٹ curl یا TypeScript SDK کے ذریعے اپنا پہلا SMS بھیجیں۔](https://www.broadnet.me/ur/developers/quickstart) [رہنما: محفوظ AI ایجنٹس ایجنٹس MCP کے ذریعے SMS اور WhatsApp کیسے بھیجتے ہیں، اور پہلے سے طے شدہ حفاظتی اقدامات۔](https://www.broadnet.me/ur/blog/mcp-server-sms-whatsapp-ai-agents)

## سوالات

### BroadNet MCP سرور URL کیا ہے؟

https://mcp.broadnet.me/mcp. It uses the MCP Streamable HTTP transport and requires an Authorization: Bearer header with your BroadNet token.

### کون سے AI کلائنٹس کنیکٹ ہو سکتے ہیں؟

کوئی بھی MCP کلائنٹ جو Streamable HTTP کے ذریعے ریموٹ سرور سے منسلک ہو سکے اور ایک کسٹم Authorization ہیڈر بھیج سکے۔ ڈیمو ریکارڈنگ میں Cursor استعمال کیا گیا ہے۔

### مجھے ٹوکن کہاں سے ملے گا؟

آپ کے BroadNet اکاؤنٹ سے۔ BroadAdmin پورٹل میں، Integrations ← MCP Integration ایک عارضی key جاری کرتا ہے؛ مستقل key آپ کے اکاؤنٹ ایڈمن یا ماسٹر اکاؤنٹ سے حاصل ہوتی ہے۔

### کیا ایجنٹ حقیقی پیغامات بھیج سکتا ہے؟

جی ہاں۔ ڈیمو ریکارڈنگ میں ایجنٹ کا WhatsApp سینڈ HTTP 200 واپس کرتا ہے اور پیغام فون پر پہنچ جاتا ہے۔ یہ ٹولز آپ کے ٹوکن کی اجازت کے مطابق کام کرتے ہیں، بالکل ویسے ہی جیسے آپ کی اپنی API کالز ہوں گی، اس لیے ہر سینڈ کو حقیقی سمجھیں: صرف وہی ٹولز فعال کریں جن کی ایجنٹ کو ضرورت ہے اور سینڈ کرنے کے لیے تصدیق لازمی قرار دیں۔

## BroadNet کے ساتھ بنائیں

ایک اکاؤنٹ اور ٹوکن حاصل کریں، پھر اپنے ایجنٹ کو منسلک کریں یا براہ راست API کو کال کریں۔

[ہم سے بات کریں](https://www.broadnet.me/ur/contact) [ڈویلپر ہب](https://www.broadnet.me/ur/developers)