Bird MCP server

Bird MCP is the Model Context Protocol server that lets Claude, Cursor, and any MCP-aware agent send messages through Bird. One tool per resource, scoped keys per agent, every call audited.

What MCP is

MCP is an open protocol for connecting agents to tools and data sources — formally specified at modelcontextprotocol.io. Think of it as tools the agent can call, served by a process you run locally; Bird MCP is a server that exposes Bird's API as one such tool surface.

Install

The server is published on npm and runs without an install step.

npx @bird/mcp
# or
pnpm dlx @bird/mcp
# or
bunx @bird/mcp

The server speaks stdio MCP by default and HTTP MCP with --http. Source is open at github.com/bird-io/mcp.

Configuration

Each MCP-aware client reads its server list from a JSON config. The shape is the same; the file location differs.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "bird": {
      "command": "npx",
      "args": ["-y", "@bird/mcp"],
      "env": {
        "BIRD_API_KEY": "bird_live_..."
      }
    }
  }
}

Cursor

~/.cursor/mcp.json (or settings → MCP):

{
  "mcpServers": {
    "bird": {
      "command": "npx",
      "args": ["-y", "@bird/mcp"],
      "env": {
        "BIRD_API_KEY": "bird_live_..."
      }
    }
  }
}

Cline

VS Code settings (Cline: Mcp Servers):

{
  "bird": {
    "command": "npx",
    "args": ["-y", "@bird/mcp"],
    "env": {
      "BIRD_API_KEY": "bird_live_..."
    }
  }
}

Use a bird_test_* key during development — sends are free and only the sanctioned test recipients (delivered@bird.dev, +15005550006, +15005550010, +15005550009) actually receive anything.

Tool surface

Tool	Description
`send_email`	Send an email through a verified domain.
`send_sms`	Send an SMS through a registered number, alpha tag, or pool.
`send_whatsapp`	Send a WhatsApp template, free-form, or interactive message.
`place_call`	Place an outbound voice call with a declarative IVR flow.
`start_verification`	Start an OTP verification over SMS, voice, or email.
`check_verification`	Verify the code the user entered.
`run_flow`	Invoke a Bird Flow with recipient and variables.
`get_message_status`	Look up a sent message by ID (polymorphic on `email_`/`sms_`/`call_`/`wa_msg_`/`ver_*`).
`list_messages`	Search recent messages on a channel with filters for state, recipient, and time.
`list_flows`	List flows deployed on the account.
`get_flow_run`	Inspect the per-step state of a flow run by `flow_run_*` ID.
`subscribe_webhook`	Create a webhook subscription.
`list_webhooks`	List existing webhook subscriptions.

Scoped keys for agents

Issue a scoped key dedicated to MCP rather than handing the agent a full-access production key. The recommended starting scope is *.read plus send-restricted-to-test-recipients — the agent can inspect anything, but can only send to the sanctioned addresses above.

Create one from the console → New key → MCP key. The scoped key picker has presets for "read-only," "test-recipients-only," and "production send" — pick the narrowest that lets the agent do its job.

Audit

Every MCP call is logged with agent_id (derived from the key), the tool name, the request body, and the response body. The audit log is queryable from the console and via bird.audit.list from the SDK.

llms.txt

Bird publishes a canonical doc index at https://bird.dev/llms.txt — a flat, link-rich summary of this docs site optimized for LLM crawlers and MCP clients that prefer retrieval over tool calling. The file is regenerated from this site on every commit, so it never drifts from the live API surface.

Mulai dengan satu channel.Tambahkan yang lain saat Anda siap.

Mulai dengan satu channel.
Tambahkan yang lain saat Anda siap.