Communication Platform tools

These 22 tools call the same endpoints as the Communication Platform section of the API Reference. Each tool runs with the permissions of the Whippy user who authorized the connection and the OAuth scopes they granted.

The Behavior column comes from the MCP tool annotations Whippy publishes. Treat these labels as hints, not guarantees: they may omit external effects (for example, a Write tool can send a message to a recipient), and clients are not required to ask for confirmation before running a tool.

Calls

Tool	Behavior	Endpoint	What it does
`search_calls`	Read-only	POST `/v1/calls/search`	Searches voice call records (duration, direction, agent, contact, channel, voicemail, ratings).
`show_call`	Read-only	GET `/v1/calls/{id}`	Returns one call by ID (metadata, status, linked contact/conversation/agent). Resolve the ID with search_calls first.

Channels

Tool	Behavior	Endpoint	What it does
`add_user_to_channel`	Write (idempotent)	POST `/v1/channels/{id}/users`	Grants a user access to a channel. Requires channel ID and user ID (from search_users).
`list_channel_users`	Read-only	GET `/v1/channels/{id}/users`	Lists organization users who have access to a specific channel.
`list_channels`	Read-only	GET `/v1/channels`	Lists messaging channels (phone, WhatsApp, Messenger, Instagram, email, fax) for the organization.
`remove_user_from_channel`	Destructive (idempotent)	DELETE `/v1/channels/{id}/users/USER_ID`	Revokes a user's access to a channel. Requires channel ID and user ID.
`show_channel`	Read-only	GET `/v1/channels/{id}`	Returns one channel by ID, including working hours and settings. Resolve the ID with list_channels first.
`update_channel`	Destructive	PUT `/v1/channels/{id}`	Updates a channel's name, address, emoji, color, description, timezone, or business hours.

Conversations

Tool	Behavior	Endpoint	What it does
`search_conversations`	Read-only	POST `/v1/conversations/search`	Searches inbox conversations (threads) by contact, channel, status, assignee, or last-message time — not individual message bodies.
`show_conversation`	Read-only	GET `/v1/conversations/{id}`	Returns one conversation by ID plus a paginated subset of its messages (default 10, max 500).
`update_conversation`	Destructive	PUT `/v1/conversations/{id}`	Updates conversation metadata such as status (open/closed/spam/automated) or assignment. Does not send messages.
`upload_conversation`	Destructive	POST `/v1/conversations/upload`	Imports/uploads an external conversation transcript into Whippy. Not for sending live messages.

Messages

Tool	Behavior	Endpoint	What it does
`create_conversation_note`	Write	POST `/v1/messaging/note`	Adds an internal note to a conversation (not sent to the contact). Supports @user mentions.
`search_messages`	Read-only	POST `/v1/messages/search`	Searches organization messages (SMS, email, WhatsApp, notes, and more) with cursor pagination.
`send_email`	Write	POST `/v1/messaging/email`	Sends an email from an email channel (`from` = channel email or ID) to a recipient.
`send_fax`	Write	POST `/v1/messaging/fax`	Sends a fax via a fax channel. Resolve the channel with list_channels (type fax) first.
`send_sms`	Write	POST `/v1/messaging/sms`	Sends an SMS/MMS from a channel (`from`) to a phone (`to`). Creates the contact/conversation when needed.

Templates

Tool	Behavior	Endpoint	What it does
`create_template`	Write	POST `/v1/templates`	Creates a reusable message template. Not for automation templates (list_automation_templates) or forms.
`delete_template`	Destructive (idempotent)	DELETE `/v1/templates/{id}`	Deletes a message template. Confirm with show_template first.
`list_templates`	Read-only	GET `/v1/templates`	Lists reusable message templates (canned SMS/email bodies), not automation templates or forms.
`show_template`	Read-only	GET `/v1/templates/{id}`	Returns one message template by ID. Resolve the ID with list_templates.
`update_template`	Destructive	PUT `/v1/templates/{id}`	Updates a message template's body or metadata.