Bird MCP by usefulapi is an MCP server published by io.usefulapi, hosted at bird.usefulapi.io. When last checked on 2026-11-21 it was working: it answers and lists its tools. It declares 16 tools, including bird_list_contacts, bird_get_contact, bird_list_contact_properties, bird_list_audiences, bird_get_audience.
Read SMS, WhatsApp, email, contacts and audiences from your Bird workspace, plus safe CRM writes.
4,172 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List contacts (CRM records) in the workspace, newest first, as a cursor page. Bird API: GET /v1/contacts.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items per page. |
| starting_after | string | Cursor from a previous response's `next_cursor` field, to fetch the next page. |
{
"name": "bird_list_contacts",
"title": "List contacts",
"description": "List contacts (CRM records) in the workspace, newest first, as a cursor page. Bird API: GET /v1/contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Max items per page.",
"exclusiveMinimum": 0
},
"starting_after": {
"type": "string",
"description": "Cursor from a previous response's `next_cursor` field, to fetch the next page."
}
}
},
"annotations": {
"title": "List contacts",
"readOnlyHint": true
}
}None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Fetch a single contact by id. Bird API: GET /v1/contacts/{contact_id}.
| Parameter | Type | Description |
|---|---|---|
| contact_id * | string | Contact id. |
{
"name": "bird_get_contact",
"title": "Get a contact",
"description": "Fetch a single contact by id. Bird API: GET /v1/contacts/{contact_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contact_id"
],
"properties": {
"contact_id": {
"type": "string",
"description": "Contact id."
}
}
},
"annotations": {
"title": "Get a contact",
"readOnlyHint": true
}
}List the custom contact-property definitions (schema) for the workspace. Bird API: GET /v1/contact-properties.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items per page. |
| starting_after | string | Cursor from a previous response's `next_cursor` field, to fetch the next page. |
{
"name": "bird_list_contact_properties",
"title": "List contact properties",
"description": "List the custom contact-property definitions (schema) for the workspace. Bird API: GET /v1/contact-properties.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Max items per page.",
"exclusiveMinimum": 0
},
"starting_after": {
"type": "string",
"description": "Cursor from a previous response's `next_cursor` field, to fetch the next page."
}
}
},
"annotations": {
"title": "List contact properties",
"readOnlyHint": true
}
}List audiences (contact lists) in the workspace, newest first, as a cursor page. Bird API: GET /v1/audiences.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items per page. |
| starting_after | string | Cursor from a previous response's `next_cursor` field, to fetch the next page. |
{
"name": "bird_list_audiences",
"title": "List audiences",
"description": "List audiences (contact lists) in the workspace, newest first, as a cursor page. Bird API: GET /v1/audiences.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Max items per page.",
"exclusiveMinimum": 0
},
"starting_after": {
"type": "string",
"description": "Cursor from a previous response's `next_cursor` field, to fetch the next page."
}
}
},
"annotations": {
"title": "List audiences",
"readOnlyHint": true
}
}Fetch a single audience by id. Bird API: GET /v1/audiences/{audience_id}.
| Parameter | Type | Description |
|---|---|---|
| audience_id * | string | Audience id. |
{
"name": "bird_get_audience",
"title": "Get an audience",
"description": "Fetch a single audience by id. Bird API: GET /v1/audiences/{audience_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"audience_id"
],
"properties": {
"audience_id": {
"type": "string",
"description": "Audience id."
}
}
},
"annotations": {
"title": "Get an audience",
"readOnlyHint": true
}
}List the contacts that belong to a static audience, as a cursor page. Bird API: GET /v1/audiences/{audience_id}/contacts.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items per page. |
| audience_id * | string | Audience id. |
| starting_after | string | Cursor from a previous response's `next_cursor` field, to fetch the next page. |
{
"name": "bird_list_audience_contacts",
"title": "List an audience's contacts",
"description": "List the contacts that belong to a static audience, as a cursor page. Bird API: GET /v1/audiences/{audience_id}/contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"audience_id"
],
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Max items per page.",
"exclusiveMinimum": 0
},
"audience_id": {
"type": "string",
"description": "Audience id."
},
"starting_after": {
"type": "string",
"description": "Cursor from a previous response's `next_cursor` field, to fetch the next page."
}
}
},
"annotations": {
"title": "List an audience's contacts",
"readOnlyHint": true
}
}List SMS messages (inbound + outbound) for the workspace, newest first, as a cursor page. Bird API: GET /v1/sms/messages.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items per page. |
| starting_after | string | Cursor from a previous response's `next_cursor` field, to fetch the next page. |
{
"name": "bird_list_sms_messages",
"title": "List SMS messages",
"description": "List SMS messages (inbound + outbound) for the workspace, newest first, as a cursor page. Bird API: GET /v1/sms/messages.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Max items per page.",
"exclusiveMinimum": 0
},
"starting_after": {
"type": "string",
"description": "Cursor from a previous response's `next_cursor` field, to fetch the next page."
}
}
},
"annotations": {
"title": "List SMS messages",
"readOnlyHint": true
}
}Fetch a single SMS message by id. Bird API: GET /v1/sms/messages/{message_id}.
| Parameter | Type | Description |
|---|---|---|
| message_id * | string | SMS message id. |
{
"name": "bird_get_sms_message",
"title": "Get an SMS message",
"description": "Fetch a single SMS message by id. Bird API: GET /v1/sms/messages/{message_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message_id"
],
"properties": {
"message_id": {
"type": "string",
"description": "SMS message id."
}
}
},
"annotations": {
"title": "Get an SMS message",
"readOnlyHint": true
}
}List the SMS templates available to the workspace (Bird built-ins + your own). Bird API: GET /v1/sms/templates.
| Parameter | Type | Description |
|---|---|---|
| scope | string | Filter by scope. |
| category | string | Filter by category. |
| language | string | Keep only templates in this BCP-47 language tag. |
{
"name": "bird_list_sms_templates",
"title": "List SMS templates",
"description": "List the SMS templates available to the workspace (Bird built-ins + your own). Bird API: GET /v1/sms/templates.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"scope": {
"enum": [
"system",
"workspace"
],
"type": "string",
"description": "Filter by scope."
},
"category": {
"enum": [
"transactional",
"marketing",
"authentication",
"service"
],
"type": "string",
"description": "Filter by category."
},
"language": {
"type": "string",
"description": "Keep only templates in this BCP-47 language tag."
}
}
},
"annotations": {
"title": "List SMS templates",
"readOnlyHint": true
}
}List WhatsApp messages (inbound + outbound) for the workspace, newest first, as a cursor page. Bird API: GET /v1/whatsapp/messages.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items per page. |
| starting_after | string | Cursor from a previous response's `next_cursor` field, to fetch the next page. |
{
"name": "bird_list_whatsapp_messages",
"title": "List WhatsApp messages",
"description": "List WhatsApp messages (inbound + outbound) for the workspace, newest first, as a cursor page. Bird API: GET /v1/whatsapp/messages.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Max items per page.",
"exclusiveMinimum": 0
},
"starting_after": {
"type": "string",
"description": "Cursor from a previous response's `next_cursor` field, to fetch the next page."
}
}
},
"annotations": {
"title": "List WhatsApp messages",
"readOnlyHint": true
}
}Fetch a single WhatsApp message by id. Bird API: GET /v1/whatsapp/messages/{message_id}.
| Parameter | Type | Description |
|---|---|---|
| message_id * | string | WhatsApp message id. |
{
"name": "bird_get_whatsapp_message",
"title": "Get a WhatsApp message",
"description": "Fetch a single WhatsApp message by id. Bird API: GET /v1/whatsapp/messages/{message_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message_id"
],
"properties": {
"message_id": {
"type": "string",
"description": "WhatsApp message id."
}
}
},
"annotations": {
"title": "Get a WhatsApp message",
"readOnlyHint": true
}
}List the WhatsApp message templates available to the workspace. Bird API: GET /v1/whatsapp/templates.
No parameters.
{
"name": "bird_list_whatsapp_templates",
"title": "List WhatsApp templates",
"description": "List the WhatsApp message templates available to the workspace. Bird API: GET /v1/whatsapp/templates.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List WhatsApp templates",
"readOnlyHint": true
}
}List email messages sent from the workspace, newest first, as a cursor page. Bird API: GET /v1/email/messages.
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Max items per page. |
| starting_after | string | Cursor from a previous response's `next_cursor` field, to fetch the next page. |
{
"name": "bird_list_email_messages",
"title": "List email messages",
"description": "List email messages sent from the workspace, newest first, as a cursor page. Bird API: GET /v1/email/messages.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 1000,
"description": "Max items per page.",
"exclusiveMinimum": 0
},
"starting_after": {
"type": "string",
"description": "Cursor from a previous response's `next_cursor` field, to fetch the next page."
}
}
},
"annotations": {
"title": "List email messages",
"readOnlyHint": true
}
}Fetch a single email message by id. Bird API: GET /v1/email/messages/{message_id}.
| Parameter | Type | Description |
|---|---|---|
| message_id * | string | Email message id. |
{
"name": "bird_get_email_message",
"title": "Get an email message",
"description": "Fetch a single email message by id. Bird API: GET /v1/email/messages/{message_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message_id"
],
"properties": {
"message_id": {
"type": "string",
"description": "Email message id."
}
}
},
"annotations": {
"title": "Get an email message",
"readOnlyHint": true
}
}Creates a contact (CRM record) in Bird — additive, sends no message. Contacts are unique by email. Bird API: POST /v1/contacts.
| Parameter | Type | Description |
|---|---|---|
| data | object | Custom property values. Each key must be a property created via the contact-properties API; values match the property's declared type. |
| email * | string | The contact's email address (unique within the workspace). |
| last_name | string | The contact's last name. |
| first_name | string | The contact's first name. |
| external_id | string | Your own identifier for this contact (unique within the workspace). |
{
"name": "bird_create_contact",
"title": "Create a contact",
"description": "Creates a contact (CRM record) in Bird — additive, sends no message. Contacts are unique by email. Bird API: POST /v1/contacts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"email"
],
"properties": {
"data": {
"type": "object",
"description": "Custom property values. Each key must be a property created via the contact-properties API; values match the property's declared type.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"email": {
"type": "string",
"description": "The contact's email address (unique within the workspace)."
},
"last_name": {
"type": "string",
"description": "The contact's last name."
},
"first_name": {
"type": "string",
"description": "The contact's first name."
},
"external_id": {
"type": "string",
"description": "Your own identifier for this contact (unique within the workspace)."
}
}
},
"annotations": {
"title": "Create a contact",
"destructiveHint": true
}
}Creates an audience (contact list) in Bird — additive, sends no message. Static audiences start empty. Bird API: POST /v1/audiences.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Display name for the audience. |
| type | string | How members are determined. Only `static` is generally available. |
| description | string | Longer description of who this audience is. |
{
"name": "bird_create_audience",
"title": "Create an audience",
"description": "Creates an audience (contact list) in Bird — additive, sends no message. Static audiences start empty. Bird API: POST /v1/audiences.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Display name for the audience."
},
"type": {
"enum": [
"static",
"dynamic",
"external"
],
"type": "string",
"description": "How members are determined. Only `static` is generally available."
},
"description": {
"type": "string",
"description": "Longer description of who this audience is."
}
}
},
"annotations": {
"title": "Create an audience",
"destructiveHint": true
}
}Tools for Bird, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Show the last 20 text messages in our account with their delivery details."; "How many contacts are in our newsletter audience?"; "List the text message templates we can use for customers.". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Bird data. Free plan: 50 tool calls per month. Run bird_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run bird_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run bird_upgrade without a plan: it returns both plans, each with a payment link for the user to open. bird_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.