usefulapi

Bird MCP server. Read SMS, WhatsApp, email, contacts and audiences from your Bird workspace, plus safe CRM writes.

Claude

  1. Open Settings → Connectors → Add custom connector
  2. Paste this URL:
    https://bird.usefulapi.io/mcp
  3. Authenticate with Bird when prompted

Cursor · VS Code · Windsurf · Cline

Add to your MCP config, then reload & authorize:

{
  "mcpServers": {
    "bird": {
      "url": "https://bird.usefulapi.io/mcp"
    }
  }
}
live18 toolsFree 100 tool calls / monthPro $9/mo · $90/yr

Tools 18

ToolTypeWhat it does
bird_list_contactsread
List contacts
List contacts (CRM records) in the workspace, newest first, as a cursor page.
bird_get_contactread
Get contact
Fetch a single contact by id.
bird_list_contact_propertiesread
List contact properties
List the custom contact-property definitions (schema) for the workspace.
bird_list_audiencesread
List audiences
List audiences (contact lists) in the workspace, newest first, as a cursor page.
bird_get_audienceread
Get audience
Fetch a single audience by id.
bird_list_audience_contactsread
List audience contacts
List the contacts that belong to a static audience, as a cursor page.
bird_list_sms_messagesread
List sms messages
List SMS messages (inbound + outbound) for the workspace, newest first.
bird_get_sms_messageread
Get sms message
Fetch a single SMS message by id.
bird_list_sms_templatesread
List sms templates
List the SMS templates available to the workspace (built-ins + your own).
bird_list_whatsapp_messagesread
List whatsapp messages
List WhatsApp messages (inbound + outbound) for the workspace, newest first.
bird_get_whatsapp_messageread
Get whatsapp message
Fetch a single WhatsApp message by id.
bird_list_whatsapp_templatesread
List whatsapp templates
List the WhatsApp message templates available to the workspace.
bird_list_email_messagesread
List email messages
List email messages sent from the workspace, newest first, as a cursor page.
bird_get_email_messageread
Get email message
Fetch a single email message by id.
bird_create_contactwrite
Create contact
Create a contact (CRM record) — additive, sends no message. Contacts are unique by email.
bird_create_audiencewrite
Create audience
Create an audience (contact list) — additive, sends no message. Static audiences start empty.
bird_usage_statusmeta
Usage status (free-tier meter)
Report the caller's current free-tier usage this month: calls used, monthly limit, remaining, and whether the cap is reached. Read-only; does not count against the meter.
bird_upgrademeta
Upgrade to Pro (unlimited)
Subscribe to the Pro plan for UNLIMITED Bird tool calls (the free tier caps monthly usage). Choose monthly ($9/month) or yearly ($90/year — 2 months free) billing. Returns a Stripe Checkout link to open in your browser; after payment your account upgrades automatically. Read-only; does not count against the meter.

Pricing

PlanPriceLimit
Free$0100 tool calls / month
Pro$9/mo · $90/yrUnlimited

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.