MCP सर्वर

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

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

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

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

1. सर्वर जोड़ें: क्लाइंट को आपका चुना हुआ एंडपॉइंट URL दें।
2. ऑथेंटिकेट करें: अपने ब्राउज़र से साइन इन करें ताकि क्लाइंट के पास एक टोकन हो जो आपकी तरफ़ से काम करे।

डायनामिक टूल डिस्कवरी का उपयोग करें

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

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

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

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

Claude Code

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

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

Cursor

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

OpenCode

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

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

opencode mcp auth bird

VS Code

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

Codex

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

codex mcp login bird

Claude Desktop

ChatGPT

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.

Factory Droid

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

Agent Plugins

कोई भी अन्य host

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

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

1. Client एक unauthenticated request करता है और उसे 401 मिलता है जिसमें WWW-Authenticate हेडर Bird के RFC 9728 protected-resource metadata (/.well-known/oauth-protected-resource) की ओर इशारा करता है।
2. वहाँ से वह authorization server खोजता है, फिर खुद को dynamically register करता है (RFC 7591)। Dynamic registration पहले से साझा client ID या मैन्युअल कॉन्फ़िगरेशन की ज़रूरत समाप्त कर देता है।
3. आपका ब्राउज़र Bird की consent स्क्रीन खोलता है।
4. Client परिणाम को access token से एक्सचेंज करता है (PKCE; अपने-आप रिफ़्रेश होता है) और Bird टूल्स दिखने लगते हैं।

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

Cursor

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

VS Code

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

Claude Code

claude mcp add bird -- bird mcp

लोकल सर्वर कैसे authenticate होता है

टूल्स क्या कवर करते हैं

मैसेजिंग

• Email भेजें और जाँचें: email_send, email_send_batch, email_list, और email_get, जो संदेश को उसकी aggregate delivery स्थिति के साथ लौटाता है। प्रति-recipient delivery स्थितियाँ और event log अलग tool calls हैं।
• SMS भेजें और जाँचें: sms_send, sms_send_batch, sms_get, sms_list, और sms_list_events, email की संरचना जैसा। sms_templates_list और sms_templates_get template कैटलॉग पढ़ते हैं।
• WhatsApp भेजें और जाँचें: whatsapp_send, whatsapp_get, whatsapp_list, whatsapp_list_events, और whatsapp_media। Templates whatsapp_templates_* के अंतर्गत एक पूर्ण authoring surface हैं, जिसमें per-version और per-language content शामिल है।
• वॉइस कॉल लेग जाँचें: voice_legs_get और voice_legs_list कॉल लेग पढ़ते हैं। देश और रिस्पॉन्स कोड के अनुसार आँकड़े voice_stats_* में मिलते हैं। voice_session_credentials_create वर्कस्पेस क्रेडेंशियल बनाता है, जिससे SIP या सॉफ्टफ़ोन क्लाइंट प्रमाणीकरण करता है।
• Recipient को verify करें: verify_verifications_create एक वन-टाइम सत्यापन कोड भेजता है, verify_verifications_check recipient ने जो सबमिट किया उसे validate करता है, और verify_verifications_next_channel दूसरे चैनल पर fallback करता है।
• वॉइस कॉल बनाएँ (प्रीव्यू): voice_calls_create सक्षम और गैर-संग्रहीत सीक्वेंस के सक्रिय प्रकाशन का उपयोग करके आउटबाउंड कॉल की रिक्वेस्ट तैयार करता है। कोई व्यक्ति ब्राउज़र में रिक्वेस्ट की समीक्षा करके उसे चलाता है; तैयार करने से कॉल नहीं लगती। अनुमतियों और दोबारा कोशिश करने के निर्देशों के लिए वॉइस कॉल बनाएँ देखें। स्थानीय bird mcp सर्वर के लिए CLI का ऐसा वर्शन चाहिए जिसमें यह टूल शामिल हो।

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

• Sending domains सेट करें: email_domains_create एक sending domain जोड़ता है और प्रकाशित करने के लिए DNS records लौटाता है; email_domains_verify उन्हें फिर से जाँचता है; साथ ही email_domains_list और email_domains_get।
• SMS senders claim और register करें: sms_senders_create एक sender claim करता है, sms_senders_requirements बताता है कि कोई देश उससे क्या माँगता है, और sms_senders_registrations_create उसे register करता है। US A2P ट्रैफ़िक sms_10dlc_* brand, campaign, और submission टूल्स से होकर गुज़रता है।
• Numbers प्रोविज़न करें: numbers_available_list खोजता है, numbers_orders_create खरीदता है, और numbers_release वापस करता है। whatsapp_numbers_precheck बताता है कि ऑर्डर करने से पहले WhatsApp कोई number स्वीकार करेगा या नहीं।
• जाँचें कि अकाउंट भेज सकता है या नहीं: trust_* टूल्स उन संगठन आवश्यकताओं की रिपोर्ट करते हैं जो number खरीदने या sender register करने के लिए ज़रूरी हैं।

Email deliverability

• Email templates लिखें: email_templates_create, email_templates_list, email_templates_get, email_templates_update, email_templates_duplicate, और email_templates_preview (बिना भेजे sample values के साथ draft render करें)। Versions email_templates_versions_* के अंतर्गत रहते हैं, जहाँ email_templates_versions_submit एक draft को freeze करता है और उसे वह version बनाता है जो sends serve करता है, और email_templates_versions_languages_* किसी draft का per-language content संपादित करता है। कोई agent जो लिखता है वह submit करने तक किसी recipient तक नहीं पहुँचता।
• Suppressions प्रबंधित करें: email_suppressions_list, email_suppressions_check (क्या यह address भेजने के लिए सुरक्षित है?), email_suppressions_add, और email_suppressions_remove (destructive के रूप में एनोटेट, क्योंकि बिना कारण suppression हटाना sender reputation को नुकसान पहुँचाता है)।
• Dedicated IPs और pools प्रबंधित करें: email_dedicated_ips_create, email_dedicated_ips_list, email_dedicated_ips_get, email_dedicated_ips_assign (एक को pool में ले जाएँ), और email_dedicated_ips_delete; साथ ही email_ip_pools_create, email_ip_pools_list, email_ip_pools_get, email_ip_pools_update, और email_ip_pools_delete उन pools के लिए जिनसे आप sends route करते हैं।

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

• Contacts और audiences प्रबंधित करें: जिन लोगों को आप भेजते हैं उनके लिए contacts_* और contact_properties_*, जिन lists को आप भेजते हैं उनके लिए audiences_*, और consent grants और opt-outs के लिए preferences_*।
• Realtime प्रोविज़न करें: realtime_apps_* और realtime_apps_keys_* वे apps और keys बनाते हैं जिनसे Realtime clients कनेक्ट करते हैं।
• किसी को खोजें: lookup_phone_number और lookup_email बताते हैं कि भेजने से पहले Bird किसी address के बारे में क्या जानता है।
• कॉन्फ़िगरेशन जाँचें: webhooks_list, workspace_get, और whoami (साइन-इन किया हुआ उपयोगकर्ता: id, email, name)।

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?

अगले कदम

• AI onboarding: इस पेज का quickstart संस्करण, साथ ही machine-readable docs corpus।
• Agent skills: bird-ai marketplace प्लगइन, skills और यह MCP सर्वर, एक चरण में इंस्टॉल।
• CLI for agents: MCP के बिना shell-capable agents से Bird चलाएँ: JSON output, semantic exit codes, OAuth login।
• Authentication: API keys, regions, और requests कैसे authorize होती हैं।