.codex-plugin/plugin.json

{
  "name": "bird",
  "version": "0.68.3",
  "description": "Drive Bird from your coding agent: operate the Bird API from the terminal with the `bird` CLI, send across email, SMS, and WhatsApp, and audit a domain's email authentication.",
  "author": {
    "name": "Bird",
    "url": "https://github.com/messagebird"
  },
  "homepage": "https://bird.com",
  "repository": "https://github.com/messagebird/bird-ai",
  "license": "MIT",
  "keywords": [
    "bird",
    "api",
    "cli",
    "agent",
    "messaging",
    "email",
    "sms",
    "whatsapp",
    "verify",
    "realtime",
    "webhooks"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Bird",
    "shortDescription": "Operate Bird from your agent",
    "longDescription": "Bird is the communications infrastructure AI agents operate. Every agent eventually has to reach a human \u2014 verify a sign-up, confirm an order, chase an invoice, answer an inbox, place a call. Connect Bird and Codex does all of it for real: email, SMS, and WhatsApp on Bird's own sending infrastructure and carrier connections, calls on Bird SIP trunks, live events to every open browser and app over Bird Realtime \u2014 with a delivery timestamp or the exact failure reason instead of a guess.\n\nAnd Codex doesn't just send through Bird \u2014 it can own the endpoints. It claims its agent a durable email address in one call and answers what arrives there. It buys a phone number, gets it verified for texting, and registers the 10DLC campaign behind it. It sets up a SIP trunk and proves the caller ID with a real verification call. Addresses, numbers, trunks, and the compliance behind them \u2014 acquired in conversation.\n\nWhatever your account can do, Codex can do here. The tools are generated from Bird's live API \u2014 the same surface Bird's own dashboard runs on \u2014 so the list Codex shows is always the current one and grows as Bird does. Some of it works before you even connect: grade any domain's live email authentication, analyze headers and DMARC reports, or search Bird's docs, no account needed.\n\nYou sign in with Bird when you connect, so there is no API key to paste and no secret sitting in your config.toml. Codex gets only the permissions you already hold, and you can revoke them from your Bird profile.\n\nA good first ask: \"Send me a test email and tell me the moment it's delivered.\" Building an agent? \"Claim yourself an email address and reply to whatever arrives.\"",
    "developerName": "Bird",
    "category": "Developer Tools",
    "capabilities": [
      "Read",
      "Write",
      "Interactive"
    ],
    "websiteURL": "https://www.bird.com",
    "supportURL": "https://bird.com/docs",
    "termsOfServiceURL": "https://bird.com/en-gb/legal/website-terms-of-use",
    "defaultPrompt": [
      "Send an email with the bird CLI",
      "List sent emails and check if one bounced",
      "Set up an outbound webhook"
    ],
    "composerIcon": "./assets/logo.svg",
    "logo": "./assets/logo.svg",
    "privacyPolicyURL": "https://bird.com/legal/privacy"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Send a transactional email and return its queued message identifier.",
              "prompt": "Send a transactional email with the subject Receipt and the text Your payment was received. Ask me for an email address I control before sending.",
              "expected_behavior": "Asks the reviewer for a controlled recipient address, then reports the accepted message and the identifier to check delivery with.",
              "tools_triggered": "email_send"
            },
            {
              "description": "Inspect recent email delivery activity without requiring seeded identifiers.",
              "prompt": "List the 10 most recent emails in my Bird workspace.",
              "expected_behavior": "Returns up to 10 recent messages with their identifiers, recipients, and delivery status.",
              "tools_triggered": "email_list"
            },
            {
              "description": "Audit a domain's live email-authentication records.",
              "prompt": "Audit the email authentication setup for example.com.",
              "expected_behavior": "Returns DMARC, SPF, DKIM, BIMI, and MX findings with prioritized recommendations, noting when a DKIM selector was not supplied.",
              "tools_triggered": "email_tools_audit"
            },
            {
              "description": "List contacts using a bounded page size.",
              "prompt": "List the first 20 contacts in my Bird workspace.",
              "expected_behavior": "Returns up to 20 contacts and pagination information without changing workspace data.",
              "tools_triggered": "contacts_list"
            },
            {
              "description": "Start an SMS verification for a recipient.",
              "prompt": "Start an SMS verification. Ask me for a phone number I control before sending the passcode.",
              "expected_behavior": "Asks the reviewer for a controlled phone number, then reports that verification started without displaying the passcode.",
              "tools_triggered": "verify_verifications_create"
            }
          ],
          "negative": [
            {
              "description": "Do not trigger for calendar scheduling.",
              "prompt": "Schedule a meeting with Ada tomorrow afternoon.",
              "expected_behavior": "The app should not be invoked because it does not manage calendars."
            },
            {
              "description": "Do not trigger for weather information.",
              "prompt": "Will it rain in Madrid tomorrow?",
              "expected_behavior": "The app should not be invoked because weather lookup is outside its supported workflows."
            },
            {
              "description": "Do not trigger for source-code deployment.",
              "prompt": "Deploy my application to production.",
              "expected_behavior": "The app should not be invoked because it does not deploy source code or infrastructure."
            }
          ]
        },
        "demo_recording_url": "https://www.youtube.com/watch?v=iugiXZQ42NQ",
        "commerce": true,
        "commerce_description": "Customers must visit their connected account to purchase subscriptions (Email plans) or fund their wallet for sending messages / buying ancillaries like numbers. Funding your account is not facilitated by the plugin"
      },
      "publication": {
        "release_notes": "Bird 0.68.3: package the existing OAuth MCP connection and listing with Bird skills; include square Bird icons and ZIP-compatible metadata."
      }
    }
  },
  "apps": "./.app.json"
}