Analytics Events analytics_events
Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through analytics_events_read. Each takes operation plus that operation's parameters, and your workspace role decides which operations you see.
Each operation with a route calls the Kenso API at https://api.ken.so with Authorization: Bearer <Kenso API key>, Ken-Version: 1.1 and X-Ken-Workspace-Id: <workspace id>. You can call that route directly with the same headers.
Operations: get-deliverability-gates, credit-savings-rows-list, event-subscriptions-list, event-occurrences-poll, breakers, cohort_drift, overlays, rate_explain
get-deliverability-gates
Read. GET https://api.ken.so/v1/analytics/deliverability-gates
Query: limit integer
Return the bounce gates Ken enforces and an ok, watch or over verdict per domain and inbox for the last 24 hours. Public. Read-only. Each row has its sends, hard bounces, bounce rate and isSmallSample.
GET /api/v1/analytics/deliverability-gates. Public. Sends Ken-Version 1.1. client_id is sent as X-Ken-Workspace-Id. Requires Campaigns view. Counts the last 24 hours (windowHours, from, to) of accepted cold and 1:1 sends and hard bounces, the way the sequencer's bounce signal counts them. inboxGate and domainGate are the thresholds the sequencer enforces (threshold as a fraction, minSends, minBounces), read from its live settings: inbox rows use the inbox block gate, domain rows the campaign pause gate (Kenso has no domain-level bounce block). verdict is over when bounceRate is strictly above threshold with at least minSends sends and minBounces hard bounces, watch when it is not over and bounceRate is at or above 80% of threshold, and ok otherwise. isSmallSample is true under minSends sends: such a row is never over, so judge it on its counts. isEnforced is true when the sequencer blocks inboxes and pauses campaigns on these gates (false: it only records them); it judges over enforcedWindowHours, not 24 hours. Domain rows: domainId (omitted for a domain with no managed domain), domainName, inboxCount, sentCount, bounceCount, bounceRate, verdict, isSmallSample. A mailbox with no managed domain (OAuth, own SMTP) counts toward its address's domain, except on a free-mail provider such as gmail.com, where it has an inbox row only. Inbox rows: inboxId, email, domainId, domainName and the same counts. Rows are worst first (over, watch, ok, then by bounceRate). limit caps each list from 1 to 200 (API default 50); domainCount and inboxCount are the totals before it. Blocks Ken already applied are auto-pauses-list on the analytics tool.
credit-savings-rows-list
Read. GET https://api.ken.so/v1/credits/savings/rows
Query: cursor string, from date, item string, limit integer, to date
List the daily rows behind Free with Ken: one per UTC day, item and campaign, newest first, each valued at Clay's prices.
GET /api/v1/credits/savings/rows. Public. Sends Ken-Version 1.1 and X-Ken-Workspace-Id. Any member role except Client; a Client seat and a white-label client workspace get not_found. Read only. Same window as billing(operation="credit-savings-get"): from_date and to_date are inclusive UTC days (YYYY-MM-DD), to_date defaults to today and from_date to the first of to_date's month, at most 366 days. item keeps one item's rows: ken_db_email, email_verification, enrichment_person, enrichment_company, enrichment_tech_stack, website_page or launch_offer (ken_search_person is accepted and has no rows while Clay prices it at $0). Cursor list: limit (1..200, default 50) and cursor; read pagination.hasMore and pagination.nextCursor. Items: date, item, campaignId and campaignName (both omitted for work outside a campaign), units and valueUsdCents. Rows are sorted by date (newest first), then item, then campaign. Summed over the same window, each item's rows equal its valueUsdCents in credit-savings-get.
event-subscriptions-list
Read. GET https://api.ken.so/v1/event-subscriptions
Query: cursor string, limit integer
List your own MCP event webhook subscriptions in the current workspace. Public. Only the caller's subscriptions. The signing secret is never returned.
GET /api/v1/event-subscriptions. Sends Ken-Version 1.1 and X-Ken-Workspace-Id. Any workspace member. limit is 1 to 200, default 50. cursor is opaque: pass back pagination.nextCursor while pagination.hasMore is true. Each subscription: id (sub_...), name (the event type), arguments (its filters, such as campaignId and classification), url (where it delivers), status (active, expired or terminated; deleted subscriptions are not listed), refreshBefore (renew before this time or it expires), verifiedAt, deliveryStatus (active, lastDeliveryAt, lastError, failedSince), createdAt and updatedAt.
event-occurrences-poll
Read. GET https://api.ken.so/v1/event-occurrences
Query: campaignId integer, classification string, cursor string, limit integer, maxAgeMs integer, types string
Poll the workspace's MCP event log for events after a cursor. Public. Without cursor it returns no events and a fresh cursor. Pass back the cursor it returns.
GET /api/v1/event-occurrences. Sends Ken-Version 1.1 and X-Ken-Workspace-Id. Any workspace member. With event_types omitted, events whose group needs a page you cannot see (Accounts, Workflows, ...) are left out; an event_types entry you cannot see answers 403. cursor is opaque: pass back the data.cursor of the previous poll unchanged, never build one. Omitted, the poll starts from now: no events, and a cursor to poll with next time. event_types filters to these event type names (sent as types, comma-separated), for example ["meeting.booked", "reply.received"]; api_keys(operation="webhook-event-types-list") lists them (mcp true marks the MCP events). campaign_id and classification (a reply classification such as interested) narrow events that carry them. limit is 1 to 100, default 50. max_age_ms skips events older than that many milliseconds instead of replaying them. Returns data.events (each eventId, name, timestamp, data with thin ids, status and links, and its own cursor), data.cursor, data.hasMore, data.truncated and data.nextPollMs. hasMore true means more events are waiting: poll again at once with data.cursor. Otherwise wait nextPollMs milliseconds before the next poll. truncated true means events were skipped (older than max_age_ms, or no longer kept), so the log has a gap before these events.
breakers
Read.
S4.1 adaptive-control audit (AIMD overlays, breakers, rate explain, cohort drift).
Read the sequencer adaptive-control audit surface. Dark when
Sequencer:AdaptiveControl:Enabled=false (empty lists, dark=true).
Operations:
-----------
overlays:
GET /api/v1/analytics/adaptive-control/overlays
breakers:
GET /api/v1/analytics/adaptive-control/breakers
rate_explain:
GET /api/v1/analytics/adaptive-control/rate-explain
baseline -> rule -> overlay -> expiry
cohort_drift:
GET /api/v1/analytics/adaptive-control/cohort-drift
client_id is required and pinned on every request.
cohort_drift
Read.
S4.1 adaptive-control audit (AIMD overlays, breakers, rate explain, cohort drift).
Read the sequencer adaptive-control audit surface. Dark when
Sequencer:AdaptiveControl:Enabled=false (empty lists, dark=true).
Operations:
-----------
overlays:
GET /api/v1/analytics/adaptive-control/overlays
breakers:
GET /api/v1/analytics/adaptive-control/breakers
rate_explain:
GET /api/v1/analytics/adaptive-control/rate-explain
baseline -> rule -> overlay -> expiry
cohort_drift:
GET /api/v1/analytics/adaptive-control/cohort-drift
client_id is required and pinned on every request.
overlays
Read.
S4.1 adaptive-control audit (AIMD overlays, breakers, rate explain, cohort drift).
Read the sequencer adaptive-control audit surface. Dark when
Sequencer:AdaptiveControl:Enabled=false (empty lists, dark=true).
Operations:
-----------
overlays:
GET /api/v1/analytics/adaptive-control/overlays
breakers:
GET /api/v1/analytics/adaptive-control/breakers
rate_explain:
GET /api/v1/analytics/adaptive-control/rate-explain
baseline -> rule -> overlay -> expiry
cohort_drift:
GET /api/v1/analytics/adaptive-control/cohort-drift
client_id is required and pinned on every request.
rate_explain
Read.
S4.1 adaptive-control audit (AIMD overlays, breakers, rate explain, cohort drift).
Read the sequencer adaptive-control audit surface. Dark when
Sequencer:AdaptiveControl:Enabled=false (empty lists, dark=true).
Operations:
-----------
overlays:
GET /api/v1/analytics/adaptive-control/overlays
breakers:
GET /api/v1/analytics/adaptive-control/breakers
rate_explain:
GET /api/v1/analytics/adaptive-control/rate-explain
baseline -> rule -> overlay -> expiry
cohort_drift:
GET /api/v1/analytics/adaptive-control/cohort-drift
client_id is required and pinned on every request.