Server MCP

1. Hosted (mcp.bird.com): sebuah URL dan sign-in melalui browser. Tidak perlu instalasi, tanpa CLI, tanpa kunci API. Ini adalah jalur yang direkomendasikan.
2. Local over stdio (bird mcp): tool yang berjalan di mesin Anda di dalam bird CLI, untuk agen shell atau menjalankannya sendiri.

• auth_signup, auth_verify_email, dan auth_create_org: tool ini membuat kredensial pertama Anda, sebelum Anda dapat melakukan autentikasi ke server hosted.
• compliance_attachments_upload: tool ini membaca path file lokal. Di server hosted, path tersebut akan merujuk ke filesystem server dan bisa mengunggah file yang salah.

Hosted: hubungkan ke mcp.bird.com

Pilih endpoint

1. Tambahkan server: berikan URL endpoint pilihan Anda ke klien.
2. Autentikasi: sign in melalui browser agar klien menyimpan token yang bertindak sebagai Anda.

Gunakan penemuan tool dinamis

• search mencari tool berdasarkan nama atau kata kunci deskripsi. Setiap hasil mencakup nama, deskripsi, input schema, dan anotasi yang menjelaskan apakah tool tersebut membaca atau mengubah data.
• execute memanggil satu tool yang dipilih beserta argumennya. Tool ini dapat membaca data, mengirim pesan, mengubah record, atau menghapusnya, tergantung tool yang dipilih.

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

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

Hubungkan klien

Claude Code

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

1. Jalankan /mcp.
2. Pilih bird dan tekan Enter.
3. Pilih Authenticate. Browser Anda membuka layar persetujuan Bird; setujui di sana.

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 lainnya

Yang terjadi saat Anda sign in

Cara kerja handshake

1. Klien membuat permintaan tanpa autentikasi dan mendapat respons 401 dengan header WWW-Authenticate yang mengarah ke metadata protected-resource RFC 9728 Bird (/.well-known/oauth-protected-resource).
2. Dari sana klien menemukan authorization server, lalu mendaftarkan dirinya secara dinamis (RFC 7591). Registrasi dinamis menghilangkan kebutuhan akan client ID pra-berbagi atau konfigurasi manual.
3. Browser Anda membuka layar persetujuan Bird.
4. Klien menukar hasilnya dengan access token (PKCE; diperbarui secara otomatis) dan tool Bird muncul.

Lokal: jalankan melalui stdio dengan CLI

Cursor

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

VS Code

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

Claude Code

claude mcp add bird -- bird mcp

Cara autentikasi server lokal

Cakupan tool

Messaging

• Kirim dan inspeksi email: email_send, email_send_batch, email_list, dan email_get, yang mengembalikan pesan beserta status pengiriman agregatnya. Status pengiriman per penerima dan log event adalah panggilan tool terpisah.
• Kirim dan inspeksi SMS: sms_send, sms_send_batch, sms_get, sms_list, dan sms_list_events, mengikuti pola email. sms_templates_list dan sms_templates_get membaca katalog template.
• Kirim dan inspeksi WhatsApp: whatsapp_send, whatsapp_get, whatsapp_list, whatsapp_list_events, dan whatsapp_media. Template adalah permukaan authoring lengkap di bawah whatsapp_templates_*, termasuk konten per versi dan per bahasa.
• Periksa leg panggilan suara: voice_legs_get dan voice_legs_list membaca leg panggilan, dengan statistik per negara dan per kode respons di voice_stats_*. voice_session_credentials_create membuat kredensial workspace yang digunakan klien SIP atau softphone untuk autentikasi.
• Verifikasi penerima: verify_verifications_create mengirim kode verifikasi satu kali, verify_verifications_check memvalidasi apa yang dikirimkan penerima, dan verify_verifications_next_channel beralih ke kanal lain.
• Buat panggilan suara (pratinjau): voice_calls_create menyiapkan panggilan keluar menggunakan publikasi aktif dari sequence yang diaktifkan dan tidak diarsipkan. Seseorang meninjau dan menjalankan permintaan di browser; menyiapkannya tidak melakukan panggilan. Lihat Buat panggilan suara untuk izin dan petunjuk percobaan ulang. Server lokal bird mcp memerlukan versi CLI yang menyertakan tool ini.

Menyiapkan kanal untuk pengiriman

• Siapkan domain pengirim: email_domains_create menambahkan domain pengirim dan mengembalikan record DNS yang perlu dipublikasikan; email_domains_verify memeriksanya ulang; ditambah email_domains_list dan email_domains_get.
• Klaim dan daftarkan pengirim SMS: sms_senders_create mengklaim pengirim, sms_senders_requirements melaporkan apa yang diminta suatu negara, dan sms_senders_registrations_create mendaftarkannya. Lalu lintas A2P AS berjalan melalui tool brand, campaign, dan submission sms_10dlc_*.
• Provisikan nomor: numbers_available_list mencari, numbers_orders_create membeli, dan numbers_release mengembalikan. whatsapp_numbers_precheck melaporkan apakah WhatsApp akan menerima nomor sebelum Anda memesannya.
• Periksa apakah akun dapat mengirim: tool trust_* melaporkan persyaratan organisasi yang menentukan apakah Anda dapat membeli nomor atau mendaftarkan pengirim.

Deliverabilitas email

• Buat template email: email_templates_create, email_templates_list, email_templates_get, email_templates_update, email_templates_duplicate, dan email_templates_preview (render draf dengan nilai sampel tanpa mengirim). Versi berada di bawah email_templates_versions_*, di mana email_templates_versions_submit membekukan draf dan menjadikannya versi yang disajikan saat pengiriman, dan email_templates_versions_languages_* mengedit konten per bahasa dari draf. Tidak ada yang ditulis agen sampai ke penerima hingga dikirimkan.
• Kelola supresi: email_suppressions_list, email_suppressions_check (apakah alamat ini aman untuk dikirim?), email_suppressions_add, dan email_suppressions_remove (dianotasi destruktif, karena menghapus supresi tanpa alasan merusak reputasi pengirim).
• Kelola IP dan pool khusus: email_dedicated_ips_create, email_dedicated_ips_list, email_dedicated_ips_get, email_dedicated_ips_assign (pindahkan ke pool), dan email_dedicated_ips_delete; ditambah email_ip_pools_create, email_ip_pools_list, email_ip_pools_get, email_ip_pools_update, dan email_ip_pools_delete untuk pool yang Anda gunakan untuk merutekan pengiriman.

Audiens dan konfigurasi

• Kelola kontak dan audiens: contacts_* dan contact_properties_* untuk orang yang Anda kirimi, audiences_* untuk daftar yang Anda kirimi, dan preferences_* untuk pemberian persetujuan dan opt-out.
• Provisikan Realtime: realtime_apps_* dan realtime_apps_keys_* membuat aplikasi dan kunci yang digunakan klien Realtime untuk terhubung.
• Cari informasi seseorang: lookup_phone_number dan lookup_email melaporkan apa yang diketahui Bird tentang suatu alamat sebelum Anda mengirim ke sana.
• Inspeksi konfigurasi: webhooks_list, workspace_get, dan whoami (pengguna yang sign in: id, email, nama).

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

MCP atau CLI?

Langkah selanjutnya

• AI onboarding: versi quickstart dari halaman ini, ditambah korpus dokumentasi yang dapat dibaca mesin.
• Agent skills: plugin marketplace bird-ai, skills ditambah server MCP ini, diinstal dalam satu langkah.
• CLI untuk agen: jalankan Bird dari agen yang mendukung shell tanpa MCP: output JSON, exit code semantik, login OAuth.
• Autentikasi: kunci API, region, dan cara otorisasi permintaan.