Kenso MCP tools

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.