Kronos MCP

{}

// JSON.parsed from result.content[0].text
{
  account: {
    user_id: string,
    display_name: string | null,
    company_name: string | null,
    onboarding_state: "onboarding" | "dashboard",
    onboarding_completed_at: string | null
  },
  counts: {
    agents_total: number,
    agents_active: number,
    integrations_total: number,
    connected_channels: string[],
    conversations_total: number,
    messages_7d: number,
    contacts_total: number,
    open_followups: number,
    pending_kron_cards: number,
    voice_calls_inbound_30d: number,
    voice_calls_outbound_30d: number
  },
  onboarding: { exists: boolean, is_first_onboarding: boolean, use_cases: string[] },
  agents: Array<{ id: string, name: string, is_active: boolean, model_id: string | null }>,
  integrations: Array<{ id: string, platform: string, account_name: string | null }>
}

{
  provider: "instagram" | "facebook" | "messenger" | "whatsapp" | "gmail" | "shopify" | "telegram" | "mcp",
  return_to?: string
}

{
  name: string,
  description?: string,
  prompt?: string
}

{
  agent_id: string,
  name?: string,
  description?: string,
  prompt?: string,
  is_active?: boolean,
  memory_level?: "disabled" | "simple" | "advanced" | "pro",
  followup_mode?: "disabled" | "classic" | "agentic" | "guided",
  temperature?: number
}

{
  target_type: "inbox",
  inbox_id: string,
  agent_id: string
}
// or
{
  target_type: "conversations",
  conversation_ids: string[],
  agent_id: string
}

{
  channel:         "whatsapp" | "instagram" | "messenger" | "telegram",
  integration_id?: string,        // UUID — required if you have >1 inbox on this channel
  recipient:       string | { chat_id: string },
                                  // Meta channels: plain string (wa_id | PSID)
                                  // Telegram: { chat_id: string } (int64 as decimal)
  message: {
    type: "text";
    text: string                  // max 4096 chars
  } | {
    type: "template";             // WhatsApp only
    template: {
      name:     string,
      language: string,           // e.g. "en_US"
      components?: Array<{ type, parameters?: object[] }>
    }
  } | {
    type: "media";
    media: {
      url:       string,
      mediaType: "image" | "video" | "audio" | "document",
      caption?:  string           // max 1024 chars
    }
  },
  tag?:             "CONFIRMED_EVENT_UPDATE" | "POST_PURCHASE_UPDATE"
                  | "ACCOUNT_UPDATE" | "HUMAN_AGENT",   // IG / Messenger >24h
  idempotency_key?: string        // 8..128 chars
}

{
  "content": [{
    "type": "text",
    "text": "{\"id\":\"wamid.HBgN...\",\"channel\":\"whatsapp\",\"status\":\"sent\",\"created_at\":\"2026-05-12T07:42:27.852Z\"}"
  }]
}

curl -X POST https://mcp.kronos.com.mx/v1 \
  -H "Authorization: Bearer $KRONOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id":      1,
    "method":  "tools/call",
    "params": {
      "name": "send_message",
      "arguments": {
        "channel":   "whatsapp",
        "recipient": "5215555555555",
        "message":   { "type": "text", "text": "Hi from MCP!" }
      }
    }
  }'

{
  channel?:        "whatsapp",      // implicit
  integration_id?: string,
  recipient:       string,
  template_name:   string,
  language:        string,          // e.g. "en_US"
  components?:     Array<{ type, parameters?: object[] }>,
  tag?:            "CONFIRMED_EVENT_UPDATE" | "POST_PURCHASE_UPDATE"
                 | "ACCOUNT_UPDATE" | "HUMAN_AGENT",
  idempotency_key?: string          // 8..128 chars
}

curl -X POST https://mcp.kronos.com.mx/v1 \
  -H "Authorization: Bearer $KRONOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id":      2,
    "method":  "tools/call",
    "params": {
      "name": "send_template",
      "arguments": {
        "recipient":     "5215555555555",
        "template_name": "appointment_reminder",
        "language":      "en_US",
        "components": [{
          "type": "body",
          "parameters": [
            { "type": "text", "text": "Maria" },
            { "type": "text", "text": "Tuesday at 10:00 AM" }
          ]
        }]
      }
    }
  }'

{ id: string }

curl -X POST https://mcp.kronos.com.mx/v1 \
  -H "Authorization: Bearer $KRONOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id":      3,
    "method":  "tools/call",
    "params":  { "name": "get_message", "arguments": { "id": "wamid.HBgN..." } }
  }'

{
  integration_id?: string,        // UUID — filter to a single inbox
  limit?:          number,        // 1..100, default 25
  cursor?:         string         // opaque, from prior response next_cursor
}

// JSON.parsed from result.content[0].text
{
  items: Array<{
    id:               string,
    integration_id:   string,
    channel:          "whatsapp" | "instagram" | "messenger" | "telegram",
    contact_name:     string | null,
    contact_handle:   string,            // wa_id | PSID | telegram chat_id
    last_message_at:  string | null,     // ISO timestamp
    created_at:       string
  }>,
  next_cursor: string | null              // null when no more pages
}

curl -X POST https://mcp.kronos.com.mx/v1 \
  -H "Authorization: Bearer $KRONOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id":      4,
    "method":  "tools/call",
    "params":  { "name": "list_conversations", "arguments": { "limit": 25 } }
  }'

{
  integration_id?: string,        // UUID — required if you have multiple WA inboxes
  status?:         "APPROVED" | "PENDING" | "REJECTED" | "PAUSED"
}

curl -X POST https://mcp.kronos.com.mx/v1 \
  -H "Authorization: Bearer $KRONOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id":      5,
    "method":  "tools/call",
    "params":  { "name": "list_templates", "arguments": { "status": "APPROVED" } }
  }'

{
  query:    string,         // 1..500 chars, trimmed server-side
  limit?:   number,         // 1..20, default 5
  doc_slug?: string         // restrict to one doc; ^[a-z][a-z0-9-]*$
}

{
  items: Array<{
    doc_slug:     string,
    doc_title:    string,
    doc_category: "getting-started" | "products" | "integrations"
                | "billing" | "security" | "developer",
    section:      string | null,    // H2/H3 heading, null for preamble
    content:      string,           // chunk text as embedded
    score:        number            // 1 - cosine_distance, ~[0, 1]
  }>
}

curl -X POST https://mcp.kronos.com.mx/v1 \
  -H "Authorization: Bearer $KRONOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id":      6,
    "method":  "tools/call",
    "params":  {
      "name": "search_docs",
      "arguments": {
        "query": "how do I connect a WhatsApp business inbox",
        "limit": 3
      }
    }
  }'

curl -X POST https://api.kronos.com.mx/v1/docs/search \
  -H "Content-Type: application/json" \
  -d '{ "query": "send a template message", "limit": 5 }'