# Heyy — MCP server on mcp.ai
> Connect your Heyy account and use 13 tools for communication straight from your AI agent. Connect with your own API key. Connect with your customers on Whatsapp, SMS, Messenger and Instagram using automation.

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

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_heyy?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/heyy/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/heyy/<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/heyy/skill.md
Postman collection (v2.1): https://mcp.ai/heyy/postman.json

## Tools
- heyy_create_attribute(name: string, externalId: string, description?: string, isVisibleQuickEdit?: boolean, isVisibleContactCreate?: boolean, isVisibleContactsTable?: boolean) — Tool to create a new custom attribute for contacts in Heyy. Use when you need to add custom fields to track additional information about contacts, such as customer segments, preferences, or custom ide
- heyy_create_contact(email?: string, labels?: object[], lastName?: string, firstName?: string, attributes?: object[], phoneNumber?: string) — Tool to create a new contact in Heyy with optional details including first name, last name, email, phone number, labels, and custom attributes. Use when you need to add a new contact to your Heyy acco
- heyy_create_label(name: string) — Tool to create a new label for categorizing contacts in Heyy. Use when you need to organize contacts into categories or groups.
- heyy_create_webhook(url: string, type: string, tenant_id: string, channel_id?: string) — Tool to create a new webhook for receiving event notifications across multiple channels. Use when you need to set up real-time event notifications for messages.
- heyy_delete_attribute(attribute_id: string) — Tool to delete an attribute by its unique identifier. Use when you need to remove an attribute from the system.
- heyy_delete_label(label_id: string) — Tool to delete a label by its unique identifier. Use when you need to remove a label from the system.
- heyy_delete_webhook(webhook_id: string) — Tool to delete a webhook by its unique identifier. Use when you need to remove a webhook from Heyy.
- heyy_list_attributes() — Tool to retrieve all attributes available in the Heyy system. Use when you need to get a list of all attributes with their properties and visibility settings.
- heyy_list_automations(channel_id: string) — Tool to retrieve automation workflows for a specified channel. Use when you need to get all workflows configured for a channel.
- heyy_list_channels() — Tool to retrieve all available channels from the Heyy system. Use when you need to get a complete list of channels with their details including name, type, status, and timestamps.
- heyy_list_message_templates() — Tool to retrieve all message templates available in the Heyy system. Use when you need to view all existing templates for messaging.
- heyy_list_webhooks() — Tool to retrieve all API webhooks configured for the account. Use when you need to inspect or manage webhook configurations.
- heyy_update_webhook(url?: string, is_active?: boolean, webhook_id: string) — Tool to update a webhook's URL and active status. Use when you need to modify an existing webhook's endpoint or enable/disable it.

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

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