Servidor MCP

1. Hospedado (mcp.bird.com): uma URL e login pelo navegador. Nada para instalar, sem CLI, sem chave API. Este é o caminho recomendado.
2. Local via stdio (bird mcp): ferramentas rodando na sua máquina dentro do bird CLI, para agentes de shell ou execução por conta própria.

• auth_signup, auth_verify_email e auth_create_org: essas ferramentas criam sua primeira credencial, antes de você poder se autenticar no servidor hospedado.
• compliance_attachments_upload: essa ferramenta lê um caminho de arquivo local. No servidor hospedado, esse caminho se referiria ao sistema de arquivos do servidor e poderia enviar o arquivo errado.

Hospedado: conecte-se ao mcp.bird.com

Escolha um endpoint

1. Adicione o servidor: forneça ao cliente a URL do endpoint escolhido.
2. Autentique-se: faça login pelo navegador para que o cliente tenha um token que age como você.

Use a descoberta dinâmica de ferramentas

• search encontra ferramentas por nome ou palavras-chave da descrição. Cada resultado inclui nome, descrição, schema de entrada e anotações indicando se a ferramenta lê ou altera dados.
• execute chama uma ferramenta selecionada com seus argumentos. Pode ler dados, enviar mensagens, alterar registros ou excluí-los, dependendo da ferramenta selecionada.

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

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

Conecte um cliente

Claude Code

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

1. Execute /mcp.
2. Selecione bird e pressione Enter.
3. Escolha Authenticate. Seu navegador abre a tela de consentimento do Bird; aprove 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

Qualquer outro host

O que acontece quando você faz login

Como o handshake funciona

1. O cliente faz uma solicitação não autenticada e recebe 401 com um cabeçalho WWW-Authenticate apontando para os metadados de recurso protegido RFC 9728 de Bird (/.well-known/oauth-protected-resource).
2. A partir daí, ele descobre o servidor de autorização e então se registra dinamicamente (RFC 7591). O registro dinâmico elimina a necessidade de um client ID pré-compartilhado ou configuração manual.
3. Seu navegador abre a tela de consentimento de Bird.
4. O cliente troca o resultado por um access token (PKCE; renovado automaticamente) e as ferramentas Bird aparecem.

Local: execute via stdio com o CLI

Cursor

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

VS Code

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

Claude Code

claude mcp add bird -- bird mcp

Como o servidor local se autentica

O que as ferramentas cobrem

Mensagens

• Enviar e inspecionar email: email_send, email_send_batch, email_list e email_get, que retorna a mensagem com seu status de entrega agregado. Status de entrega por destinatário e o log de eventos são chamadas de ferramenta separadas.
• Enviar e inspecionar SMS: sms_send, sms_send_batch, sms_get, sms_list e sms_list_events, espelhando o formato de email. sms_templates_list e sms_templates_get leem o catálogo de templates.
• Enviar e inspecionar WhatsApp: whatsapp_send, whatsapp_get, whatsapp_list, whatsapp_list_events e whatsapp_media. Templates são uma superfície completa de autoria sob whatsapp_templates_*, incluindo conteúdo por versão e por idioma.
• Inspecionar segmentos de chamadas de voz: voice_legs_get e voice_legs_list consultam os segmentos das chamadas, com estatísticas por país e por código de resposta em voice_stats_*. voice_session_credentials_create cria a credencial do espaço de trabalho usada por um cliente SIP ou softphone para autenticação.
• Verificar um destinatário: verify_verifications_create envia um código de verificação único, verify_verifications_check valida o que o destinatário submeteu, e verify_verifications_next_channel recorre a outro canal.
• Criar uma chamada de voz (prévia): voice_calls_create prepara uma chamada de saída com a publicação ativa de uma sequência habilitada e não arquivada. Uma pessoa revisa e executa a solicitação no navegador; prepará-la não realiza a chamada. Consulte Criar uma chamada de voz para ver as permissões e as instruções de novas tentativas. O servidor local bird mcp exige uma versão da CLI que inclua esta ferramenta.

Preparando um canal para enviar

• Configurar domínios de envio: email_domains_create adiciona um domínio de envio e retorna os registros DNS a publicar; email_domains_verify os reverifica; além de email_domains_list e email_domains_get.
• Reivindicar e registrar remetentes SMS: sms_senders_create reivindica um remetente, sms_senders_requirements informa o que um país exige dele, e sms_senders_registrations_create o registra. Tráfego A2P nos EUA passa pelas ferramentas de marca, campanha e submissão sms_10dlc_*.
• Provisionar números: numbers_available_list pesquisa, numbers_orders_create compra e numbers_release devolve. whatsapp_numbers_precheck informa se WhatsApp aceitará um número antes de você encomendá-lo.
• Verificar se a conta pode enviar: as ferramentas trust_* informam os requisitos da organização que condicionam a compra de um número ou o registro de um remetente.

Entregabilidade de email

• Criar templates de email: email_templates_create, email_templates_list, email_templates_get, email_templates_update, email_templates_duplicate e email_templates_preview (renderiza um rascunho com valores de exemplo sem enviar). Versões ficam sob email_templates_versions_*, onde email_templates_versions_submit congela um rascunho e o torna a versão que os envios servem, e email_templates_versions_languages_* edita o conteúdo por idioma de um rascunho. Nada que um agente escreve chega a um destinatário até ser submetido.
• Gerenciar supressões: email_suppressions_list, email_suppressions_check (é seguro enviar para este endereço?), email_suppressions_add e email_suppressions_remove (anotado como destrutivo, porque remover uma supressão sem motivo prejudica a reputação do remetente).
• Gerenciar IPs dedicados e pools: email_dedicated_ips_create, email_dedicated_ips_list, email_dedicated_ips_get, email_dedicated_ips_assign (mover um para um pool) e email_dedicated_ips_delete; além de email_ip_pools_create, email_ip_pools_list, email_ip_pools_get, email_ip_pools_update e email_ip_pools_delete para os pools pelos quais você roteia envios.

Audiência e configuração

• Gerenciar contatos e audiências: contacts_* e contact_properties_* para as pessoas para quem você envia, audiences_* para as listas para as quais você envia, e preferences_* para concessões de consentimento e opt-outs.
• Provisionar Realtime: realtime_apps_* e realtime_apps_keys_* criam os apps e chaves com os quais os clientes Realtime se conectam.
• Consultar alguém: lookup_phone_number e lookup_email informam o que Bird sabe sobre um endereço antes de você enviar para ele.
• Inspecionar configuração: webhooks_list, workspace_get e whoami (o usuário autenticado: 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 ou o CLI?

Próximos passos

• AI onboarding: a versão quickstart desta página, mais o corpus de documentação legível por máquina.
• Agent skills: o plugin bird-ai do marketplace, skills mais este servidor MCP, instalados em uma etapa.
• CLI for agents: controle Bird a partir de agentes com acesso a shell sem MCP: saída JSON, exit codes semânticos, login OAuth.
• Authentication: chaves API, regiões e como as solicitações são autorizadas.