Read SMS, WhatsApp, email, contacts and audiences from your Bird workspace, plus safe CRM writes.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Creates an audience (contact list) in Bird — additive, sends no message. Static audiences start empty. Bird API: POST /v1/audiences.
Display name for the audience.
How members are determined. Only `static` is generally available.
Longer description of who this audience is.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
Creates an audience (contact list) in Bird — additive, sends no message. Static audiences start empty. Bird API: POST /v1/audiences.
| Argument | 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. |
{
"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."
}
}
}Creates a contact (CRM record) in Bird — additive, sends no message. Contacts are unique by email. Bird API: POST /v1/contacts.
| Argument | 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). |
{
"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)."
}
}
}Fetch a single audience by id. Bird API: GET /v1/audiences/{audience_id}.
| Argument | Type | Description |
|---|---|---|
| audience_id* | string | Audience id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"audience_id"
],
"properties": {
"audience_id": {
"type": "string",
"description": "Audience id."
}
}
}Fetch a single contact by id. Bird API: GET /v1/contacts/{contact_id}.
| Argument | Type | Description |
|---|---|---|
| contact_id* | string | Contact id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"contact_id"
],
"properties": {
"contact_id": {
"type": "string",
"description": "Contact id."
}
}
}Fetch a single email message by id. Bird API: GET /v1/email/messages/{message_id}.
| Argument | Type | Description |
|---|---|---|
| message_id* | string | Email message id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message_id"
],
"properties": {
"message_id": {
"type": "string",
"description": "Email message id."
}
}
}Fetch a single SMS message by id. Bird API: GET /v1/sms/messages/{message_id}.
| Argument | Type | Description |
|---|---|---|
| message_id* | string | SMS message id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message_id"
],
"properties": {
"message_id": {
"type": "string",
"description": "SMS message id."
}
}
}Fetch a single WhatsApp message by id. Bird API: GET /v1/whatsapp/messages/{message_id}.
| Argument | Type | Description |
|---|---|---|
| message_id* | string | WhatsApp message id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"message_id"
],
"properties": {
"message_id": {
"type": "string",
"description": "WhatsApp message id."
}
}
}List the contacts that belong to a static audience, as a cursor page. Bird API: GET /v1/audiences/{audience_id}/contacts.
| Argument | 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. |
{
"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."
}
}
}List audiences (contact lists) in the workspace, newest first, as a cursor page. Bird API: GET /v1/audiences.
| Argument | 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. |
{
"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."
}
}
}List the custom contact-property definitions (schema) for the workspace. Bird API: GET /v1/contact-properties.
| Argument | 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. |
{
"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."
}
}
}List contacts (CRM records) in the workspace, newest first, as a cursor page. Bird API: GET /v1/contacts.
| Argument | 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. |
{
"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."
}
}
}List email messages sent from the workspace, newest first, as a cursor page. Bird API: GET /v1/email/messages.
| Argument | 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. |
{
"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."
}
}
}List SMS messages (inbound + outbound) for the workspace, newest first, as a cursor page. Bird API: GET /v1/sms/messages.
| Argument | 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. |
{
"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."
}
}
}List the SMS templates available to the workspace (Bird built-ins + your own). Bird API: GET /v1/sms/templates.
| Argument | Type | Description |
|---|---|---|
| scope | string | Filter by scope. |
| category | string | Filter by category. |
| language | string | Keep only templates in this BCP-47 language tag. |
{
"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."
}
}
}List WhatsApp messages (inbound + outbound) for the workspace, newest first, as a cursor page. Bird API: GET /v1/whatsapp/messages.
| Argument | 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. |
{
"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."
}
}
}List the WhatsApp message templates available to the workspace. Bird API: GET /v1/whatsapp/templates.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}