# Blooio — MCP server on 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.

By: mcp.ai · official
Page: https://mcp.ai/blooio

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_blooio?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/blooio/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/blooio/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/blooio/skill.md
Postman collection (v2.1): https://mcp.ai/blooio/postman.json

## Tools
- blooio_add_contact_tags(tags: string[], contact_id: string) — Add or reactivate one or more free-form tags on a contact.
- blooio_create_contact(name?: string, identifier: string) — Create a contact from an E.164 phone number or email address, optionally assigning a name.
- blooio_create_group(name: string, members?: string[], chat_guid?: string) — Create a messaging group, optionally linking an existing iMessage chat and recording its members; new contacts may be created for unknown members.
- blooio_delete_contact(contact_id: string) — Soft-delete one contact identified by E.164 phone number or email.
- blooio_delete_group(group_id: string) — Soft-delete a group, remove its members, and exit its linked iMessage chat when one exists.
- blooio_get_account() — Return the authenticated organization, assigned devices, and message usage without exposing the API-key identifier.
- blooio_get_chat(chat_id: string) — Return detailed counts, participant context, and latest-message metadata for one conversation.
- blooio_get_contact(contact_id: string) — Return one contact by E.164 phone number or email, including its current tags.
- blooio_get_contact_capabilities(contact_id: string) — Check whether a contact can receive iMessage, SMS, or FaceTime before choosing a communication path.
- blooio_get_group(group_id: string) — Return one messaging group by its grp_ identifier.
- blooio_get_message(chat_id: string, message_id: string) — Return one message with content, reactions, delivery status, protocol, errors, and inline-reply context.
- blooio_get_poll_results(chat_id: string, poll_id: string) — Return a poll's definition, option vote counts, and total votes.
- 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.
- blooio_list_chats(sort?: string, limit?: integer, query?: string, next_cursor?: string) — Search and page through conversations, ordered by recent activity or oldest activity.
- blooio_list_contacts(sort?: string, limit?: integer, query?: string, next_cursor?: string) — Search and page through organization contacts by identifier or name.
- blooio_list_group_members(limit?: integer, group_id: string, next_cursor?: string) — Page through the members recorded for a messaging group.
- blooio_list_groups(sort?: string, limit?: integer, query?: string, next_cursor?: string) — Search and page through messaging groups by name.
- blooio_list_messages(sort?: string, limit?: integer, since?: integer, until?: integer, chat_id: string, direction?: string, next_cursor?: string) — Page through messages in one chat with direction, time-window, and ordering filters.
- blooio_list_numbers() — List sender phone numbers assigned to the connected API key and their availability state.
- blooio_mark_chat_read(chat_id: string) — Mark every message in a chat as read and irreversibly send an externally visible read receipt to the sender; the receipt cannot be unsent.
- blooio_remove_contact_tags(tags: string[], contact_id: string) — Soft-delete one or more exact tags from a contact sequentially; if a later removal fails, earlier removals remain applied.
- blooio_send_message(chat_id: string, content: object, reply_to?: object, from_number?: string, idempotency_key?: string, use_typing_indicator?: boolean) — 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.
- blooio_send_poll(title?: string, chat_id: string, options: string[]) — Irreversibly send an interactive native iMessage poll to a chat.
- blooio_set_message_reaction(action: string, chat_id: string, reaction: string, direction?: string, message_id: string) — Add or remove a classic tapback or emoji reaction on a specific or relative message in a chat.
- blooio_update_contact(name: string, contact_id: string) — Set or clear the display name of an existing contact.
- blooio_update_group(name: string, group_id: string) — Rename a group and, when linked, synchronize the new name to its iMessage chat.

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

## Links
Docs: https://mcp.ai/docs/mcps/blooio
Website: https://mcp.ai/mcps/blooio