Every action below is available as an MCP tool and a verb in Cerebral OS — callable from any AI agent, Claude, Cursor, Windsurf, or your own runtime via the BYOA API. All executions are governed, audited, and dry-run safe.
Assign Conversation
heyy:assign_conversation
Assign a conversation to a specific agent.
Write
Medium risk
Close Conversation
heyy:close_conversation
Close a conversation and optionally send a final message.
Write
Medium risk
Create Contact
heyy:create_contact
Create a new contact in Heyy with profile information.
Write
Medium risk
Create Conversation
heyy:create_conversation
Create a new conversation with a contact.
Write
Medium risk
Delete Contact
heyy:delete_contact
Permanently delete a contact and all associated data.
Write
High risk
Get Contact
heyy:get_contact
Fetch a single contact by ID with all profile information and conversation history.
Read
Low risk
Get Conversation
heyy:get_conversation
Fetch a single conversation by ID with messages and participant information.
Read
Low risk
List Contacts
heyy:list_contacts
List contacts with optional filtering and pagination.
Read
Low risk
List Conversations
heyy:list_conversations
List conversations with optional filtering and pagination.
Read
Low risk
Send Message
heyy:send_message
Send a message in an existing conversation.
Write
Medium risk
Update Contact
heyy:update_contact
Update an existing contact's profile information.
Write
Medium risk
Update Conversation
heyy:update_conversation
Update an existing conversation's properties.
Write
Medium risk