Bird
Bird

A world of possibilities.
One place to start.

BIRD / CLI

Your next task.
From the terminal.

Send a message, inspect its result and put the workflow into a script. Bird CLI gives you the same commands in your terminal and in a shell-capable agent.

EXAMPLE / SEND TO THE EMAIL SANDBOX
Terminal
# Install the CLI.
curl -fsSL https://cli.bird.com/install.sh | sh

# Authenticate once (opens your browser).
bird auth login --scope emails:write

# Send an email.
bird email send \
  --from "Bird <onboarding@messagebird.dev>" \
  --to delivered@messagebird.dev \
  --subject "Welcome to Bird" \
  --html "<p>You are in.</p>"

Keep the message ID. Follow the result.

The send returns structured JSON with a message ID and an accepted status. Read the message by that ID to inspect delivery counts and the reported outcome. Acceptance records queued work; the delivery result arrives asynchronously.

Read the returned message
bird email get YOUR_MESSAGE_ID

Repeat the useful work.

Explore a command by hand, then use JSON output and documented exit codes in your automation. A shell-capable agent can inspect the same result before choosing its next operation. Follow the automation guide for dry runs, retries and idempotency.

Choose the task you need.

Send and inspect messages

Send SMS, preview a WhatsApp template or reply to a mailbox thread. Keep the returned identifiers to inspect what happened next.

Check a code or look up a number

Create and check a verification, or inspect phone-number signals with Lookup. Your application decides how a successful check or returned signal affects its next action.

Prepare calling and realtime resources

Create Voice session credentials or a Realtime app and key. Your SIP client handles calls; your Realtime SDK and WebSocket connection handle publishing and subscriptions.

Before your first command

How do I sign in?
Follow the installation guide and run bird auth login with the scopes needed for your task. The email quickstart requests emails:write so its send can proceed after browser consent.
Can I use it from an agent?
Yes. A shell-capable agent can run the CLI and inspect JSON output and exit codes. A compatible remote MCP client can connect through Bird’s hosted MCP server instead.
Where are the full commands documented?
The CLI documentation covers installation, authentication and command reference. Product guides explain sender setup, result interpretation and the next integration step.

Put your first command to work.

Starten Sie mit einem Kanal.
Fügen Sie die anderen hinzu, wenn Sie bereit sind.

Ein Test-API-Key steht Ihnen sofort zur Verfügung. Der Produktivzugang wird freigeschaltet, sobald Sie eine Zahlungsmethode hinzufügen und einen Absender verifizieren.

Dokumentation lesen
Sie nutzen Claude Code, Cursor oder Codex? Kopieren Sie einen Setup-Prompt und Ihr Agent installiert die Bird CLI und Skills für Sie. Wählen Sie Ihren:
Cursor