{
  "markdown": "# Bird AI Marketplace\n\nSkills for driving the [Bird](https://bird.com) 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.\n\n## Quick start\n\nEvery client starts the same way: install the CLI and sign in.\n\n```bash\ncurl -fsSL https://cli.bird.com/install.sh | sh   # install the bird CLI\nbird auth login                                            # sign in (browser, no API key)\n```\n\nOn macOS or Linux you can also install with Homebrew: `brew install messagebird/tap/bird`.\n\nThen 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.\n\n## No Bird account yet?\n\n`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:\n\n```bash\n# 1. Sign up. Emails a six-digit code to the address; no password is set.\nbird auth signup you@example.com\n\n# 2. Verify. Read the code from that email, then exchange it for a single-use onboarding ticket.\nbird auth verify-email you@example.com --code 123456\n# → { \"onboarding_ticket\": \"obt_…\", \"user_id\": \"usr_…\" }\n\n# 3. Create your first org + workspace. Consumes the ticket, then mints and stores the credential.\n#    --region picks where the account and its data live (us1 or eu1); the CLI routes there for you.\nbird auth create-org \"Acme\" --workspace-name \"Production\" --region us1 --onboarding-ticket obt_…\n\n# Confirm it worked — reports the account, org, and workspace you're now acting as.\nbird auth status\n```\n\nThe 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](https://bird.com/docs/ai/self-serve-signup).\n\n## Any Agent Plugins client\n\nThe plugin ships a root `plugin.json` and `mcp.json` following [Agent Plugins](https://agent-plugins.org/specification), 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`.\n\nFor a client with its own plugin format, or none, find it below.\n\n## Claude Code\n\nPaste this prompt into Claude Code and it installs the CLI, signs you in, installs the skills, and sends a test email:\n\n```text\nBird is an infrastructure platform that makes it easy to send email to your users. Set Bird up for me, end to end.\n1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.\n2. Sign me in: run `bird auth login` and open the browser link for me.\n3. Install Bird's skills so you know the workflows: run `claude plugin marketplace add messagebird/bird-ai`, then `claude plugin install bird@bird-ai`.\n4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.\n5. 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\".\nThen let's discuss next steps, given what Bird can do.\n```\n\nOr install the plugin manually:\n\n```bash\nclaude plugin marketplace add messagebird/bird-ai\nclaude plugin install bird@bird-ai\n```\n\n**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`.\n\n## Cursor\n\nPaste this prompt into Cursor:\n\n```text\nBird is an infrastructure platform that makes it easy to send email to your users. Set Bird up for me, end to end.\n1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.\n2. Sign me in: run `bird auth login` and open the browser link for me.\n3. 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.\n4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.\n5. 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\".\nThen let's discuss next steps, given what Bird can do.\n```\n\nTo 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.\n\n**MCP server:** add the hosted server once in `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"bird\": { \"url\": \"https://mcp.bird.com\" }\n  }\n}\n```\n\nThen sign in: open **Cursor Settings → Tools & Integrations**, and under **MCP Tools** click **Needs login** next to `bird`. Approve Bird's consent screen in the browser and return to Cursor. The tools fail until you do.\n\n## Codex\n\nPaste this prompt into Codex:\n\n```text\nBird is an infrastructure platform that makes it easy to send email to your users. Set Bird up for me, end to end.\n1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.\n2. Sign me in: run `bird auth login` and open the browser link for me.\n3. 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).\n4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.\n5. 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\".\nThen let's discuss next steps, given what Bird can do.\n```\n\nOr install the plugin manually:\n\n```bash\ncodex plugin marketplace add messagebird/bird-ai\ncodex plugin add bird@bird-ai\n```\n\n**MCP server:** add the hosted server once in `~/.codex/config.toml`:\n\n```toml\n[mcp_servers.bird]\nurl = \"https://mcp.bird.com\"\n```\n\nThen sign in, which opens your browser for Bird's consent screen:\n\n```bash\ncodex mcp login bird\n```\n\n## GitHub Copilot\n\nPaste this prompt into Copilot:\n\n```text\nBird is an infrastructure platform that makes it easy to send email to your users. Set Bird up for me, end to end.\n1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.\n2. Sign me in: run `bird auth login` and open the browser link for me.\n3. Install Bird's skills so you know the workflows: run `copilot plugin marketplace add messagebird/bird-ai`, then `copilot plugin install bird@bird-ai`.\n4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.\n5. 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\".\nThen let's discuss next steps, given what Bird can do.\n```\n\nOr install the plugin manually:\n\n```bash\ncopilot plugin marketplace add messagebird/bird-ai\ncopilot plugin install bird@bird-ai\n```\n\n**MCP server:** add the hosted server once in `.vscode/mcp.json`:\n\n```json\n{\n  \"servers\": {\n    \"bird\": { \"type\": \"http\", \"url\": \"https://mcp.bird.com\" }\n  }\n}\n```\n\nVS 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.\n\n## Factory Droid\n\nPaste this prompt into Droid:\n\n```text\nBird is an infrastructure platform that makes it easy to send email to your users. Set Bird up for me, end to end.\n1. Install the Bird CLI: run `curl -fsSL https://cli.bird.com/install.sh | sh`.\n2. Sign me in: run `bird auth login` and open the browser link for me.\n3. 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 `plugins/bird/skills/bird-cli` into `.factory/skills/bird-cli`.\n4. Confirm who I am: run `bird whoami`, which prints the email of the account you're acting as.\n5. 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\".\nThen let's discuss next steps, given what Bird can do.\n```\n\nTo set the skills up by hand:\n\n```bash\ngit clone https://github.com/messagebird/bird-ai\ncp -r bird-ai/plugins/bird/skills/bird-cli .factory/skills/bird-cli\n```\n\n**MCP server:** add the hosted server once:\n\n```bash\ndroid mcp add bird https://mcp.bird.com --type http\n```\n\nThen run `/mcp` inside droid and complete the browser sign-in from the server manager.\n\n## What's in the `bird` plugin\n\n- **`bird-cli`**: operate the Bird API from the terminal. Send and inspect email, manage sending domains, dedicated IPs and IP pools, and webhook endpoints, and check CLI auth.\n- **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 and on 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.\n\n## License\n\n[MIT](./LICENSE).\n",
  "bytes": 11136,
  "sha": "dca18694be6da4f5a04503517f962c2a5c34052d41a132ea47ad94eb5acbfe4b",
  "repo_slug": "messagebird/bird-ai",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_bird_mcp_bf9e9712/readme"
}