A terminal guide for Bird, a command-line program that connects to the Bird communications service. Bird supports operations for email, SMS, and WhatsApp, but requires API credentials.

Sending and inspecting messages, managing reusable email or SMS templates, checking sending domains and delivery settings, and verifying whether a WhatsApp number can receive messages.

It provides a defined path for installing, authenticating, and choosing the right command for communications tasks.

bird-cli — Skill for Claude Code by messagebird/bird-ai

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add messagebird/bird-ai --skill bird-cli

Clone the repo

git clone --depth 1 https://github.com/messagebird/bird-ai

Made for: Claude Code.

Or install bird, the plugin that ships this one along with the rest of its 2 skills, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/messagebird/bird-ai/bird-cli/github.svg)](https://agentmods.dev/skills/messagebird/bird-ai/bird-cli)

Your own site

<a href="https://agentmods.dev/skills/messagebird/bird-ai/bird-cli"><img src="https://agentmods.dev/badge/skills/messagebird/bird-ai/bird-cli/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/messagebird/bird-ai/bird-cli"><img src="https://agentmods.dev/badge/skills/messagebird/bird-ai/bird-cli.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 40 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 1,977 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin original No closer match found in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00040	$0.01977
Opus 5.5	$0.00016	$0.00791
Sonnet 5.5	$0.00008	$0.00395
Haiku 4.5	$0.00004	$0.00198

Measured yesterday against content hash a22519687e4d, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

bird-cli scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured yesterday.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/bird/skills/bird-cli/SKILL.md · 67 lines

How it starts

The opening of the file, as written. The whole thing — 67 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Bird CLI

bird is a single binary for the Bird API and local tools such as WhatsApp message previews. Account operations need credentials; local previews do not.

This skill requires the bird CLI. If command -v bird finds nothing, install it with brew install messagebird/tap/bird, or follow the CLI installation instructions for other platforms.

The path

Step 0 — Authenticate for account operations. For a WhatsApp preview, go directly to Preview; for public documentation questions, use docs. For account operations, confirm credentials first: authenticate. It is a no-op when bird auth status already reports valid: true. No account yet? Create one through onboarding; it ends by storing the same credential a login would.

Step 1 — Run the operation the user asked for:

Send or inspect email messages (bird email, including send-batch) → email
Author reusable email templates, submit a draft, or roll one back (bird email templates) → email-templates
Prepare, send, or inspect a marketing broadcast (bird email broadcasts) → email-broadcasts
Send or inspect SMS messages, or browse SMS templates (bird sms) → sms
Draft the carrier verification a US toll-free number needs before it can send, read what the carrier asks for, or see why one was declined (bird sms tfn verifications) → tfn-verifications
Claim an alphanumeric SMS sender, find out what a country requires of it, or register it for a country (bird sms senders) → sms-senders
Reply to Apple Messages conversations or manage businesses and statistics (bird amb) → Apple Messages
Preview a WhatsApp message (bird whatsapp preview) → Preview (local — skips Step 0)
Send or inspect WhatsApp messages, receipts, reactions, senders, suppressions, keyword rules or statistics (bird whatsapp) → WhatsApp operations
Browse WhatsApp templates, their versions, and each version's per-language content (bird whatsapp templates) → whatsapp-templates
Create and administer WhatsApp groups, hand out or rotate an invite link, decide join requests, pin messages, or remove a participant (bird whatsapp groups) → whatsapp-groups
Triage the WhatsApp inbox — list conversations, read a thread, assign, label, resolve or mark one read (bird whatsapp conversations) → whatsapp-conversations
Set up the WhatsApp Business Agent on a number — onboard it, give it FAQs, websites, files and skills, test it, then turn it on (bird whatsapp agents) → whatsapp-agents
Inspect voice calls, find out why one was refused, configure a SIP trunk or an inbound number, register or verify an outbound caller ID, enable or disable calling to a country, or place a test call (bird voice) → voice
Buy an eSIM, add data, deliver installation details, or manage recurring packages (bird esim) → eSIM
Provision Realtime apps and rotate the keys their clients connect with (bird realtime) → realtime
Verify a recipient with a one-time passcode — send a code, then check what they submit (bird verify verifications) → verify
Find out about a recipient before you use it — grade an email address, or identify a phone number and its network (bird lookup) → lookup
Manage media-library assets and folders (bird assets) → media library
Manage contacts, audiences, and contact properties (bird contacts, bird audiences, bird contact-properties) → contacts
Record and look up messaging consent grants and opt-outs (bird preferences) → preferences
Manage sending domains (bird email domains), or find a verified from to send from → domains
Count how much mail the workspace received, by period, day or hour (bird email stats inbound) → received-mail-stats
Inspect owned-domain placement and authentication, or configure, register and read seed tests (bird email inbox-insights) → inbox-insights
Inspect competitive email intelligence (bird email competitive) → competitive
Style the hosted page a marketing recipient lands on when they unsubscribe (bird email unsubscribe-page) → unsubscribe-page
Manage dedicated IPs (bird email dedicated-ips) and IP pools (bird email ip-pools) (sending reputation) → ip-pools
Receive email at inbound forward addresses (bird email inbound-addresses), or read the mail received there (bird email inbound-messages) → inbound
Manage outbound webhook endpoints, or send events to Zapier, Make, n8n or your own endpoint and prove one arrives → webhooks
Issue or rotate a workspace API key (bird api-keys create, bird api-keys rotate) → api-keys (needs a login carrying api_keys:write; an API key cannot run it)
Find out why acquiring a number or registering a sender was refused for a reason about the organization rather than the country, and settle the requirement behind it (bird trust) → trust
Find the business a 10DLC brand is registered for, so brands create can name it (bird compliance identities list) → compliance-identities
Register a 10DLC brand for US A2P traffic, or file a submission against one (bird sms 10dlc brands create, bird sms 10dlc brands submissions create) → sibling operations; node not yet authored, --help on each carries the field list
Open a support ticket, reply to it, or wait for a support agent reply → support
Answer a how-to or reference question about Bird from the documentation → docs (public — skips Step 0)
Inspect resolved CLI configuration → bird config show (sibling operation; node not yet authored)

Read the full file on GitHub · 67 lines

Files

What ships with it

60 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

yesterday Changed · +2 lines a22519687e4d
9d ago Changed · -10 lines · +8 tokens per session 226ed43a5b34
10d ago Changed · +1 lines 7f874d0ea103
11d ago Changed · +7 lines scan C → A 830e801bcf75
15d ago Changed · +1 lines 9470032161c7
16d ago Changed 7df89f4724dc
17d ago Changed · +3 lines 310417620684
24d ago Changed · +1 lines 7350bd5d9511
25d ago Changed a6b61d648fa7
28d ago First seen · 62 lines · 32 tokens per session scan C c02a746fe809

Subscribe to this mod's changes

bird-cli is a skill published in the GitHub repository messagebird/bird-ai (8 stars, last pushed yesterday), licensed MIT. It adds 40 tokens to every session and 1,977 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Claude Code agent-skills ai-agents bird codex cpaas

telnyx-iot-curl

Manage IoT SIM cards, eSIMs, data plans, and wireless connectivity. Use when building IoT/M2M solutions. This skill provides REST API (curl) examples.

team-telnyx/ai · 45 tokens

telnyx-sip-curl

Configure SIP trunking connections and outbound voice profiles. Use when connecting PBX systems or managing SIP infrastructure. This skill provides REST API (curl) examples.

team-telnyx/ai · 39 tokens

telnyx-twilio-migration

Migrate from Twilio to Telnyx. Orchestrates a complete 6-phase migration: discovery, planning, setup, code migration, validation, and cleanup. Covers voice (TwiML to TeXML, Call Control API), messaging, WebRTC, SIP trunking, verify, fax, video, IoT, number lookup, and porting. Includes automated scanners, validation…

team-telnyx/ai · 93 tokens

bird-cli