MCP-server

1. Gehost (mcp.bird.com): een URL en een browseraanmelding. Niets te installeren, geen CLI, geen API-key. Dit is het aanbevolen pad.
2. Lokaal over stdio (bird mcp): tools die op je machine draaien in de bird CLI, voor shell-agents of om het zelf te draaien.

• auth_signup, auth_verify_email en auth_create_org: deze tools maken je eerste credential aan, voordat je je kunt authenticeren bij de gehoste server.
• compliance_attachments_upload: deze tool leest een lokaal bestandspad. Op de gehoste server zou dat pad verwijzen naar het bestandssysteem van de server en zou het verkeerde bestand geüpload kunnen worden.

Gehost: verbinden met mcp.bird.com

Kies een endpoint

1. Voeg de server toe: geef de client de endpoint-URL die je gekozen hebt.
2. Authenticeer: meld je aan via je browser zodat de client een token heeft dat als jou handelt.

Gebruik dynamische tooldetectie

• search vindt tools op naam of beschrijvingstrefwoorden. Elke match bevat de naam, beschrijving, het inputschema en annotaties die aangeven of de tool gegevens leest of wijzigt.
• execute roept één geselecteerde tool aan met de bijbehorende argumenten. Het kan gegevens lezen, berichten versturen, records wijzigen of verwijderen, afhankelijk van de geselecteerde tool.

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

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

Een client verbinden

Claude Code

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

1. Voer /mcp uit.
2. Selecteer bird en druk op Enter.
3. Kies Authenticate. Je browser opent het toestemmingsscherm van Bird; keur het daar goed.

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

Elke andere host

Wat er gebeurt wanneer je je aanmeldt

Hoe de handshake werkt

1. De client doet een niet-geauthenticeerd verzoek en krijgt 401 terug met een WWW-Authenticate-header die verwijst naar de RFC 9728 protected-resource metadata (/.well-known/oauth-protected-resource) van Bird.
2. Van daaruit ontdekt hij de autorisatieserver en registreert zichzelf dynamisch (RFC 7591). Dynamische registratie maakt een vooraf gedeeld client-ID of handmatige configuratie overbodig.
3. Je browser opent het toestemmingsscherm van Bird.
4. De client wisselt het resultaat in voor een access token (PKCE; automatisch vernieuwd) en de Bird-tools verschijnen.

Lokaal: draai het over stdio met de CLI

Cursor

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

VS Code

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

Claude Code

claude mcp add bird -- bird mcp

Hoe de lokale server authenticeert

Wat de tools dekken

Berichten

• E-mail verzenden en inspecteren: email_send, email_send_batch, email_list en email_get, die het bericht retourneert met de totale bezorgstatus. Bezorgstatussen per ontvanger en het eventlog zijn aparte tool-aanroepen.
• SMS verzenden en inspecteren: sms_send, sms_send_batch, sms_get, sms_list en sms_list_events, naar het e-mailmodel. sms_templates_list en sms_templates_get lezen de templatecatalogus.
• WhatsApp verzenden en inspecteren: whatsapp_send, whatsapp_get, whatsapp_list, whatsapp_list_events en whatsapp_media. Templates vormen een volledig auteuroppervlak onder whatsapp_templates_*, inclusief inhoud per versie en per taal.
• Gesprekslegs inspecteren: voice_legs_get en voice_legs_list lezen gesprekslegs, met statistieken per land en per antwoordcode onder voice_stats_*. voice_session_credentials_create maakt de workspace-inloggegevens waarmee een SIP- of softphoneclient zich authenticeert.
• Een ontvanger verifiëren: verify_verifications_create verstuurt een eenmalige verificatiecode, verify_verifications_check valideert wat de ontvanger heeft ingediend, en verify_verifications_next_channel valt terug op een ander kanaal.
• Een spraakoproep maken (preview): voice_calls_create bereidt een uitgaande oproep voor met de actieve publicatie van een ingeschakelde, niet-gearchiveerde sequence. Een persoon controleert de aanvraag in de browser en voert deze uit; het voorbereiden plaatst de oproep niet. Zie Een spraakoproep maken voor machtigingen en instructies voor nieuwe pogingen. De lokale bird mcp-server vereist een CLI-versie die deze tool bevat.

Een kanaal klaarstomen voor verzending

• Verzenddomeinen instellen: email_domains_create voegt een verzenddomein toe en retourneert de DNS-records die je moet publiceren; email_domains_verify controleert ze opnieuw; plus email_domains_list en email_domains_get.
• SMS-afzenders claimen en registreren: sms_senders_create claimt een afzender, sms_senders_requirements rapporteert wat een land ervan vereist, en sms_senders_registrations_create registreert hem. Amerikaans A2P-verkeer loopt via de sms_10dlc_*-tools voor merk, campagne en indiening.
• Nummers inrichten: numbers_available_list zoekt, numbers_orders_create koopt en numbers_release geeft terug. whatsapp_numbers_precheck rapporteert of WhatsApp een nummer accepteert voordat je het bestelt.
• Controleren of het account überhaupt kan verzenden: de trust_*-tools rapporteren de organisatievereisten die het kopen van een nummer of het registreren van een afzender blokkeren.

E-mailafleverbaarheid

• E-mailtemplates schrijven: email_templates_create, email_templates_list, email_templates_get, email_templates_update, email_templates_duplicate en email_templates_preview (een concept renderen met voorbeeldwaarden zonder te verzenden). Versies staan onder email_templates_versions_*, waar email_templates_versions_submit een concept bevriest en er de versie van maakt die bij verzending wordt geserveerd, en email_templates_versions_languages_* de inhoud per taal van een concept bewerkt. Niets wat een agent schrijft bereikt een ontvanger totdat het wordt ingediend.
• Onderdrukkingen beheren: email_suppressions_list, email_suppressions_check (is het veilig om naar dit adres te verzenden?), email_suppressions_add en email_suppressions_remove (geannoteerd als destructief, omdat het verwijderen van een onderdrukking zonder reden de afzenderreputatie schaadt).
• Dedicated IP's en pools beheren: email_dedicated_ips_create, email_dedicated_ips_list, email_dedicated_ips_get, email_dedicated_ips_assign (verplaats er een naar een pool) en email_dedicated_ips_delete; plus email_ip_pools_create, email_ip_pools_list, email_ip_pools_get, email_ip_pools_update en email_ip_pools_delete voor de pools waar je verzendingen doorheen routeert.

Doelgroep en configuratie

• Contacten en doelgroepen beheren: contacts_* en contact_properties_* voor de personen naar wie je verzendt, audiences_* voor de lijsten waar je naar verzendt, en preferences_* voor toestemmingen en opt-outs.
• Realtime inrichten: realtime_apps_* en realtime_apps_keys_* maken de apps en sleutels aan waarmee de Realtime-clients verbinden.
• Iemand opzoeken: lookup_phone_number en lookup_email rapporteren wat Bird weet over een adres voordat je ernaartoe verzendt.
• Configuratie inspecteren: webhooks_list, workspace_get en whoami (de aangemelde gebruiker: id, e-mail, naam).

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

MCP of de CLI?

Volgende stappen

• AI onboarding: de quickstartversie van deze pagina, plus het machineleesbare documentatiecorpus.
• Agent skills: de bird-ai marketplace-plugin, skills plus deze MCP-server, geïnstalleerd in één stap.
• CLI voor agents: stuur Bird aan vanuit shell-capable agents zonder MCP: JSON-output, semantische exitcodes, OAuth-login.
• Authenticatie: API-sleutels, regio's en hoe verzoeken worden geautoriseerd.