Bird

com.birdPublished by bird.comOfficial publisherv0.161.0Updated Nov 7, 2026

Send and receive across email, SMS, WhatsApp, and voice. One API, one contract.

VerifiedStreamable HTTPWeb executableCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Bird's hosted MCP server lets an assistant send and receive messages across email, SMS, WhatsApp and voice through one OAuth-gated account.

What you can do
  • Send and inspect messages across email, SMS, WhatsApp and voice
  • Set up channels and verify one-time passcodes
  • Look up recipients and manage contacts, audiences and messaging preferences
  • Work with Realtime provisioning, webhooks, API keys and support tickets
  • Search Bird documentation; a companion skill audits a domain's DMARC, SPF, DKIM, BIMI and MX records
When to use it
Useful when you want an agent to run customer or transactional messaging end to end from one account, or to inspect and troubleshoot messages already sent, without wiring up API keys by hand.
Requirements
A remote endpoint at mcp.bird.com reached over streamable HTTP, plus a Bird account. Authentication is OAuth: a one-time browser sign-in and consent approval per client, and every tool call fails until it is granted. The vendor's plugin also installs a separate bird CLI for setup and signup.
Before you install
The server can send real messages on live channels, which may cost money and reach real recipients; the vendor's own setup prompt sends a test email. It can also change workspace settings, contacts, webhooks and API keys. Access is granted through an OAuth consent screen, so review the scopes you approve and revoke the grant when done.

Installation

In SourceWeft

  1. Open Bird in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.bird%2Fmcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "bird": {
      "type": "http",
      "url": "https://mcp.bird.com/"
    }
  }
}

README

Bird AI Marketplace

Skills for driving the Bird platform from your coding agent. Your agent operates Bird through the bird CLI; the bird plugin in this marketplace installs the skills that teach it Bird's workflows, and on clients that read the plugin's MCP declaration it wires up Bird's hosted MCP server too.

Quick start

Every client starts the same way: install the CLI and sign in.

bash
curl -fsSL https://cli.bird.com/install.sh | sh   # install the bird CLIbird auth login                                            # sign in (browser, no API key)

On macOS or Linux you can also install with Homebrew: brew install messagebird/tap/bird.

Then jump to your client below. The fastest path is to paste the setup prompt and let your agent do the rest; a manual path is under each one.

No Bird account yet?

bird auth login signs in to an account you already have. An agent with no account can create one from the terminal — no browser, no password. Three commands take you from nothing to a stored credential:

bash
# 1. Sign up. Emails a six-digit code to the address; no password is set.bird auth signup [email protected]
# 2. Verify. Read the code from that email, then exchange it for a single-use onboarding ticket.bird auth verify-email [email protected] --code 123456# → { "onboarding_ticket": "obt_…", "user_id": "usr_…" }
# 3. Create your first org + workspace. Consumes the ticket, then mints and stores the credential.#    --region picks where the account and its data live (us1 or eu1); the CLI routes there for you.bird auth create-org "Acme" --workspace-name "Production" --region us1 --onboarding-ticket obt_…
# Confirm it worked — reports the account, org, and workspace you're now acting as.bird auth status

The code arrives by email, so it comes from outside the CLI — read it from the inbox and pass it to step 2. Signup and verification are region-agnostic; you pick the region once, at create-org, so there is no host or environment variable to set. Every step is self-describing: append --help for the flags, --example for a ready-to-edit request body, or --response-schema for what it returns — none of them need a credential, so an agent can plan the whole chain before running it. Full walkthrough: Self-serve signup.

Any Agent Plugins client

The plugin ships a root plugin.json and mcp.json following Agent Plugins, the portable plugin format. A client that implements the specification loads it from this repository as it is: the skills and the hosted MCP server, in one install. Point the client at github.com/messagebird/bird-ai and install bird from plugins/bird.

For a client with its own plugin format, or none, find it below.

Claude Code

Paste this prompt into Claude Code and it installs the CLI, signs you in, installs the skills, and sends a test email:

text
Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.2. Sign me in: run `bird auth login` and open the browser link for me.3. Install Bird's skills so you know the workflows: run `claude plugin marketplace add messagebird/bird-ai`, then `claude plugin install bird@bird-ai`.4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".Then let's discuss next steps, given what Bird can do.

Or install the plugin manually:

bash
claude plugin marketplace add messagebird/bird-aiclaude plugin install bird@bird-ai

MCP server: installing the plugin registers Bird's hosted server at https://mcp.bird.com, so there is nothing to configure. You do have to sign in once, because the server is OAuth-gated: run /mcp, select bird, press Enter, and choose Authenticate. Your browser opens Bird's consent screen; approve it and the tools work. Until then claude mcp list reports bird as ! Needs authentication and every tool call fails. For a headless run (claude -p) there is no /mcp panel, so authenticate first with claude mcp login bird.

Cursor

Paste this prompt into Cursor:

text
Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.2. Sign me in: run `bird auth login` and open the browser link for me.3. Give yourself Bird's skills (Cursor installs plugins through its UI, so set them up by file instead): fetch the skills from https://github.com/messagebird/bird-ai and write them into `.cursor/rules/` as `.mdc` files.4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".Then let's discuss next steps, given what Bird can do.

To set the skills up by hand, add the messagebird/bird-ai marketplace under Settings → Plugins, or write the skills from this repo into .cursor/rules/ as .mdc files yourself.

MCP server: add the hosted server once in ~/.cursor/mcp.json:

json
{  "mcpServers": {    "bird": { "url": "https://mcp.bird.com" }  }}

Then sign in: open Customize in the Cursor sidebar, select MCPs, and follow the sign-in prompt for bird. Approve Bird's consent screen in the browser and return to Cursor. The tools fail until you do.

Codex

Paste this prompt into Codex:

text
Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.2. Sign me in: run `bird auth login` and open the browser link for me.3. Install Bird's skills so you know the workflows: run `codex plugin marketplace add messagebird/bird-ai`, then `codex plugin add bird@bird-ai` (check `codex plugin --help` if the exact form differs).4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".Then let's discuss next steps, given what Bird can do.

Or install the plugin manually:

bash
codex plugin marketplace add messagebird/bird-aicodex plugin add bird@bird-ai

MCP server: the plugin registers https://mcp.bird.com automatically.

Then sign in, which opens your browser for Bird's consent screen:

bash
codex mcp login bird

GitHub Copilot

Paste this prompt into Copilot:

text
Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.2. Sign me in: run `bird auth login` and open the browser link for me.3. Install Bird's skills so you know the workflows: run `copilot plugin marketplace add messagebird/bird-ai`, then `copilot plugin install bird@bird-ai`.4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".Then let's discuss next steps, given what Bird can do.

Or install the plugin manually:

bash
copilot plugin marketplace add messagebird/bird-aicopilot plugin install bird@bird-ai

MCP server: add the hosted server once in .vscode/mcp.json:

json
{  "servers": {    "bird": { "type": "http", "url": "https://mcp.bird.com" }  }}

VS Code asks you to trust the server the first time it starts, then runs the sign-in itself: approve Bird's consent screen in the browser window it opens. If no window appears, start bird from the MCP: List Servers command. Your grant is listed under the Accounts menu → Manage Trusted MCP Servers, which is also where you revoke it.

Factory Droid

Paste this prompt into Droid:

text
Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.2. Sign me in: run `bird auth login` and open the browser link for me.3. Install Bird's skills so you know the workflows: Droid loads skills from `.factory/skills/`, so clone https://github.com/messagebird/bird-ai and copy every directory in `plugins/bird/skills/` into `.factory/skills/`.4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".Then let's discuss next steps, given what Bird can do.

To set the skills up by hand:

bash
git clone https://github.com/messagebird/bird-aicp -r bird-ai/plugins/bird/skills/. .factory/skills/

MCP server: add the hosted server once:

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

Then run /mcp inside droid and complete the browser sign-in from the server manager.

OpenCode

Paste this prompt into OpenCode:

text
Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.2. Sign me in: run `bird auth login` and open the browser link for me.3. Install Bird's OpenCode plugin so you know the workflows: run `opencode plugin github:messagebird/bird-ai --global`, then tell me to restart OpenCode and run `opencode mcp auth bird`.4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".Then let's discuss next steps, given what Bird can do.

Or install the plugin by hand:

bash
opencode plugin github:messagebird/bird-ai --globalopencode mcp auth bird

The plugin adds Bird's skills and the hosted MCP server to your OpenCode config. By default OpenCode adds every MCP tool to the model's context, so the plugin connects to https://mcp.bird.com/dynamic, which offers two tools: search finds the Bird tool for a task and execute runs it. With OpenCode's experimental code mode on (OPENCODE_EXPERIMENTAL_CODE_MODE=1, or OPENCODE_EXPERIMENTAL=1), OpenCode keeps MCP tools behind its own search, so the plugin connects to the full catalog at https://mcp.bird.com instead.

By default the plugin makes OpenCode ask before each call that can change your workspace: before bird_execute on /dynamic, and before every Bird tool in code mode. Your own opencode.json takes precedence: a bird_* rule you set, a single permission value for every tool, or a bird server you configured replaces the plugin's.

Google Antigravity

Paste this prompt into Antigravity:

text
Bird is a communications platform you can operate end to end: email, SMS, WhatsApp, and voice through one API and one login. Set Bird up for me, end to end.1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.2. Sign me in: run `bird auth login` and open the browser link for me.3. Install Bird's Antigravity plugin so you know the workflows: run `curl -fsSL https://raw.githubusercontent.com/messagebird/bird-ai/main/antigravity.sh | bash`, then tell me to open Customizations in the sidebar and authenticate `bird`.4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.5. Send me a test email so I see it land in my own inbox: use my address from `bird whoami` as the recipient, send from [email protected], then confirm delivery with `bird email get`. Subject: "Your Bird account is ready". Body: "You're set up and ready to send. This email is the proof. Cheers, The Bird team".Then let's discuss next steps, given what Bird can do.

Or install the plugin by hand:

bash
curl -fsSL https://raw.githubusercontent.com/messagebird/bird-ai/main/antigravity.sh | bash

The script downloads the plugin from this repository's main branch and installs it in ~/.gemini/config/plugins/bird, where Antigravity 2.0, the IDE, and Antigravity CLI load it in every workspace. To install it in one project, run it from the project root with bash -s -- --project, which writes .agents/plugins/bird. Run the same command again to update. From a clone of this repository, run bash antigravity.sh with the same options.

MCP server: the plugin registers Bird's hosted server at https://mcp.bird.com. You still sign in once, because the server is OAuth-gated: open Customizations in the sidebar (in the IDE, open Agent settings with Cmd+, on macOS or Ctrl+, elsewhere), and select Authenticate next to bird. If bird is not listed, restart Antigravity. Approve Bird's consent screen in the browser, copy the authorization code it shows, paste it into Antigravity, and select Submit. Until then every tool call fails.

The package's VERSION file records the Bird AI release, because Antigravity's plugin manifest accepts only a name and description. These are local installation instructions; inclusion in Google's curated marketplace requires its separate review.

What's in the bird plugin

  • bird-cli: operate the Bird API from the terminal. One reference per CLI command group, covering sending and inspecting messages on every channel Bird runs, the setup each channel needs before it can send, one-time-passcode verification, recipient lookup, contacts and audiences, messaging preferences, Realtime provisioning, webhooks, API keys, support tickets, and documentation search.
  • email-audit: grade a domain's live DMARC, SPF, DKIM, BIMI, and MX records and read the findings back as a prioritized fix list. DNS-only, so it needs no sign-in.
  • Bird MCP server: the hosted server at https://mcp.bird.com, so your agent can call Bird directly with a browser sign-in and no API key. Registered for you on Claude Code, Codex, OpenCode, Antigravity and any Agent Plugins host; a one-time config elsewhere (above). Every client needs the one-time browser sign-in described in its section: the server is OAuth-gated, and a client that has the URL but no grant lists the tools and fails every call.

License

MIT.

Source: README.md at commit 2c29a5a

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

58
  1. v0.161.0LatestNov 7, 2026
  2. v0.159.1Nov 6, 2026
  3. v0.157.2Nov 5, 2026
  4. v0.157.0Nov 5, 2026
  5. v0.156.0Nov 4, 2026
  6. v0.155.0Nov 4, 2026
  7. v0.153.2Nov 4, 2026
  8. v0.153.1Nov 3, 2026
  9. v0.153.0Nov 3, 2026
  10. v0.149.0Nov 3, 2026
  11. v0.145.0Oct 30, 2026
  12. v0.144.0Oct 30, 2026
  13. v0.143.0Oct 30, 2026
  14. v0.142.0Oct 29, 2026
  15. v0.137.0Oct 26, 2026
  16. v0.135.0Oct 23, 2026
  17. v0.134.0Oct 22, 2026
  18. v0.133.0Oct 22, 2026
  19. v0.130.0Oct 21, 2026
  20. v0.127.0Oct 21, 2026
  21. v0.126.1Oct 20, 2026
  22. v0.126.0Oct 20, 2026
  23. v0.125.0Oct 20, 2026
  24. v0.124.0Oct 19, 2026
  25. v0.123.0Oct 19, 2026
  26. v0.121.0Oct 16, 2026
  27. v0.120.0Oct 16, 2026
  28. v0.118.0Oct 15, 2026
  29. v0.115.0Oct 14, 2026
  30. v0.114.0Oct 13, 2026
  31. v0.113.0Oct 7, 2026
  32. v0.112.0Oct 7, 2026
  33. v0.111.2Oct 7, 2026
  34. v0.109.1Oct 7, 2026
  35. v0.109.0Oct 6, 2026
  36. v0.108.0Oct 5, 2026
  37. v0.107.2Oct 5, 2026
  38. v0.106.0Oct 2, 2026
  39. v0.104.0Oct 1, 2026
  40. v0.102.0Oct 1, 2026
  41. v0.101.0Oct 1, 2026
  42. v0.100.0Sep 30, 2026
  43. v0.99.0Sep 30, 2026
  44. v0.97.0Sep 30, 2026
  45. v0.96.0Sep 29, 2026
  46. v0.92.0Sep 29, 2026
  47. v0.91.2Sep 24, 2026
  48. v0.90.0Sep 23, 2026
  49. v0.89.0Sep 23, 2026
  50. v0.88.1Sep 23, 2026
  51. v0.88.0Sep 23, 2026
  52. v0.87.0Sep 22, 2026
  53. v0.86.0Sep 22, 2026
  54. v0.85.0Sep 21, 2026
  55. v0.84.0Sep 18, 2026
  56. v0.83.0Sep 17, 2026
  57. v0.81.0Sep 16, 2026
  58. v0.80.0Sep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Bird integrations

Pondlog eBird

Published by GitHub account andrewschristison

A local MCP server that gives an assistant 21 eBird API v2 tools for bird observations, hotspots, checklists and taxonomy.

STDIODesktop only
Location & LifestyleNot validated yetOct 24, 2026