MCP-Server

1. Gehostet (mcp.bird.com): eine URL und eine Browser-Anmeldung. Nichts zu installieren, kein CLI, kein API-Key. Das ist der empfohlene Weg.
2. Lokal über stdio (bird mcp): Tools, die auf Ihrem Rechner innerhalb der bird CLI laufen – für Shell-Agents oder den Eigenbetrieb.

• auth_signup, auth_verify_email und auth_create_org: Diese Tools erstellen Ihre erste Zugangskennung, bevor Sie sich beim gehosteten Server authentifizieren können.
• compliance_attachments_upload: Dieses Tool liest einen lokalen Dateipfad. Auf dem gehosteten Server würde dieser Pfad auf das Dateisystem des Servers verweisen und könnte die falsche Datei hochladen.

Gehostet: Verbindung zu mcp.bird.com

Endpoint wählen

1. Server hinzufügen: Geben Sie dem Client Ihre gewählte Endpoint-URL.
2. Authentifizieren: Melden Sie sich über Ihren Browser an, damit der Client ein Token hält, das in Ihrem Namen agiert.

Dynamische Tool-Erkennung verwenden

• search findet Tools anhand von Name oder Beschreibungs-Stichwörtern. Jeder Treffer enthält Name, Beschreibung, Input-Schema und Annotationen, die angeben, ob das Tool Daten liest oder ändert.
• execute ruft ein ausgewähltes Tool mit seinen Argumenten auf. Es kann Daten lesen, Nachrichten senden, Datensätze ändern oder löschen – je nach gewähltem Tool.

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

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

Einen Client verbinden

Claude Code

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

1. Führen Sie /mcp aus.
2. Wählen Sie bird und drücken Sie Enter.
3. Wählen Sie Authenticate. Ihr Browser öffnet den Consent-Screen von Bird; bestätigen Sie dort.

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

Jeder andere Host

Was bei der Anmeldung passiert

So funktioniert der Handshake

1. Der Client sendet eine nicht authentifizierte Anfrage und erhält 401 mit einem WWW-Authenticate-Header zurück, der auf die RFC 9728-Protected-Resource-Metadaten von Bird verweist (/.well-known/oauth-protected-resource).
2. Von dort entdeckt er den Authorization-Server und registriert sich dynamisch (RFC 7591). Die dynamische Registrierung macht eine vorab geteilte Client-ID oder manuelle Konfiguration überflüssig.
3. Ihr Browser öffnet den Zustimmungsbildschirm von Bird.
4. Der Client tauscht das Ergebnis gegen einen Access-Token (PKCE; wird automatisch erneuert) und die Bird-Tools erscheinen.

Lokal: per stdio mit dem CLI ausführen

Cursor

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

VS Code

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

Claude Code

claude mcp add bird -- bird mcp

So authentifiziert sich der lokale Server

Was die Tools abdecken

Messaging

• E-Mail senden und inspizieren: email_send, email_send_batch, email_list und email_get, das die Nachricht mit ihrem aggregierten Zustellstatus zurückgibt. Zustellstatus pro Empfänger und das Ereignisprotokoll sind separate Tool-Aufrufe.
• SMS senden und inspizieren: sms_send, sms_send_batch, sms_get, sms_list und sms_list_events, analog zum E-Mail-Schema. sms_templates_list und sms_templates_get lesen den Template-Katalog.
• WhatsApp senden und inspizieren: whatsapp_send, whatsapp_get, whatsapp_list, whatsapp_list_events und whatsapp_media. Templates sind eine vollständige Autorenoberfläche unter whatsapp_templates_*, einschließlich Inhalten pro Version und pro Sprache.
• Sprachanruf-Legs prüfen: voice_legs_get und voice_legs_list lesen Anruf-Legs aus. Statistiken nach Land und Antwortcode stehen unter voice_stats_* zur Verfügung. voice_session_credentials_create erstellt die Workspace-Zugangsdaten, mit denen sich ein SIP- oder Softphone-Client authentifiziert.
• Empfänger verifizieren: verify_verifications_create sendet einen Einmal-Bestätigungscode, verify_verifications_check validiert die Eingabe des Empfängers, und verify_verifications_next_channel wechselt auf einen anderen Kanal.
• Einen Sprachanruf erstellen (Vorschau): voice_calls_create bereitet einen ausgehenden Anruf mit der aktiven Veröffentlichung einer aktivierten, nicht archivierten Sequenz vor. Eine Person prüft die Anfrage im Browser und führt sie aus; die Vorbereitung löst keinen Anruf aus. Berechtigungen und Hinweise zu Wiederholungsversuchen finden Sie unter Einen Sprachanruf erstellen. Der lokale bird mcp-Server erfordert eine CLI-Version, die dieses Tool enthält.

Einen Kanal zum Senden vorbereiten

• Sende-Domains einrichten: email_domains_create fügt eine Sende-Domain hinzu und gibt die zu veröffentlichenden DNS-Einträge zurück; email_domains_verify prüft sie erneut; dazu email_domains_list und email_domains_get.
• SMS-Absender beanspruchen und registrieren: sms_senders_create beansprucht einen Absender, sms_senders_requirements meldet, was ein Land von ihm verlangt, und sms_senders_registrations_create registriert ihn. US-A2P-Traffic läuft über die sms_10dlc_*-Tools für Brand, Campaign und Submission.
• Nummern bereitstellen: numbers_available_list sucht, numbers_orders_create kauft und numbers_release gibt zurück. whatsapp_numbers_precheck meldet, ob WhatsApp eine Nummer akzeptiert, bevor Sie sie bestellen.
• Prüfen, ob das Konto überhaupt senden kann: Die trust_*-Tools melden die Organisationsanforderungen, die den Kauf einer Nummer oder die Registrierung eines Absenders voraussetzen.

E-Mail-Zustellbarkeit

• E-Mail-Templates erstellen: email_templates_create, email_templates_list, email_templates_get, email_templates_update, email_templates_duplicate und email_templates_preview (einen Entwurf mit Beispielwerten rendern, ohne zu senden). Versionen befinden sich unter email_templates_versions_*, wo email_templates_versions_submit einen Entwurf einfriert und ihn zur Version macht, die Sendungen ausliefern, und email_templates_versions_languages_* den sprachspezifischen Inhalt eines Entwurfs bearbeitet. Nichts, was ein Agent schreibt, erreicht einen Empfänger, bis er es absendet.
• Unterdrückungen verwalten: email_suppressions_list, email_suppressions_check (ist diese Adresse sicher zum Senden?), email_suppressions_add und email_suppressions_remove (als destruktiv annotiert, weil das Entfernen einer Unterdrückung ohne Grund die Absender-Reputation schädigt).
• Dedizierte IPs und Pools verwalten: email_dedicated_ips_create, email_dedicated_ips_list, email_dedicated_ips_get, email_dedicated_ips_assign (eine in einen Pool verschieben) und email_dedicated_ips_delete; dazu email_ip_pools_create, email_ip_pools_list, email_ip_pools_get, email_ip_pools_update und email_ip_pools_delete für die Pools, über die Sie Sendungen routen.

Zielgruppe und Konfiguration

• Kontakte und Zielgruppen verwalten: contacts_* und contact_properties_* für die Personen, an die Sie senden, audiences_* für die Listen, an die Sie senden, und preferences_* für Einwilligungen und Opt-outs.
• Realtime bereitstellen: realtime_apps_* und realtime_apps_keys_* erstellen die Apps und Schlüssel, mit denen sich die Realtime-Clients verbinden.
• Jemanden nachschlagen: lookup_phone_number und lookup_email melden, was Bird über eine Adresse weiß, bevor Sie dorthin senden.
• Konfiguration inspizieren: webhooks_list, workspace_get und whoami (der angemeldete Benutzer: ID, E-Mail, 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 oder das CLI?

Nächste Schritte

• AI onboarding: die Schnellstartversion dieser Seite plus das maschinenlesbare Docs-Korpus.
• Agent skills: das bird-ai-Marketplace-Plugin, Skills plus dieser MCP-Server, in einem Schritt installiert.
• CLI für Agents: Bird von shell-fähigen Agents aus steuern, ohne MCP: JSON-Ausgabe, semantische Exit-Codes, OAuth-Login.
• Authentication: API-Schlüssel, Regionen und wie Anfragen autorisiert werden.