# Blooio — how to use (mcp.ai)

Connect your Blooio account and use 26 tools for communication straight from your AI agent. Connect with your own API key. Blooio provides stable v2 APIs for messaging, chats, contacts, groups, phone numbers, and account analytics.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_blooio?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `blooio_add_contact_tags`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/blooio`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/blooio/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/blooio/add/contact/tags` — Add or reactivate one or more free-form tags on a contact.
  - body: { tags: string[], contact_id: string }
- `POST https://api.mcp.ai/api/blooio/create/contact` — Create a contact from an E.164 phone number or email address, optionally assigning a name.
  - body: { name?: string, identifier: string }
- `POST https://api.mcp.ai/api/blooio/create/group` — Create a messaging group, optionally linking an existing iMessage chat and recording its members; new contacts may be created for unknown members.
  - body: { name: string, members?: string[], chat_guid?: string }
- `POST https://api.mcp.ai/api/blooio/delete/contact` — Soft-delete one contact identified by E.164 phone number or email.
  - body: { contact_id: string }
- `POST https://api.mcp.ai/api/blooio/delete/group` — Soft-delete a group, remove its members, and exit its linked iMessage chat when one exists.
  - body: { group_id: string }
- `POST https://api.mcp.ai/api/blooio/get/account` — Return the authenticated organization, assigned devices, and message usage without exposing the API-key identifier.
- `POST https://api.mcp.ai/api/blooio/get/chat` — Return detailed counts, participant context, and latest-message metadata for one conversation.
  - body: { chat_id: string }
- `POST https://api.mcp.ai/api/blooio/get/contact` — Return one contact by E.164 phone number or email, including its current tags.
  - body: { contact_id: string }
- `POST https://api.mcp.ai/api/blooio/get/contact/capabilities` — Check whether a contact can receive iMessage, SMS, or FaceTime before choosing a communication path.
  - body: { contact_id: string }
- `POST https://api.mcp.ai/api/blooio/get/group` — Return one messaging group by its grp_ identifier.
  - body: { group_id: string }
- `POST https://api.mcp.ai/api/blooio/get/message` — Return one message with content, reactions, delivery status, protocol, errors, and inline-reply context.
  - body: { chat_id: string, message_id: string }
- `POST https://api.mcp.ai/api/blooio/get/poll/results` — Return a poll's definition, option vote counts, and total votes.
  - body: { chat_id: string, poll_id: string }
- `POST https://api.mcp.ai/api/blooio/get/risk/summary` — Return the cached fleet risk rollup. A null computed_at means no report has been computed and must not be interpreted as low risk.
- `POST https://api.mcp.ai/api/blooio/list/chats` — Search and page through conversations, ordered by recent activity or oldest activity.
  - body: { sort?: string, limit?: integer, query?: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/blooio/list/contacts` — Search and page through organization contacts by identifier or name.
  - body: { sort?: string, limit?: integer, query?: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/blooio/list/group/members` — Page through the members recorded for a messaging group.
  - body: { limit?: integer, group_id: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/blooio/list/groups` — Search and page through messaging groups by name.
  - body: { sort?: string, limit?: integer, query?: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/blooio/list/messages` — Page through messages in one chat with direction, time-window, and ordering filters.
  - body: { sort?: string, limit?: integer, since?: integer, until?: integer, chat_id: string, direction?: string, next_cursor?: string }
- `POST https://api.mcp.ai/api/blooio/list/numbers` — List sender phone numbers assigned to the connected API key and their availability state.
- `POST https://api.mcp.ai/api/blooio/mark/chat/read` — Mark every message in a chat as read and irreversibly send an externally visible read receipt to the sender; the receipt cannot be unsent.
  - body: { chat_id: string }
- `POST https://api.mcp.ai/api/blooio/remove/contact/tags` — Soft-delete one or more exact tags from a contact sequentially; if a later removal fails, earlier removals remain applied.
  - body: { tags: string[], contact_id: string }
- `POST https://api.mcp.ai/api/blooio/send/message` — Irreversibly send one or multiple text, attachment, multipart, or inline-reply messages; multi-recipient sends may create or reuse an unnamed group and may incur messaging charges.
  - body: { chat_id: string, content: object, reply_to?: object, from_number?: string, idempotency_key?: string, use_typing_indicator?: boolean }
- `POST https://api.mcp.ai/api/blooio/send/poll` — Irreversibly send an interactive native iMessage poll to a chat.
  - body: { title?: string, chat_id: string, options: string[] }
- `POST https://api.mcp.ai/api/blooio/set/message/reaction` — Add or remove a classic tapback or emoji reaction on a specific or relative message in a chat.
  - body: { action: string, chat_id: string, reaction: string, direction?: string, message_id: string }
- `POST https://api.mcp.ai/api/blooio/update/contact` — Set or clear the display name of an existing contact.
  - body: { name: string, contact_id: string }
- `POST https://api.mcp.ai/api/blooio/update/group` — Rename a group and, when linked, synchronize the new name to its iMessage chat.
  - body: { name: string, group_id: string }

## Example prompts
- "What can I do in Blooio?"
- "Show me a summary of my Blooio account"

## More
- Page: https://mcp.ai/blooio
- Agent spec (llms.txt): https://mcp.ai/blooio/llms.txt
- Postman collection: https://mcp.ai/blooio/postman.json