Bird MCP server

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.

curl -fsSL https://cli.bird.com/install.sh | sh   # install the bird CLI
bird 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:

# 1. Sign up. Emails a six-digit code to the address; no password is set.
bird auth signup you@example.com

# 2. Verify. Read the code from that email, then exchange it for a single-use onboarding ticket.
bird auth verify-email you@example.com --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:

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 onboarding@messagebird.dev, 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:

Shortened. The full README is on GitHub.