# io.usefulapi/bird (remote · bird.usefulapi.io)

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

- Trust score: 28/100 (low)
- Change this week: −41
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `bird.usefulapi.io`: 28/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-bird/bird.md), [page](https://verifymcp.io/servers/io-usefulapi-bird/bird)

## Channel facts

- Endpoint: `https://bird.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the tool list to see what that exposes.
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**Unverified: 4 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add --transport http io-usefulapi-bird https://bird.usefulapi.io/mcp
```

### Codex

```toml
[mcp_servers.io-usefulapi-bird]
url = "https://bird.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-bird": {
      "type": "remote",
      "url": "https://bird.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-bird --url https://bird.usefulapi.io/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-bird:
    url: "https://bird.usefulapi.io/mcp"
```

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-bird": {
      "type": "http",
      "url": "https://bird.usefulapi.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 28, −45)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Authorization: pass → unverified
- [security regression] Stability: 0.20 → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Capabilities: fail → unverified

### 2026-08-02 (score 73, +55)

- [security improvement] Authorization: unverified → pass
- [security improvement] Transport: fail → pass
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Endpoint reachability: not serving MCP → reachable
- [functional improvement] Stability: unverified → 0.20
- [functional improvement] Tool coverage: unverified → 100

### 2026-08-01 (score 18, −54)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Stability: 0.13 → unverified
- [security regression] Authorization: pass → unverified
- [security regression] Transport: pass → fail
- [functional regression] Capabilities: fail → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-07-31 (score 72, +3)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 69, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-29 (score 68, −2)

- [security regression] Authorization: pass → fail

### 2026-07-28 (score 70, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-07-27 (score 69, +57)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (16)

### `bird_list_contacts` (~73 tokens)

List contacts

List contacts (CRM records) in the workspace, newest first, as a cursor page. Bird API: GET /v1/contacts.

Input parameters:

- `limit` (integer): Max items per page.
- `starting_after` (string): Cursor from a previous response's `next_cursor` field, to fetch the next page.

### `bird_get_contact` (~39 tokens)

Get a contact

Fetch a single contact by id. Bird API: GET /v1/contacts/{contact_id}.

Input parameters:

- `contact_id` (string, required): Contact id.

### `bird_list_contact_properties` (~69 tokens)

List contact properties

List the custom contact-property definitions (schema) for the workspace. Bird API: GET /v1/contact-properties.

Input parameters:

- `limit` (integer): Max items per page.
- `starting_after` (string): Cursor from a previous response's `next_cursor` field, to fetch the next page.

### `bird_list_audiences` (~76 tokens)

List audiences

List audiences (contact lists) in the workspace, newest first, as a cursor page. Bird API: GET /v1/audiences.

Input parameters:

- `limit` (integer): Max items per page.
- `starting_after` (string): Cursor from a previous response's `next_cursor` field, to fetch the next page.

### `bird_get_audience` (~42 tokens)

Get an audience

Fetch a single audience by id. Bird API: GET /v1/audiences/{audience_id}.

Input parameters:

- `audience_id` (string, required): Audience id.

### `bird_list_audience_contacts` (~89 tokens)

List an audience's contacts

List the contacts that belong to a static audience, as a cursor page. Bird API: GET /v1/audiences/{audience_id}/contacts.

Input parameters:

- `audience_id` (string, required): Audience id.
- `limit` (integer): Max items per page.
- `starting_after` (string): Cursor from a previous response's `next_cursor` field, to fetch the next page.

### `bird_list_sms_messages` (~78 tokens)

List SMS messages

List SMS messages (inbound + outbound) for the workspace, newest first, as a cursor page. Bird API: GET /v1/sms/messages.

Input parameters:

- `limit` (integer): Max items per page.
- `starting_after` (string): Cursor from a previous response's `next_cursor` field, to fetch the next page.

### `bird_get_sms_message` (~43 tokens)

Get an SMS message

Fetch a single SMS message by id. Bird API: GET /v1/sms/messages/{message_id}.

Input parameters:

- `message_id` (string, required): SMS message id.

### `bird_list_sms_templates` (~75 tokens)

List SMS templates

List the SMS templates available to the workspace (Bird built-ins + your own). Bird API: GET /v1/sms/templates.

Input parameters:

- `category` (string): Filter by category.
- `language` (string): Keep only templates in this BCP-47 language tag.
- `scope` (string): Filter by scope.

### `bird_list_whatsapp_messages` (~81 tokens)

List WhatsApp messages

List WhatsApp messages (inbound + outbound) for the workspace, newest first, as a cursor page. Bird API: GET /v1/whatsapp/messages.

Input parameters:

- `limit` (integer): Max items per page.
- `starting_after` (string): Cursor from a previous response's `next_cursor` field, to fetch the next page.

### `bird_get_whatsapp_message` (~47 tokens)

Get a WhatsApp message

Fetch a single WhatsApp message by id. Bird API: GET /v1/whatsapp/messages/{message_id}.

Input parameters:

- `message_id` (string, required): WhatsApp message id.

### `bird_list_whatsapp_templates` (~34 tokens)

List WhatsApp templates

List the WhatsApp message templates available to the workspace. Bird API: GET /v1/whatsapp/templates.

### `bird_list_email_messages` (~72 tokens)

List email messages

List email messages sent from the workspace, newest first, as a cursor page. Bird API: GET /v1/email/messages.

Input parameters:

- `limit` (integer): Max items per page.
- `starting_after` (string): Cursor from a previous response's `next_cursor` field, to fetch the next page.

### `bird_get_email_message` (~42 tokens)

Get an email message

Fetch a single email message by id. Bird API: GET /v1/email/messages/{message_id}.

Input parameters:

- `message_id` (string, required): Email message id.

### `bird_create_contact` (~133 tokens)

Create a contact

Creates a contact (CRM record) in Bird — additive, sends no message. Contacts are unique by email. Bird API: POST /v1/contacts.

Input parameters:

- `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, required): The contact's email address (unique within the workspace).
- `external_id` (string): Your own identifier for this contact (unique within the workspace).
- `first_name` (string): The contact's first name.
- `last_name` (string): The contact's last name.

### `bird_create_audience` (~87 tokens)

Create an audience

Creates an audience (contact list) in Bird — additive, sends no message. Static audiences start empty. Bird API: POST /v1/audiences.

Input parameters:

- `description` (string): Longer description of who this audience is.
- `name` (string, required): Display name for the audience.
- `type` (string): How members are determined. Only `static` is generally available.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-bird/bird#diagnostics

## Score history

- 2026-08-03: 28
- 2026-08-02: 73
- 2026-08-01: 18
- 2026-07-31: 72
- 2026-07-30: 69
- 2026-07-29: 68
- 2026-07-28: 70
- 2026-07-27: 69
- 2026-07-26: 12

## Links

- Remote endpoint: https://bird.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-bird/bird/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-bird/bird/changelog.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-bird/bird