Server MCP

1. Hosted (mcp.bird.com): un URL e un accesso dal browser. Niente da installare, nessun CLI, nessuna chiave API. È il percorso consigliato.
2. Locale via stdio (bird mcp): tool in esecuzione sulla tua macchina all'interno della bird CLI, per agent shell o per eseguirlo in autonomia.

• auth_signup, auth_verify_email e auth_create_org: questi tool creano la tua prima credenziale, prima che tu possa autenticarti verso il server hosted.
• compliance_attachments_upload: questo tool legge un percorso file locale. Sul server hosted, quel percorso farebbe riferimento al filesystem del server e potrebbe caricare il file sbagliato.

Hosted: connettersi a mcp.bird.com

Scegliere un endpoint

1. Aggiungi il server: fornisci al client l'URL dell'endpoint che hai scelto.
2. Autenticati: accedi dal browser in modo che il client possieda un token che agisce come te.

Usare la scoperta dinamica dei tool

• search trova tool per nome o parole chiave nella descrizione. Ogni corrispondenza include nome, descrizione, schema di input e annotazioni che indicano se il tool legge o modifica dati.
• execute chiama un tool selezionato con i suoi argomenti. Può leggere dati, inviare messaggi, modificare record o eliminarli, a seconda del tool selezionato.

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

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

Collegare un client

Claude Code

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

1. Esegui /mcp.
2. Seleziona bird e premi Invio.
3. Scegli Authenticate. Il browser apre la schermata di consenso di Bird; approvala lì.

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

Qualsiasi altro host

Cosa succede quando accedi

Come funziona l'handshake

1. Il client effettua una richiesta non autenticata e riceve 401 con un header WWW-Authenticate che punta ai metadati protected-resource RFC 9728 di Bird (/.well-known/oauth-protected-resource).
2. Da lì scopre il server di autorizzazione, poi si registra dinamicamente (RFC 7591). La registrazione dinamica elimina la necessità di un client ID pre-condiviso o di una configurazione manuale.
3. Il browser si apre sulla schermata di consenso di Bird.
4. Il client scambia il risultato per un access token (PKCE; rinnovato automaticamente) e compaiono i tool Bird.

Locale: eseguirlo via stdio con il CLI

Cursor

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

VS Code

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

Claude Code

claude mcp add bird -- bird mcp

Come si autentica il server locale

Cosa coprono i tool

Messaggistica

• Inviare e ispezionare email: email_send, email_send_batch, email_list e email_get, che restituisce il messaggio con il suo stato di consegna aggregato. Gli stati di consegna per singolo destinatario e il log degli eventi sono chiamate a tool separate.
• Inviare e ispezionare SMS: sms_send, sms_send_batch, sms_get, sms_list e sms_list_events, con la stessa struttura dell'email. sms_templates_list e sms_templates_get leggono il catalogo dei template.
• Inviare e ispezionare WhatsApp: whatsapp_send, whatsapp_get, whatsapp_list, whatsapp_list_events e whatsapp_media. I template sono una superficie di authoring completa sotto whatsapp_templates_*, con contenuto per versione e per lingua.
• Esaminare i segmenti delle chiamate vocali: voice_legs_get e voice_legs_list leggono i segmenti delle chiamate, con statistiche per paese e per codice di risposta in voice_stats_*. voice_session_credentials_create crea la credenziale del workspace usata da un client SIP o softphone per autenticarsi.
• Verificare un destinatario: verify_verifications_create invia un codice di verifica monouso, verify_verifications_check valida ciò che il destinatario ha inviato e verify_verifications_next_channel riprovare su un altro canale.
• Creare una chiamata vocale (anteprima): voice_calls_create prepara una chiamata in uscita con la pubblicazione attiva di una sequenza abilitata e non archiviata. Una persona esamina ed esegue la richiesta nel browser; prepararla non avvia la chiamata. Consulta Creare una chiamata vocale per i permessi e le istruzioni sui nuovi tentativi. Il server locale bird mcp richiede una versione della CLI che includa questo strumento.

Preparare un canale per l'invio

• Configurare i domini di invio: email_domains_create aggiunge un dominio di invio e restituisce i record DNS da pubblicare; email_domains_verify li riverifica; più email_domains_list e email_domains_get.
• Rivendicare e registrare mittenti SMS: sms_senders_create rivendica un mittente, sms_senders_requirements riporta ciò che un paese richiede e sms_senders_registrations_create lo registra. Il traffico A2P negli USA passa attraverso i tool sms_10dlc_* per brand, campagna e submission.
• Provisioning numeri: numbers_available_list cerca, numbers_orders_create acquista e numbers_release restituisce. whatsapp_numbers_precheck segnala se WhatsApp accetterà un numero prima che tu lo ordini.
• Verificare che l'account possa inviare: i tool trust_* riportano i requisiti dell'organizzazione che condizionano l'acquisto di un numero o la registrazione di un mittente.

Deliverability email

• Creare template email: email_templates_create, email_templates_list, email_templates_get, email_templates_update, email_templates_duplicate e email_templates_preview (renderizza una bozza con valori di esempio senza inviarla). Le versioni si trovano sotto email_templates_versions_*, dove email_templates_versions_submit congela una bozza e la rende la versione servita dagli invii, e email_templates_versions_languages_* modifica il contenuto per lingua di una bozza. Nulla di ciò che un agente scrive raggiunge un destinatario finché non lo invia.
• Gestire le soppressioni: email_suppressions_list, email_suppressions_check (è sicuro inviare a questo indirizzo?), email_suppressions_add e email_suppressions_remove (annotato come distruttivo, perché rimuovere una soppressione senza motivo danneggia la reputazione del mittente).
• Gestire IP dedicati e pool: email_dedicated_ips_create, email_dedicated_ips_list, email_dedicated_ips_get, email_dedicated_ips_assign (spostarne uno in un pool) e email_dedicated_ips_delete; più email_ip_pools_create, email_ip_pools_list, email_ip_pools_get, email_ip_pools_update e email_ip_pools_delete per i pool attraverso cui instradi gli invii.

Audience e configurazione

• Gestire contatti e audience: contacts_* e contact_properties_* per le persone a cui invii, audiences_* per le liste a cui invii e preferences_* per i consensi e gli opt-out.
• Provisioning Realtime: realtime_apps_* e realtime_apps_keys_* creano le app e le chiavi con cui i client Realtime si connettono.
• Cercare qualcuno: lookup_phone_number e lookup_email riportano ciò che Bird sa su un indirizzo prima che tu invii.
• Ispezionare la configurazione: webhooks_list, workspace_get e whoami (l'utente autenticato: id, email, nome).

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

MCP o il CLI?

Prossimi passi

• AI onboarding: la versione quickstart di questa pagina, più il corpus di documentazione leggibile dalle macchine.
• Agent skills: il plugin bird-ai del marketplace, skills più questo server MCP, installati in un solo passaggio.
• CLI per agenti: usa Bird da agenti con accesso alla shell senza MCP: output JSON, exit code semantici, login OAuth.
• Authentication: chiavi API, regioni e come vengono autorizzate le richieste.