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"
    }
  }
}

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

Factory Droid

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

Agent Plugins

Jeder andere Host

Was bei der Anmeldung passiert

Wie der Handshake funktioniert

1. Der Client stellt eine unauthentifizierte 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 Consent-Screen von Bird.
4. Der Client tauscht das Ergebnis gegen ein Access-Token (PKCE; wird automatisch erneuert) und die Bird-Tools erscheinen.

Lokal: über stdio mit der 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

Wie sich der lokale Server authentifiziert

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 Event-Log sind separate Tool-Calls.
• SMS senden und inspizieren: sms_send, sms_send_batch, sms_get, sms_list und sms_list_events, analog zum E-Mail-Muster. 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 bieten eine vollständige Authoring-Oberfläche unter whatsapp_templates_*, einschließlich Inhalten pro Version und pro Sprache.
• Sprachanrufe inspizieren: voice_get und voice_list lesen Anrufe zurück, mit Statistiken pro Land und pro Antwortcode unter voice_stats_*. voice_session_credentials_create erstellt die Workspace-Zugangskennung, mit der sich ein SIP oder Softphone-Client authentifiziert. Kein MCP-Tool tätigt einen Anruf: Das geschieht über bird voice tools test-call auf der CLI.
• Empfänger verifizieren: verify_verifications_create sendet einen Einmal-Bestätigungscode, verify_verifications_check prüft, was der Empfänger eingegeben hat, und verify_verifications_next_channel weicht auf einen anderen Kanal aus.

Einen Kanal zum Senden vorbereiten

• Versanddomains einrichten: email_domains_create fügt eine Versanddomain hinzu und gibt die zu veröffentlichenden DNS-Einträge zurück; email_domains_verify prüft sie erneut; plus email_domains_list und email_domains_get.
• SMS-Absender beanspruchen und registrieren: sms_senders_create beansprucht einen Absender, sms_senders_requirements zeigt, was ein Land von ihm verlangt, und sms_senders_registrations_create registriert ihn. US-A2P-Traffic läuft über die sms_10dlc_*-Brand-, Campaign- und Submission-Tools.
• Nummern bereitstellen: numbers_available_list sucht, numbers_orders_create kauft und numbers_release gibt zurück. whatsapp_numbers_precheck prüft, 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 leben unter email_templates_versions_*, wo email_templates_versions_submit einen Entwurf einfriert und ihn zur Version macht, die beim Versand ausgeliefert wird, und email_templates_versions_languages_* den sprachspezifischen Inhalt eines Entwurfs bearbeitet. Nichts, was ein Agent schreibt, erreicht einen Empfänger, bevor er es absendet.
• Suppressions verwalten: email_suppressions_list, email_suppressions_check (kann an diese Adresse sicher gesendet werden?), email_suppressions_add und email_suppressions_remove (als destruktiv annotiert, weil das Entfernen einer Suppression 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 IP in einen Pool verschieben) und email_dedicated_ips_delete; plus 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 Ihren Versand 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 Keys, mit denen sich Realtime-Clients verbinden.
• Jemanden nachschlagen: lookup_phone_number und lookup_email melden, was Bird über eine Adresse weiß, bevor Sie an sie 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 die CLI?

Nächste Schritte

• AI-Onboarding: die Schnellstart-Version dieser Seite plus das maschinenlesbare Docs-Corpus.
• Agent Skills: das bird-ai-Marketplace-Plugin, Skills plus dieser MCP-Server, in einem Schritt installiert.
• CLI für Agents: Bird aus shell-fähigen Agents steuern, ohne MCP: JSON-Output, semantische Exit-Codes, OAuth-Login.
• Authentifizierung: API-Keys, Regionen und wie Anfragen autorisiert werden.