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.
Close Conversation
convolo_ai:close_conversation
Close an active conversation with optional final message and reason.
Write
Medium risk
Create Bot
convolo_ai:create_bot
Create a new conversational bot.
Write
Medium risk
Create Contact
convolo_ai:create_contact
Create a new contact in the system.
Write
Medium risk
Create Conversation
convolo_ai:create_conversation
Create a new conversation between a contact and bot.
Write
Medium risk
Delete Bot
convolo_ai:delete_bot
Permanently delete a bot and all associated data.
Write
High risk
Get Bot
convolo_ai:get_bot
Fetch a single bot by ID with configuration and stats.
Read
Low risk
Get Contact
convolo_ai:get_contact
Fetch a single contact by ID with conversation history summary.
Read
Low risk
Get Conversation
convolo_ai:get_conversation
Fetch a single conversation by ID with participant details and message count.
Read
Low risk
List Bots
convolo_ai:list_bots
List bots with filtering and pagination.
Read
Low risk
List Contacts
convolo_ai:list_contacts
List contacts with search, filtering, and pagination.
Read
Low risk
List Conversations
convolo_ai:list_conversations
List conversations with filtering and pagination.
Read
Low risk
List Messages
convolo_ai:list_messages
List messages in a conversation with filtering and pagination.
Read
Low risk
Send Message
convolo_ai:send_message
Send a message in an existing conversation.
Write
Medium risk
Transfer Conversation
convolo_ai:transfer_conversation
Transfer an active conversation to a different bot with context.
Write
Medium risk
Update Bot
convolo_ai:update_bot
Update bot configuration and training data.
Write
Medium risk
Update Contact
convolo_ai:update_contact
Update contact information and settings.
Write
Medium risk
Update Conversation
convolo_ai:update_conversation
Update conversation status, tags, metadata, or transfer to different bot.
Write
Medium risk