MCP सर्वर

Bird MCP सर्वर Bird API को Model Context Protocol टूल के रूप में उपलब्ध कराता है। समर्थित क्लाइंट में Claude Code, Cursor, VS Code, Codex, Claude, ChatGPT और Muse शामिल हैं। ये cURL कमांड कॉपी किए बिना Bird के हर चैनल पर संदेश भेज सकते हैं, उन चैनलों को सेट अप कर सकते हैं और आपके वर्कस्पेस की जाँच कर सकते हैं। आप इसे दो तरीकों से चला सकते हैं, और ज़्यादातर लोगों के लिए पहला तरीका सही है:

होस्टेड (mcp.bird.com): एक URL और ब्राउज़र साइन-इन। कुछ इंस्टॉल नहीं करना है, न CLI चाहिए, न API कुंजी। यही अनुशंसित तरीका है।
stdio पर लोकल (bird mcp): bird CLI के अंदर आपकी मशीन पर चलने वाले टूल, शेल एजेंट के लिए या इसे खुद चलाने के लिए।

होस्टेड सर्वर में ये केवल-stdio टूल शामिल नहीं हैं:

auth_signup, auth_verify_email और auth_create_org: ये टूल आपका पहला क्रेडेंशियल बनाते हैं, यानी होस्टेड सर्वर पर प्रमाणीकरण कर पाने से पहले का चरण।
compliance_attachments_upload: यह टूल एक लोकल फ़ाइल पाथ पढ़ता है। होस्टेड सर्वर पर वह पाथ सर्वर के फ़ाइल सिस्टम की ओर इशारा करेगा, जिससे गलत फ़ाइल अपलोड हो सकती है।

होस्टेड: `mcp.bird.com` से कनेक्ट करें

एंडपॉइंट चुनें

ज़्यादातर कनेक्शन के लिए https://mcp.bird.com का उपयोग करें। यही अनुशंसित एंडपॉइंट है, क्योंकि ज़्यादातर MCP क्लाइंट पूरे कैटलॉग में से टूल पहले से ही अंदरूनी तौर पर खोजते और चुनते हैं। कुछ क्लाइंट टूल को अंदरूनी तौर पर नहीं खोजते, या किसी सर्वर द्वारा उपलब्ध कराए जा सकने वाले टूल की संख्या पर सख्त सीमा लगाते हैं। /dynamic ऐसे ही क्लाइंट के लिए है।

दोनों होस्टेड एंडपॉइंट Streamable HTTP और एक ही Bird OAuth साइन-इन का उपयोग करते हैं:

एंडपॉइंट	आपके क्लाइंट को दिखने वाले टूल	इसका उपयोग कब करें
`https://mcp.bird.com`	पूरा होस्टेड टूल कैटलॉग	अधिकांश क्लाइंट के लिए अनुशंसित, जो टूल को आंतरिक रूप से खोजते और चुनते हैं। MCP Apps विजेट का भी समर्थन करता है।
`https://mcp.bird.com/dynamic`	केवल `search` और `execute`	केवल उन क्लाइंट के लिए जिनमें आंतरिक टूल खोज नहीं है या जो किसी सर्वर द्वारा दिखाए जा सकने वाले टूल की संख्या पर सख्त सीमा लगाते हैं।

डायनेमिक एंडपॉइंट आपको execute के माध्यम से वही होस्टेड ऑपरेशन उपलब्ध कराता है। स्टैंडर्ड एंडपॉइंट और लोकल stdio सर्वर अपने अलग-अलग टूल रखते हैं; वे search या execute को सूचीबद्ध नहीं करते।

आपको कोई बाइनरी इंस्टॉल करने या टोकन बनाने की ज़रूरत नहीं है। कनेक्ट करने में दो चरण लगते हैं, और दोनों ज़रूरी हैं:

सर्वर जोड़ें: क्लाइंट को अपने चुने हुए एंडपॉइंट का URL दें।
प्रमाणित करें: अपने ब्राउज़र से साइन इन करें, ताकि क्लाइंट के पास ऐसा टोकन हो जो आपकी ओर से काम करे।

दोनों एंडपॉइंट के लिए प्रमाणीकरण ज़रूरी है। जिस क्लाइंट के पास केवल URL है, उसे साइन इन करने तक 401 मिलता है। कुछ क्लाइंट पहली बार सर्वर तक पहुँचने पर खुद साइन-इन शुरू करते हैं; अन्य सर्वर को "needs login" के रूप में रोककर आपके क्लिक करने का इंतज़ार करते हैं। आपके क्लाइंट के चरण बताते हैं कि वह कैसे व्यवहार करता है।

डायनेमिक टूल खोज का उपयोग करें

अगर आपका क्लाइंट बहुत ज़्यादा टूल होने के कारण सर्वर को अस्वीकार करता है, तो https://mcp.bird.com/dynamic से कनेक्ट करें और OAuth साइन-इन पूरा करें। आपका क्लाइंट दो टूल दिखाता है:

search नाम या विवरण के कीवर्ड से टूल ढूँढता है। हर मिलान में उसका नाम, विवरण, इनपुट स्कीमा और ऐसे एनोटेशन होते हैं जो बताते हैं कि टूल डेटा पढ़ता है या बदलता है।
execute एक चुने गए टूल को उसके आर्ग्युमेंट के साथ कॉल करता है। चुने गए टूल के अनुसार यह डेटा पढ़ सकता है, संदेश भेज सकता है, रिकॉर्ड बदल सकता है या उन्हें हटा सकता है।

उदाहरण के लिए, आपका एजेंट इस टूल कॉल से वर्कस्पेस टूल ढूँढ सकता है:

कोड उदाहरण

{
  "name": "search",
  "arguments": { "query": "workspace_get", "limit": 3 }
}

लौटाया गया इनपुट स्कीमा पढ़ने के बाद, वह उस टूल को execute के ज़रिए कॉल करता है:

कोड उदाहरण

{
  "name": "execute",
  "arguments": { "tool": "workspace_get", "arguments": {} }
}

परिणाम में आपका मौजूदा वर्कस्पेस होता है। आप send email जैसे काम से जुड़े कीवर्ड से भी खोज सकते हैं। खोज डिफ़ॉल्ट रूप से पाँच मिलान लौटाती है, 1 से 10 तक का limit स्वीकार करती है, और 500 वर्णों तक की क्वेरी स्वीकार करती है। अगर परिणाम में has_more: true है, तो ज़्यादा प्रासंगिक मिलान पाने के लिए अपनी क्वेरी को सीमित करें।

खोज परिणाम आपके क्लाइंट के कैटलॉग में टूल नहीं जोड़ते। परिणामों या रिकवरी निर्देशों में बताए गए नाम भी execute के ज़रिए ही चलते हैं। निष्पादन आपकी मौजूदा अनुमतियों से होता है; अगर किसी ऑपरेशन को ज़्यादा अनुमतियाँ चाहिए, तो आपका क्लाइंट आपसे उन्हें अधिकृत करने को कह सकता है। कोई टूल ढूँढ लेने से उसकी एक्सेस नहीं मिलती।

जो टूल सामान्यतः विजेट दिखाते हैं, उनके लिए डायनेमिक निष्पादन डेटा लौटाता है। इंटरैक्टिव MCP Apps विजेट के लिए स्टैंडर्ड एंडपॉइंट का उपयोग करें। क्लाइंट को एक ही निष्पादन टूल दिखता है, इसलिए प्रति-टूल अनुमोदन सेटिंग पूरे execute पर लागू होती हैं; किसी कॉल को अनुमोदित करने से पहले चुना गया ऑपरेशन जाँच लें। यह एंडपॉइंट टूल कॉल निष्पादित करता है और JavaScript या दिया गया कोई अन्य कोड नहीं चलाता।

क्लाइंट कनेक्ट करें

नीचे दिए गए उदाहरण स्टैंडर्ड एंडपॉइंट का उपयोग करते हैं। डायनेमिक डिस्कवरी के लिए सर्वर URL के रूप में https://mcp.bird.com/dynamic डालें और साइन-इन के वही चरण अपनाएँ।

Claude Code

सर्वर जोड़ें:

कोड उदाहरण

claude mcp add --transport http bird https://mcp.bird.com

अब claude mcp list में bird की स्थिति ! Needs authentication दिखती है। Claude Code अपने आप ब्राउज़र नहीं खोलता, इसलिए किसी सेशन के अंदर से साइन इन करें:

/mcp चलाएँ।
bird चुनें और Enter दबाएँ।
Authenticate चुनें। आपका ब्राउज़र Bird की सहमति स्क्रीन खोलता है; वहीं उसे स्वीकृत करें।

इसके बाद सर्वर कनेक्टेड दिखता है और टूल काम करने लगते हैं। हेडलेस रन (claude -p) में /mcp पैनल नहीं होता, इसलिए पहले अपने शेल से claude mcp login bird के साथ ऑथेंटिकेट करें। बाद में फिर से साइन इन करने के लिए /mcp में Re-authenticate विकल्प मिलता है; Clear authentication सहेजे गए टोकन को हटा देता है।

bird-ai प्लगइन इंस्टॉल करने पर यह सर्वर आपके लिए अपने आप घोषित हो जाता है, जिससे claude mcp add कमांड की ज़रूरत नहीं रहती। ऑथेंटिकेशन फिर भी ज़रूरी है, क्योंकि प्लगइन सर्वर तो दे सकता है, पर अनुमति जारी नहीं कर सकता। इंस्टॉल करने के बाद /mcp > bird > Authenticate चुनें।

Cursor

~/.cursor/mcp.json में:

कोड उदाहरण

{
  "mcpServers": {
    "bird": {
      "url": "https://mcp.bird.com"
    }
  }
}

इसके बाद Cursor साइडबार में Customize खोलें और MCPs चुनें। bird ढूँढें, उसके साइन-इन प्रॉम्प्ट का पालन करें, ब्राउज़र में Bird की सहमति स्क्रीन को स्वीकृत करें और Cursor पर लौट आएँ।

OpenCode

Bird का OpenCode प्लगइन आपके लिए सर्वर को Bird की एजेंट स्किल्स के साथ रजिस्टर कर देता है:

कोड उदाहरण

opencode plugin github:messagebird/bird-ai --global

OpenCode हर MCP टूल को मॉडल के संदर्भ में जोड़ देता है, इसलिए प्लगइन डायनामिक एंडपॉइंट से कनेक्ट होता है। OpenCode का प्रायोगिक कोड मोड चालू होने पर (OPENCODE_EXPERIMENTAL_CODE_MODE=1 या OPENCODE_EXPERIMENTAL=1), OpenCode MCP टूल्स को अपनी खोज के पीछे रखता है, और प्लगइन इसके बजाय https://mcp.bird.com पर पूरे कैटलॉग से कनेक्ट होता है।

प्लगइन के बिना सर्वर जोड़ने के लिए, इसे अपने प्रोजेक्ट में या ~/.config/opencode/opencode.json पर opencode.json में रखें:

कोड उदाहरण

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "bird": {
      "type": "remote",
      "url": "https://mcp.bird.com/dynamic"
    }
  },
  "permission": {
    "bird_execute": "ask"
  }
}

फिर साइन इन करें। इससे Bird की सहमति स्क्रीन के लिए आपका ब्राउज़र खुलता है:

कोड उदाहरण

opencode mcp auth bird

प्लगइन लोड करने के लिए OpenCode को रीस्टार्ट करें। आपके स्वीकृत करने के बाद opencode mcp list में bird कनेक्टेड दिखता है। ऊपर दी गई permission एंट्री की तरह, प्लगइन भी OpenCode से हर execute कॉल से पहले पुष्टि मँगवाता है, क्योंकि जो टूल यह चलाता है वह आपके वर्कस्पेस में बदलाव कर सकता है।

VS Code

अपने प्रोजेक्ट में .vscode/mcp.json में:

कोड उदाहरण

{
  "servers": {
    "bird": {
      "type": "http",
      "url": "https://mcp.bird.com"
    }
  }
}

क्या आप इसके बजाय settings.json इस्तेमाल करते हैं? वही bird एंट्री mcp.servers के अंतर्गत रखें। VS Code इसे आपकी यूज़र mcp.json में ले जाता है, जिसे MCP: Open User Configuration खोलता है:

कोड उदाहरण

{
  "mcp": {
    "servers": {
      "bird": {
        "type": "http",
        "url": "https://mcp.bird.com"
      }
    }
  }
}

सर्वर पहली बार शुरू होने पर VS Code आपसे उस पर भरोसा करने को कहता है, फिर OAuth फ़्लो खुद चलाता है: जो ब्राउज़र विंडो यह खोलता है, उसमें Bird की सहमति स्क्रीन को स्वीकृत करें। अगर कोई विंडो नहीं दिखती, तो MCP: List Servers कमांड से bird को शुरू या रीस्टार्ट करें और तब स्वीकृत करें। मिली हुई अनुमति Accounts > Manage Trusted MCP Servers में दिखती है, और वहीं से आप VS Code की पहुँच रद्द भी कर सकते हैं।

ChatGPT और Codex

ChatGPT या Codex में Bird इंस्टॉल करें, अपने Bird वर्कस्पेस में साइन इन करें, और अपने एजेंट से संदेश भेजने, डोमेन और नंबर प्रबंधित करने और डिलीवरी जाँचने को कहें।

इसके बजाय Codex को मैन्युअल रूप से सेट अप करने के लिए, ~/.codex/config.toml में यह एंट्री जोड़ें:

कोड उदाहरण

[mcp_servers.bird]
url = "https://mcp.bird.com"

फिर अपने शेल से साइन इन करें, जिससे ब्राउज़र खुलता है:

कोड उदाहरण

codex mcp login bird

Claude

Bird Claude की कनेक्टर डायरेक्टरी में सूचीबद्ध है। डायरेक्टरी में Bird खोलें और साइन-इन चलाने तथा सहमति स्क्रीन स्वीकृत करने के लिए Connect to Claude पर क्लिक करें। हर बातचीत के लिए + > Connectors से कनेक्टर चालू करें। यह वेब पर Claude और डेस्कटॉप ऐप दोनों में काम करता है।

इसके बजाय इसे हाथ से जोड़ने के लिए, Customize > Connectors खोलें, + पर क्लिक करें, फिर Add custom connector पर। https://mcp.bird.com पेस्ट करें और Add पर क्लिक करें। फिर साइन-इन चलाने और सहमति स्क्रीन स्वीकृत करने के लिए Bird कनेक्टर पर Connect पर क्लिक करें। Team और Enterprise प्लान पर कोई owner Organization settings > Connectors से कनेक्टर एक बार जोड़ता है, और हर सदस्य को अपने ग्रांट के लिए फिर भी Customize > Connectors में Connect पर क्लिक करना होता है। हर बातचीत के लिए + > Connectors से कनेक्टर चालू करें।

इसके बजाय ChatGPT को मैन्युअल रूप से सेट अप करने के लिए, OpenAI की MCP ऐप सेटअप गाइड का पालन करें, जिसमें सर्वर URL के रूप में https://mcp.bird.com और ऑथेंटिकेशन के रूप में OAuth का उपयोग करें। Bird का ब्राउज़र साइन-इन पूरा करें, फिर अपनी चैट में Bird का उपयोग करें।

Muse

Muse Bird को कस्टम कनेक्टर के रूप में जोड़ता है। किसी Muse चैट में उससे एक कनेक्टर सेट अप करने को कहें:

कोड उदाहरण

Set up a custom connector to the Bird MCP server at https://mcp.bird.com following https://bird.com/docs/ai/mcp-server.md so you can work with my Bird workspace.

Muse इस सत्र के लिए एक कनेक्शन लिंक भेजता है। उसे खोलें और ब्राउज़र में Bird की सहमति स्क्रीन स्वीकृत करें। यह लिंक केवल आपके लिए काम करता है और सत्र के साथ समाप्त हो जाता है। अगर यह काम करना बंद कर दे, तो Muse से नया लिंक माँगें।

Factory Droid

कोड उदाहरण

droid mcp add bird https://mcp.bird.com --type http

फिर droid के अंदर /mcp चलाएँ और सर्वर मैनेजर से ब्राउज़र साइन-इन पूरा करें।

Antigravity

Bird का Antigravity प्लगइन आपके लिए सर्वर को Bird की एजेंट स्किल्स के साथ रजिस्टर कर देता है:

कोड उदाहरण

curl -fsSL https://raw.githubusercontent.com/messagebird/bird-ai/main/antigravity.sh | bash

प्लगइन के बिना सर्वर जोड़ने के लिए यह कॉन्फ़िगरेशन ~/.gemini/config/mcp_config.json में रखें, या किसी एक प्रोजेक्ट के लिए .agents/mcp_config.json में रखें। Antigravity रिमोट सर्वर का पता serverUrl से पढ़ता है, इसलिए उस कुंजी का नाम न बदलें:

कोड उदाहरण

{
  "mcpServers": {
    "bird": {
      "serverUrl": "https://mcp.bird.com"
    }
  }
}

फिर साइन इन करें: साइडबार में Customizations खोलें (IDE में macOS पर Cmd+, से या Windows और Linux पर Ctrl+, से Agent settings खोलें), और bird के बगल में Authenticate चुनें। अगर bird सूची में नहीं है, तो Antigravity को रीस्टार्ट करें। ब्राउज़र में Bird की सहमति स्क्रीन पर अनुमति दें, वहाँ दिखाया गया ऑथराइज़ेशन कोड कॉपी करें, उसे Antigravity में पेस्ट करें और Submit चुनें।

Agent Plugins

bird-ai प्लगइन इस सर्वर को एक mcp.json में घोषित करता है, जो Agent Plugins का पालन करती है। इस स्पेसिफ़िकेशन को लागू करने वाला होस्ट प्लगइन इंस्टॉल होते समय वह फ़ाइल पढ़ता है। इसलिए आपको सर्वर कॉन्फ़िग लिखने की ज़रूरत नहीं है: प्लगइन इंस्टॉल करें और साइन इन करें।

कोई अन्य होस्ट

वह सेटिंग खोजें जो remote, HTTP या custom MCP सर्वर जोड़ती है। यह अक्सर Connectors या Integrations मेनू में होती है। वहाँ URL दें। फ़ील्ड की जगह हर क्लाइंट में अलग होती है; अपने चुने हुए होस्टेड एंडपॉइंट का URL इस्तेमाल करें। फिर उस क्लाइंट में साइन इन का विकल्प खोजें: सर्वर के बगल में Connect, Authorize या Needs login कंट्रोल, कोई login सबकमांड, या क्लाइंट द्वारा अपने आप खोली गई ब्राउज़र विंडो। अगर कोई क्लाइंट Bird के टूल दिखाता है लेकिन हर कॉल विफल होती है, तो उसके पास URL है लेकिन उसे अभी भी ग्रांट चाहिए।

साइन इन करने पर क्या होता है

आपका ब्राउज़र Bird की सहमति स्क्रीन खोलता है। साइन इन करें, चुनें कि वर्कस्पेस अनुमतियाँ देनी हैं या संगठन अनुमतियाँ, और चुनें कि कौन-सी अनुमतियाँ सौंपनी हैं। MCP क्लाइंट खुद को रजिस्टर करते हैं, इसलिए क्लाइंट का नाम उसी का बताया हुआ होता है। इसी कारण स्क्रीन उसे not verified by Bird के रूप में चिह्नित करती है। अनुमति देने से पहले पुष्टि करें कि यह वही क्लाइंट है जिसे आपने लॉन्च किया था। इसके बाद टूल एजेंट की सूची में दिखने लगते हैं और टोकन चुपचाप रिफ़्रेश होता रहता है। इसलिए हर क्लाइंट के लिए यह एक ही बार का कदम है।

यह जाँचने का सबसे तेज़ तरीका है कि एजेंट से whoami कॉल करवाएँ: यह साइन-इन किए हुए उपयोगकर्ता को लौटाता है, इसलिए असली जवाब मिलने का मतलब है कि ग्रांट लागू है। डायनैमिक एंडपॉइंट पर इसे execute के ज़रिए tool: "whoami" और खाली arguments के साथ कॉल करें।

ग्रांट उतनी ही अनुमतियों तक सीमित रहती है जो क्लाइंट ने माँगीं, आपने स्वीकृत कीं और वास्तव में आपके पास हैं, यानी इन तीनों में साझा अनुमतियाँ। org:owner और प्लेटफ़ॉर्म-एडमिन स्कोप कभी नहीं सौंपे जा सकते। ग्रांट आपकी प्रोफ़ाइल की Connected apps सूची में दिखती है, और वहाँ उसे रद्द करते ही क्लाइंट की पहुँच तुरंत बंद हो जाती है।

हैंडशेक कैसे काम करता है

क्लाइंट कनेक्ट करने के लिए आपको इसकी ज़रूरत नहीं है। यह तब काम आता है जब आप किसी ऐसे क्लाइंट को डीबग कर रहे हों जो प्रमाणीकरण नहीं कर पा रहा, या खुद क्लाइंट लिख रहे हों।

होस्टेड टियर Streamable HTTP का उपयोग करता है और क्रेडेंशियल-रहित है: यह कोई सीक्रेट संग्रहीत नहीं करता और खुद कुछ भी सत्यापित नहीं करता। हर अनुरोध में आपका अपना OAuth बेयरर टोकन होता है, जिसे Bird का API हर अनुरोध पर सत्यापित करता है। सर्वर स्टेटलेस है और क्षेत्रीय ट्रैफ़िक अपने-आप रूट होता है, इसलिए एक ही URL हर जगह से काम करता है।

साइन-इन फ़्लो मानक MCP का उपयोग करता है। क्लाइंट केवल इस बात में अलग होते हैं कि इसे क्या शुरू करता है: पहला टूल कॉल या Authenticate चुनना। फ़्लो शुरू होने के बाद प्रमाणीकरण के चरणों के लिए किसी अतिरिक्त कॉन्फ़िगरेशन की ज़रूरत नहीं होती:

क्लाइंट बिना प्रमाणीकरण के अनुरोध भेजता है और उसे 401 मिलता है, जिसमें एक WWW-Authenticate हेडर होता है जो Bird के RFC 9728 protected-resource मेटाडेटा (/.well-known/oauth-protected-resource) की ओर इशारा करता है।
वहाँ से वह ऑथराइज़ेशन सर्वर का पता लगाता है, फिर खुद को डायनेमिक रूप से रजिस्टर करता है (RFC 7591)। डायनेमिक रजिस्ट्रेशन के कारण पहले से साझा किए गए क्लाइंट ID या मैन्युअल कॉन्फ़िगरेशन की ज़रूरत नहीं रहती।
आपका ब्राउज़र Bird की सहमति स्क्रीन खोलता है।
क्लाइंट परिणाम के बदले एक एक्सेस टोकन लेता है (PKCE; अपने-आप रीफ़्रेश होता है) और Bird टूल दिखाई देने लगते हैं।

लोकल: CLI के साथ इसे stdio पर चलाएँ

शेल चला सकने वाले एजेंटों के लिए या अपनी मशीन की फ़ाइलों तक पहुँच के लिए लोकल MCP सर्वर को bird CLI के अंदर चलाएँ। CLI इंस्टॉल करें, एक बार bird auth login चलाएँ, फिर अपने क्लाइंट को bird mcp कमांड पर सेट करें।

आप bird mcp खुद नहीं चलाते: आपका क्लाइंट इसे लॉन्च करता है और stdin/stdout पर इससे संवाद करता है। हर क्लाइंट को वही दो जानकारियाँ चाहिए: कमांड (bird) और आर्ग्युमेंट (mcp)। इस तरीके में हर क्लाइंट के लिए अलग साइन-इन की ज़रूरत नहीं होती, क्योंकि bird auth login के पास पहले से ग्रांट मौजूद है।

Cursor

कोड उदाहरण

{
  "mcpServers": {
    "bird": {
      "command": "bird",
      "args": ["mcp"]
    }
  }
}

VS Code

अपने प्रोजेक्ट में .vscode/mcp.json में:

कोड उदाहरण

{
  "servers": {
    "bird": {
      "type": "stdio",
      "command": "bird",
      "args": ["mcp"]
    }
  }
}

Claude Code

कोड उदाहरण

claude mcp add bird -- bird mcp

लोकल सर्वर कैसे प्रमाणित होता है

लोकल सर्वर आपकी ओर से काम करता है और CLI के सहेजे गए लॉगिन का दोबारा उपयोग करता है। bird auth login ब्राउज़र में एक OAuth फ़्लो खोलता है, जिसमें आप अपनी वर्कस्पेस अनुमतियों का एक हिस्सा प्रदान करते हैं। जारी किए गए टोकन पर वही अनुमति सीमाएँ लागू होती हैं जो होस्टेड अनुदान पर होती हैं। न org:owner और न ही प्लेटफ़ॉर्म-एडमिन स्कोप उपलब्ध होते हैं। bird mcp सहेजे गए लॉगिन को CLI की क्रेडेंशियल फ़ाइल से पढ़ता और रीफ़्रेश करता है, जिसका मोड 0600 है। होस्टेड टियर की तरह, आपके क्लाइंट कॉन्फ़िगरेशन में कोई BIRD_API_KEY या अन्य सीक्रेट नहीं होता। अगर लॉगिन मौजूद नहीं है, तो bird mcp शुरू होने से मना कर देता है और आपको bird auth login चलाने के लिए कहता है।

आपको कोई लिसनर खोलने की ज़रूरत नहीं है: सर्वर आपकी मशीन पर, क्लाइंट के सैंडबॉक्स के अंदर, ठीक उतनी देर चलता है जितनी देर क्लाइंट को इसकी ज़रूरत होती है। API होस्ट अपने आप आपके लॉगिन के क्षेत्र का पालन करता है; नॉन-प्रोडक्शन एनवायरनमेंट पर टेस्ट करने के लिए --base-url (या BIRD_API_URL) इसे बदल देता है।

टूल किन कामों को कवर करते हैं

टूलसेट उन सभी चैनलों को कवर करता है जिन्हें Bird चलाता है, साथ ही उनसे जुड़े अकाउंट और कॉन्फ़िगरेशन के काम भी। यह पूरी API सतह नहीं, बल्कि चुना हुआ सेट है: हर टूल उस एक काम तक सीमित है जो एजेंट वास्तव में करता है, और विनाशकारी ऑपरेशन चिह्नित होते हैं ताकि होस्ट उन्हें चलाने से पहले पूछ सकें।

ईमेल के लिए सबसे ज़्यादा टूल हैं, क्योंकि उसमें कॉन्फ़िगर करने के लिए सबसे ज़्यादा चीज़ें हैं। बाकी चैनल भी भेजने और पढ़ने का यही ढाँचा अपनाते हैं।

मैसेजिंग

ईमेल भेजें और जाँचें: email_send, email_send_batch, email_list, और email_get, जो संदेश को उसकी कुल डिलीवरी स्थिति के साथ लौटाता है। हर प्राप्तकर्ता की डिलीवरी स्थिति और इवेंट लॉग के लिए अलग टूल कॉल होते हैं।
SMS भेजें और जाँचें: sms_send, sms_send_batch, sms_get, sms_list, और sms_list_events, जो ईमेल वाले ढाँचे जैसे ही हैं। sms_templates_list और sms_templates_get टेम्पलेट कैटलॉग पढ़ते हैं।
WhatsApp भेजें और जाँचें: whatsapp_send, whatsapp_get, whatsapp_list, whatsapp_list_events और whatsapp_media। टेम्पलेट whatsapp_templates_* के अंतर्गत पूरी तरह लिखे और संपादित किए जा सकते हैं, जिसमें प्रति-संस्करण और प्रति-भाषा सामग्री शामिल है।
वॉइस कॉल लेग जाँचें: voice_legs_get और voice_legs_list कॉल लेग पढ़ते हैं, और voice_stats_* के अंतर्गत प्रति-देश और प्रति-रिस्पॉन्स-कोड आँकड़े मिलते हैं। voice_session_credentials_create वह वर्कस्पेस क्रेडेंशियल बनाता है जिससे कोई SIP या सॉफ्टफ़ोन क्लाइंट प्रमाणित होता है।
प्राप्तकर्ता का सत्यापन करें: verify_verifications_create एक बार उपयोग होने वाला सत्यापन कोड भेजता है, verify_verifications_check प्राप्तकर्ता द्वारा सबमिट किए गए कोड को जाँचता है, और verify_verifications_next_channel किसी दूसरे चैनल पर भेजता है।
वॉइस कॉल बनाएँ (प्रीव्यू): voice_calls_create किसी सक्षम, अनआर्काइव्ड सीक्वेंस के सक्रिय प्रकाशन का उपयोग करके आउटबाउंड कॉल तैयार करता है। कोई व्यक्ति ब्राउज़र में अनुरोध की समीक्षा करके उसे चलाता है; तैयार करने से कॉल नहीं लगती। अनुमतियों और फिर से प्रयास करने के निर्देशों के लिए वॉइस कॉल बनाएँ देखें। लोकल bird mcp सर्वर के लिए CLI का ऐसा संस्करण चाहिए जिसमें यह टूल शामिल हो।

चैनल को भेजने के लिए तैयार करना

सेंडिंग डोमेन सेट करें: email_domains_create सेंडिंग डोमेन जोड़ता है और प्रकाशित करने के लिए DNS रिकॉर्ड लौटाता है; email_domains_verify उन्हें दोबारा जाँचता है; साथ में email_domains_list और email_domains_get भी हैं।
SMS सेंडर क्लेम और रजिस्टर करें: sms_senders_create सेंडर क्लेम करता है, sms_senders_requirements बताता है कि कोई देश उससे क्या माँगता है, और sms_senders_registrations_create उसे रजिस्टर करता है। US A2P ट्रैफ़िक sms_10dlc_* ब्रांड, कैंपेन और सबमिशन टूल से होकर चलता है।
नंबर प्रोविज़न करें: numbers_available_list खोजता है, numbers_orders_create खरीदता है, numbers_cancel भुगतान अवधि के अंत में नंबर लौटाता है (या नंबर की कोई सदस्यता न हो तो तुरंत), और numbers_release अभी लौटाता है। whatsapp_numbers_precheck ऑर्डर करने से पहले बताता है कि WhatsApp कोई नंबर स्वीकार करेगा या नहीं।
जाँचें कि खाता भेज सकता है या नहीं: trust_* टूल संगठन की वे आवश्यकताएँ बताते हैं जिनके पूरा होने पर ही नंबर खरीदा या सेंडर रजिस्टर किया जा सकता है।

ईमेल डिलीवरेबिलिटी

ईमेल टेम्पलेट लिखें: email_templates_create, email_templates_list, email_templates_get, email_templates_update, email_templates_duplicate और email_templates_preview (बिना भेजे सैंपल मानों के साथ ड्राफ़्ट रेंडर करता है)। संस्करण email_templates_versions_* के अंतर्गत रहते हैं, जहाँ email_templates_versions_submit ड्राफ़्ट को फ़्रीज़ करके उसे वह संस्करण बनाता है जिसका उपयोग भेजे गए संदेश करते हैं, और email_templates_versions_languages_* ड्राफ़्ट की प्रति-भाषा सामग्री संपादित करता है। एजेंट जो भी लिखता है, वह सबमिट होने तक किसी प्राप्तकर्ता तक नहीं पहुँचता।
सप्रेशन प्रबंधित करें: email_suppressions_list, email_suppressions_check (क्या इस पते पर भेजना सुरक्षित है?), email_suppressions_add और email_suppressions_remove (विनाशकारी के रूप में चिह्नित, क्योंकि बिना कारण सप्रेशन हटाने से सेंडर की प्रतिष्ठा को नुकसान होता है)।
समर्पित IP और पूल प्रबंधित करें: email_dedicated_ips_create, email_dedicated_ips_list, email_dedicated_ips_get, email_dedicated_ips_assign (किसी IP को पूल में ले जाएं), और email_dedicated_ips_delete; साथ ही उन पूल के लिए email_ip_pools_create, email_ip_pools_list, email_ip_pools_get, email_ip_pools_update, और email_ip_pools_delete जिनसे होकर आप संदेश भेजते हैं।

ऑडियंस और कॉन्फ़िगरेशन

संपर्क और ऑडियंस प्रबंधित करें: जिन लोगों को आप संदेश भेजते हैं उनके लिए contacts_* और contact_properties_*, जिन सूचियों को आप भेजते हैं उनके लिए audiences_*, और सहमति अनुमतियों व ऑप्ट-आउट के लिए preferences_*।
Realtime प्रोविज़न करें: realtime_apps_* और realtime_apps_keys_* वे ऐप और कुंजियां बनाते हैं जिनसे Realtime क्लाइंट कनेक्ट होते हैं।
किसी के बारे में जानकारी देखें: किसी पते पर भेजने से पहले lookup_phone_number और lookup_email बताते हैं कि Bird उस पते के बारे में क्या जानता है।
कॉन्फ़िगरेशन जांचें: webhooks_list, workspace_get, और whoami (साइन इन किया हुआ उपयोगकर्ता: id, ईमेल, नाम)।

आपका क्लाइंट नाम, विवरण और इनपुट स्कीमा के साथ टूल की लाइव सूची दिखाता है। उसी सूची को आधिकारिक इन्वेंटरी मानें। शुरू से अंत तक आज़माने के लिए एक अच्छा पहला काम:

Call whoami to find my email, then send me a test email from onboarding@messagebird.dev and tell me when it's delivered.

MCP या CLI?

दोनों की क्षमताएं और ऑथ मॉडल एक जैसे हैं, बस इन्हें कॉल करने वाले अलग हैं। शेल चला सकने वाले एजेंट (Claude Code, Cursor का टर्मिनल, CI) के लिए CLI हल्का है: JSON आउटपुट, अर्थपूर्ण एग्ज़िट कोड, और हर ऑपरेशन में कहीं कम टोकन। MCP उन होस्ट के लिए है जो शेल चलाने के बजाय टूल कॉल करते हैं, और होस्टेड एंडपॉइंट उन होस्ट तक पहुंचता है जो कोई बाइनरी चला ही नहीं सकते (Claude Desktop, ChatGPT, मोबाइल)। आपको पहले से चुनना ज़रूरी नहीं है: होस्टेड URL के लिए कुछ इंस्टॉल नहीं करना पड़ता, और CLI इंस्टॉल होते ही लोकल bird mcp भी उपलब्ध रहता है।

अगले कदम

MCP Events: अपने क्लाइंट को Bird इवेंट, जैसे किसी मेलबॉक्स में नया मेल, के लिए सब्सक्राइब करें और हर इवेंट को साइन किए गए वेबहुक के रूप में पाएं।
AI से ईमेल एनालिटिक्स क्वेरी करें: डिलीवरी, एंगेजमेंट और विलंब के बारे में सरल भाषा में पूछें।
AI ऑनबोर्डिंग: इस पेज का क्विकस्टार्ट संस्करण, साथ में मशीन द्वारा पढ़ा जा सकने वाला डॉक्स संग्रह।
एजेंट स्किल्स: bird-ai मार्केटप्लेस प्लगइन, जो स्किल्स और यह MCP सर्वर एक ही चरण में इंस्टॉल करता है।
एजेंट्स के लिए CLI: शेल चला सकने वाले एजेंट्स से MCP के बिना Bird चलाएँ: JSON आउटपुट, सिमेंटिक एग्ज़िट कोड और OAuth लॉगिन।
ऑथेंटिकेशन: API कुंजियाँ, क्षेत्र, और अनुरोधों को कैसे अधिकृत किया जाता है।

इस विषय के लिए दस्तावेज़, गाइड और उदाहरणों के साथ आगे बढ़ें।

इम्प्लीमेंटेशन ब्रीफ़ पाएँ

संबंधित संसाधन