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.
Get Articles
reamaze:get_articles
Retrieve knowledge base articles from Re:amaze. Use this to search help documentation, FAQs, and support articles. Useful for AI to reference when answering customer questions.
Read
Low risk
Get Conversation
reamaze:get_conversation
Execute get_conversation action via reamaze
Read
Low risk
Get Conversations
reamaze:get_conversations
Get conversations from Re:amaze with filtering and sorting. Common use cases: (1) Get oldest conversation waiting for response: {filter: "open", tag: "assigned-to-ben", sort: "updated", page_size: 10} then take LAST item in conversations array. (2) Get all open unassigned tickets: {filter: "unassigned"}. (3) Get all conversations for a customer: {for: "customer@example.com"}. Note: sort: "updated" returns NEWEST FIRST, so oldest conversation is at END of array.
Read
Low risk
Get Customer
reamaze:get_customer
Execute get_customer action via reamaze
Read
Low risk
Get Macros
reamaze:get_macros
Execute get_macros action via reamaze
Read
Low risk
Search Conversations
reamaze:search_conversations
Execute search_conversations action via reamaze
Read
Low risk
Add Note
reamaze:add_note
Add an internal staff note to a conversation (customers cannot see these notes). This is a convenience wrapper for creating a message with visibility=1 (internal). Use this for staff communication, NOT for customer-facing replies.
Write
Low risk
Apply Macro
reamaze:apply_macro
Apply a canned response/macro/template to a conversation with variable substitution. Re:amaze calls these "Response Templates" - this is the standard macro/canned response system. IMPORTANT: Provide EITHER template_id OR template_name (not both). template_id is more efficient. Variables like {{customer_name}} and {{order_id}} are automatically replaced with values from props.variables. Returns the customized message body that was sent to the conversation.
Write
Medium risk
Assign Conversation
reamaze:assign_conversation
Assign a conversation to a specific staff member. This is a convenience wrapper for updating conversation with assignee field. CRITICAL: Use this to escalate tickets to humans when AI cannot complete the task.
Write
Low risk
Create Contact Note
reamaze:create_contact_note
Add a staff note to a customer's contact profile (not to a specific conversation). These notes are visible to all staff members when viewing the customer's profile. Use this for permanent customer information that should persist across all conversations.
Write
Low risk
Create Conversation
reamaze:create_conversation
Create a new Re:amaze conversation/ticket on behalf of a customer. This is useful for creating tickets from custom forms, API integrations, or automated systems. The conversation will appear as if the customer initiated it.
Write
Medium risk
Create Message
reamaze:create_message
Create a new message (reply) in an existing Re:amaze conversation. CRITICAL: This is the primary way for AI to respond to customer tickets. Use visibility='public' for customer-facing replies, visibility='internal' for staff notes.
Write
Medium risk
Merge Contact
reamaze:merge_contact
Merge duplicate customer profiles
Write
Medium risk
Set Reminder
reamaze:set_reminder
Execute set_reminder action via reamaze
Write
Low risk
Update Contact
reamaze:update_contact
Execute update_contact action via reamaze
Write
Low risk
Update Conversation
reamaze:update_conversation
Update a Re:amaze conversation/ticket. Use this to assign tickets, change status, or update tags. CRITICAL: When cerebral cannot complete a task, use assignee_email to escalate to a human. Only provide fields you want to change - others remain unchanged.
Write
Low risk