HeyCMO REST API

Integrate HeyCMO into your own apps, dashboards, and workflows via HTTP.

Base URL

https://brain.heycmo.ai/mcp/YOUR_CUSTOMER_ID

Authentication

All requests require your API key in the Authorization header:

Authorization: Bearer hcmo_live_YOUR_API_KEY

Call a Tool

POST /tools/call
Content-Type: application/json

{
  "tool": "TOOL_NAME",
  "args": { ... }
}

Examples

Ask the CMO a question

curl -X POST https://brain.heycmo.ai/mcp/YOUR_ID/tools/call \
  -H "Authorization: Bearer hcmo_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "ask_cmo",
    "args": {
      "question": "What should I post about this week?"
    }
  }'

Run daily research

curl -X POST https://brain.heycmo.ai/mcp/YOUR_ID/tools/call \
  -H "Authorization: Bearer hcmo_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "run_research",
    "args": {
      "date": "2026-03-19"
    }
  }'

Generate a carousel

curl -X POST https://brain.heycmo.ai/mcp/YOUR_ID/tools/call \
  -H "Authorization: Bearer hcmo_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "generate_carousel",
    "args": {
      "slides": [
        {"text": "Tip 1: Start with keywords"},
        {"text": "Tip 2: Write the hook first"},
        {"text": "Tip 3: Add a clear CTA"}
      ],
      "template": "tip"
    }
  }'

Get analytics report

curl -X POST https://brain.heycmo.ai/mcp/YOUR_ID/tools/call \
  -H "Authorization: Bearer hcmo_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "tool": "run_analytics",
    "args": {
      "period": "last_7_days"
    }
  }'

Available Tools