Servidor MCP

1. Alojado (mcp.bird.com): una URL y un inicio de sesión en el navegador. Nada que instalar, sin CLI, sin clave API. Esta es la ruta recomendada.
2. Local sobre stdio (bird mcp): herramientas que se ejecutan en tu máquina dentro del bird CLI, para agentes de shell o para ejecutarlo tú mismo.

• auth_signup, auth_verify_email y auth_create_org: estas herramientas crean tu primera credencial, antes de que puedas autenticarte en el servidor alojado.
• compliance_attachments_upload: esta herramienta lee una ruta de archivo local. En el servidor alojado, esa ruta apuntaría al sistema de archivos del servidor y podría subir el archivo incorrecto.

Alojado: conectar a mcp.bird.com

Elige un endpoint

1. Añade el servidor: proporciónale al cliente la URL del endpoint que elegiste.
2. Autentícate: inicia sesión en tu navegador para que el cliente tenga un token que actúe como tú.

Usa el descubrimiento dinámico de herramientas

• search encuentra herramientas por nombre o palabras clave de la descripción. Cada coincidencia incluye su nombre, descripción, esquema de entrada y anotaciones que describen si lee o modifica datos.
• execute invoca una herramienta seleccionada con sus argumentos. Puede leer datos, enviar mensajes, modificar registros o eliminarlos, según la herramienta seleccionada.

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

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

Conecta un cliente

Claude Code

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

1. Ejecuta /mcp.
2. Selecciona bird y presiona Enter.
3. Elige Authenticate. Tu navegador abre la pantalla de consentimiento de Bird; apruébala ahí.

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

Cualquier otro host

Qué ocurre cuando inicias sesión

Cómo funciona el handshake

1. El cliente hace una solicitud sin autenticar y recibe 401 con un encabezado WWW-Authenticate que apunta a los metadatos de recurso protegido RFC 9728 de Bird (/.well-known/oauth-protected-resource).
2. Desde ahí descubre el servidor de autorización y luego se registra dinámicamente (RFC 7591). El registro dinámico elimina la necesidad de un client ID precompartido o configuración manual.
3. Tu navegador abre la pantalla de consentimiento de Bird.
4. El cliente intercambia el resultado por un token de acceso (PKCE; renovado automáticamente) y las herramientas de Bird aparecen.

Local: ejecútalo sobre stdio con el CLI

Cursor

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

VS Code

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

Claude Code

claude mcp add bird -- bird mcp

Cómo se autentica el servidor local

Qué cubren las herramientas

Mensajería

• Enviar e inspeccionar email: email_send, email_send_batch, email_list y email_get, que devuelve el mensaje con su estado de entrega agregado. Los estados de entrega por destinatario y el registro de eventos son llamadas a herramientas separadas.
• Enviar e inspeccionar SMS: sms_send, sms_send_batch, sms_get, sms_list y sms_list_events, reflejando la forma del email. sms_templates_list y sms_templates_get leen el catálogo de plantillas.
• Enviar e inspeccionar WhatsApp: whatsapp_send, whatsapp_get, whatsapp_list, whatsapp_list_events y whatsapp_media. Las plantillas son una superficie de autoría completa en whatsapp_templates_*, que incluye contenido por versión y por idioma.
• Inspeccionar tramos de llamadas de voz: voice_legs_get y voice_legs_list consultan los tramos de las llamadas, con estadísticas por país y por código de respuesta en voice_stats_*. voice_session_credentials_create crea la credencial del espacio de trabajo que utiliza un cliente SIP o softphone para autenticarse.
• Verificar a un destinatario: verify_verifications_create envía un código de verificación de un solo uso, verify_verifications_check valida lo que el destinatario envió y verify_verifications_next_channel recurre a otro canal.
• Crear una llamada de voz (vista previa): voice_calls_create prepara una llamada saliente con la publicación activa de una secuencia habilitada y no archivada. Una persona revisa y ejecuta la solicitud en el navegador; prepararla no realiza la llamada. Consulta Crear una llamada de voz para conocer los permisos y las instrucciones de reintento. El servidor local bird mcp requiere una versión de CLI que incluya esta herramienta.

Preparar un canal para enviar

• Configurar dominios de envío: email_domains_create añade un dominio de envío y devuelve los registros DNS que publicar; email_domains_verify los vuelve a verificar; más email_domains_list y email_domains_get.
• Reclamar y registrar remitentes SMS: sms_senders_create reclama un remitente, sms_senders_requirements informa qué exige un país de él y sms_senders_registrations_create lo registra. El tráfico A2P en EE. UU. pasa por las herramientas de marca, campaña y envío de sms_10dlc_*.
• Aprovisionar números: numbers_available_list busca, numbers_orders_create compra y numbers_release devuelve. whatsapp_numbers_precheck informa si WhatsApp aceptará un número antes de que lo solicites.
• Comprobar que la cuenta puede enviar: las herramientas trust_* informan de los requisitos de la organización que condicionan la compra de un número o el registro de un remitente.

Capacidad de entrega de email

• Crear plantillas de email: email_templates_create, email_templates_list, email_templates_get, email_templates_update, email_templates_duplicate y email_templates_preview (renderiza un borrador con valores de ejemplo sin enviar). Las versiones viven en email_templates_versions_*, donde email_templates_versions_submit congela un borrador y lo convierte en la versión que sirven los envíos, y email_templates_versions_languages_* edita el contenido por idioma de un borrador. Nada de lo que un agente escribe llega a un destinatario hasta que lo envía.
• Gestionar supresiones: email_suppressions_list, email_suppressions_check (¿es seguro enviar a esta dirección?), email_suppressions_add y email_suppressions_remove (anotada como destructiva, porque eliminar una supresión sin motivo daña la reputación del remitente).
• Gestionar IPs dedicadas y pools: email_dedicated_ips_create, email_dedicated_ips_list, email_dedicated_ips_get, email_dedicated_ips_assign (mover una a un pool) y email_dedicated_ips_delete; más email_ip_pools_create, email_ip_pools_list, email_ip_pools_get, email_ip_pools_update y email_ip_pools_delete para los pools a través de los que enrutas los envíos.

Audiencia y configuración

• Gestionar contactos y audiencias: contacts_* y contact_properties_* para las personas a las que envías, audiences_* para las listas a las que envías y preferences_* para concesiones de consentimiento y bajas.
• Aprovisionar Realtime: realtime_apps_* y realtime_apps_keys_* crean las apps y claves con las que se conectan los clientes de Realtime.
• Buscar a alguien: lookup_phone_number y lookup_email informan de lo que Bird sabe sobre una dirección antes de que envíes.
• Inspeccionar configuración: webhooks_list, workspace_get y whoami (el usuario con sesión iniciada: id, email, nombre).

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 el CLI?

Próximos pasos

• AI onboarding: la versión de inicio rápido de esta página, más el corpus de documentación legible por máquinas.
• Agent skills: el plugin bird-ai del marketplace, skills más este servidor MCP, instalado en un solo paso.
• CLI para agentes: controla Bird desde agentes con acceso a terminal sin MCP: salida JSON, códigos de salida semánticos, login OAuth.
• Autenticación: claves API, regiones y cómo se autorizan las solicitudes.