Kronos AI 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
  },
  credits:
    | { enabled: false }                      // credits are not active on this account
    | { enabled: false, unavailable: true }   // balance could not be read right now — retry later
    | {
        enabled: true,
        balance_total: number,
        included_balance: number,
        purchased_balance: number,
        included_allowance: number,
        included_renews_with_next_payment: boolean,
        included_expires_at: string | null,
        purchased_expires_at: string | null,
        low_balance: boolean,
        depleted: boolean,                    // agents are paused until credits are added
        rate_card: {
          reply: number,
          integration_call_surcharge: number,
          integration_surcharge_cap: number,
          voice_inbound_per_minute: number,
          voice_outbound_per_minute: number,
          reply_multiplier: number
        }
      },
  onboarding: { exists: boolean, is_first_onboarding: boolean, use_cases: string[] },
  agents: Array<{
    id: string,
    name: string,
    is_active: boolean,
    model_id: string | null,
    credits_per_reply: number | null          // null unless credits are enabled
  }>,
  integrations: Array<{ id: string, platform: string, account_name: string | null }>
}

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

{
  agent_id: string,
  prompt_offset?: number, // default 0
  prompt_limit?: number   // default 12000, max 50000
}

{
  name: string,
  description: string, // required, trimmed, 10-280 characters
  prompt?: string,
  is_active?: boolean  // default false: the agent is created inactive
}

{
  agent_id: string,
  name?: string,
  description?: string, // when supplied: trimmed, 10-280 characters
  prompt?: string, // replaces the whole prompt
  prompt_edits?: { find: string, replace: string }[], // 1-20 pairs
  is_active?: boolean, // true activates the agent, false deactivates it
  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
}

{
  kind?: "knowledge" | "resource" | "all", // default all
  agent_id?: string, // only items linked to this agent
  limit?: number     // per kind, default 50, max 100
}

{
  kind: "knowledge" | "resource",
  item_id: string,
  agent_id: string,
  linked: boolean // true links, false unlinks
}

{
  kind: "knowledge" | "resource",
  item_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 }'