MCP & AI Agent Integration

Heyy
automation.

12 AI agent actions for Heyy — callable from any MCP-compatible runtime, Claude, Cursor, or Cerebral OS workflow. Use Heyy to update contacts, move deals through pipelines, and trigger follow-up sequences automatically. Full governance, audit trail, and dry-run safety on every execution.

No credit card required
Live in production environments
<200ms median execution
Dry-run before production
Execution trace
live
12
actions
100%
governed
<200ms
latency
12
AI agent actions
4
Read operations
8
Write operations
1
High-risk actions (approval gated)
CRM Heyy is a CRM integration — use it to automate contact management, deals, and pipeline operations from any AI agent or MCP-compatible runtime.
Actions

What you can do
with Heyy.

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 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
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
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
MCP & Runtime API

Call Heyy
from any AI agent.

Any AI agent — Claude, Cursor, LangChain, AutoGen, or your own — can call Heyy actions through the Cerebral OS Runtime API. Governance, credentials, and audit trail fire automatically.

heyy:get_contact READ
# Call via Runtime API
curl
-X POST \
  "https://api.cerebralos.com/v1/runtime/actions/run"
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "verb": "heyy:get_contact",
    "args": {},
    "execution_id": "agent-001"
  }'
heyy:assign_conversation WRITE
# Dry-run first — no production risk
curl
-X POST \
  "https://api.cerebralos.com/v1/runtime/actions/run"
  -H "X-API-Key: YOUR_KEY" \
  -d '{
    "verb": "heyy:assign_conversation",
    "args": {},
    "execution_id": "agent-001",
    "metadata": {"dryRun": true}
  }'
Get your Runtime API key at app.cerebralos.com/signup — 1,000 free executions, no credit card required.
AI agent examples

What your AI agent
can do with Heyy.

Real patterns your AI agent can execute via MCP or the Runtime API. Every action governed, dry-run safe, and fully audited.

Trigger
AI agent needs Heyy data
Call heyy:get_contact via MCP or Runtime API
AI processes result and takes next action
Full execution logged to audit trail automatically
Trigger
Workflow needs to write to Heyy
Dry-run validates heyy:assign_conversation before execution
Approval gate fires if risk level is high
Action executes with full governance — logged, audited, reversible
Trigger
Lead or deal event
Score with AI
Route to right rep
Trigger outreach sequence
How it works

Every Heyy action
governed end-to-end.

Cerebral OS isn't a connector. It's the execution layer that sits in front of Heyy — adding governance, dry-run safety, and a full audit trail to every operation.

Governance first
Every verb carries a risk classification. High-risk writes require explicit approval gates before they execute in production.
Dry-run safe
Simulate any Heyy action before it touches production. See exactly what would happen before a single real call is made.
Immutable audit trail
Every Heyy action is logged — what ran, what changed, who approved it, when it happened. Full history on every verb, forever.
Connect with

Heyy works best
alongside these.

Build multi-step workflows that connect Heyy to the rest of your stack. All governed. All audited.

Heyy integration

Start free.
No credit card required.

Start free with 1,000 runs — no credit card required. Connect Heyy in minutes, dry-run every action before it touches production, full audit trail on everything.

Start free — 1,000 runs Browse all integrations →