MCP server

1. Gehostet (mcp.bird.com): eine URL und eine Browser-Anmeldung. Keine Installation, keine CLI, kein API-Schlüssel. Dies ist der empfohlene Weg.
2. Lokal über stdio (bird mcp): Tools laufen auf Ihrem Rechner innerhalb der bird CLI, für Shell-Agenten oder eigenständigen Betrieb.

• auth_signup, auth_verify_email und auth_create_org: Diese Tools erstellen Ihre ersten Zugangsdaten, 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

Endpunkt auswählen

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

Dynamische Tool-Suche verwenden

• search findet Tools anhand von Namen oder Schlüsselwörtern in der Beschreibung. Jeder Treffer enthält den Namen, die Beschreibung, das Eingabeschema und Anmerkungen dazu, ob das Tool Daten liest oder ändert.
• execute ruft ein ausgewähltes Tool mit seinen Argumenten auf. Je nach gewähltem Tool kann es Daten lesen, Nachrichten senden, Datensätze ändern oder löschen.

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

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

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

Lokal: Ausführung über stdio mit der CLI

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 Zustellungsstatus zurückgibt. Pro-Empfänger-Zustellungsstatus 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-Muster. sms_templates_list und sms_templates_get lesen den Vorlagenkatalog.
• WhatsApp senden und inspizieren: whatsapp_send, whatsapp_get, whatsapp_list, whatsapp_list_events und whatsapp_media. Vorlagen sind eine vollständige Autorenoberflä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-Anmeldedaten, mit denen sich ein SIP- oder Softphone-Client authentifiziert. Kein MCP-Tool tätigt einen Anruf: Das ist bird voice tools test-call in der CLI.
• Empfänger verifizieren: verify_verifications_create sendet einen Einmalcode, verify_verifications_check validiert, was der Empfänger eingegeben hat, und verify_verifications_next_channel fällt auf einen anderen Kanal zurück.

Einen Kanal versandbereit machen

• 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 meldet, was ein Land davon verlangt, und sms_senders_registrations_create registriert ihn. US-A2P-Traffic läuft über die sms_10dlc_*-Tools für Marke, Kampagne und Einreichung.
• 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-Vorlagen 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_*, wobei email_templates_versions_submit einen Entwurf einfriert und ihn zur Version macht, die beim Senden verwendet wird, und email_templates_versions_languages_* den sprachspezifischen Inhalt eines Entwurfs bearbeitet. Nichts, was ein Agent schreibt, erreicht einen Empfänger, bis es eingereicht wird.
• 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, da das Entfernen einer Unterdrückung ohne Grund die Absender-Reputation beschä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; 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 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 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).

Rufe whoami auf, um meine E-Mail zu finden, sende mir dann eine Test-E-Mail von onboarding@messagebird.dev und sag mir, wenn sie zugestellt ist.

MCP oder die CLI?

Nächste Schritte

• AI-Onboarding: die Schnellstartversion dieser Seite, plus das maschinenlesbare Dokumentationskorpus.
• Agent Skills: das bird-ai Marketplace-Plugin, Skills plus dieser MCP server, in einem Schritt installiert.
• CLI für Agenten: Bird über Shell-fähige Agenten ohne MCP steuern: JSON-Ausgabe, semantische Exit-Codes, OAuth-Login.
• Authentifizierung: API-Schlüssel, Regionen und wie Anfragen autorisiert werden.