Kenso MCP tools

Account Views account_views

Personal saved filters for the Accounts list, one set per member: each view is a named list of filter conditions for the accounts search operation.

Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through account_views_read and changes through account_views_write. 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: accounts-assign-starter-set, create, delete, duplicate, list, update

accounts-assign-starter-set

Write. Early access: needs accounts on for the workspace. POST https://api.ken.so/v1/accounts/starter-set

Body (json): userId integer

Give a teammate up to 10 unowned accounts to start on, best first. Returns how many were assigned, how many they already owned, and the account ids. Safe to repeat.

POST /api/v1/accounts/starter-set. Staff. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
user_id: the member who gets the accounts; leave it out to assign to the caller.
Another member needs the Members permission (403 forbidden otherwise); an id
outside the workspace is 400 not_a_member. Picks unowned prospect accounts in
researching or warming, best tier first, then fit score, then signal score, and
makes the member their owner. Returns 200 with {assigned, alreadyOwned, accountIds};
accountIds are strings, best first. When the member already owns accounts nothing is
assigned: assigned is 0, alreadyOwned is how many of accountIds they own (up to 10),
and accountIds lists them. alreadyOwned is 0 otherwise; assigned 0 with
alreadyOwned 0 means no unowned account was free.

create

Write. Early access: needs accounts on for the workspace. POST https://api.ken.so/v1/account-views

Body (json): filters array, isActive boolean, name string

Save a new account view at the end of the calling member's strip. Returns 201. filters: [{field, operator: is|is_not, values}], as in accounts search.

POST /api/v1/account-views. Staff. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
name: 1 to 80 characters after trim; names may repeat. is_active=true makes the
new view the active one and clears every view's draft. A member keeps at most 50
views, the four defaults included (view_limit).
filters (optional): a list of {"field", "operator", "values"} conditions, for
example [{"field": "stage", "operator": "is", "values": ["engaged"]}]. Conditions
AND together; the values of one condition OR together. operator is is or is_not;
is_not also matches an account with no value for the field. One condition per
field; a condition with no values is dropped.
Fields and values:
- stage: new, researching, warming, engaged, meeting_booked, in_deal, onboarding, client, churned, nurture, paused, lost, network, not_a_fit, competitor, do_not_contact.
- stageGroup: to_sort, pipeline, customers, later, network, archive (the groups the stages
  sit in; see accounts list).
- committee: none_engaged, under_half, half_or_more (share of stakeholders with
  coverage engaged or planned).
- lastTouch: past_7_days, one_to_four_weeks, over_a_month, never.
- headcount: under_250, from_250_to_999, from_1000.
- industry, fundingRound: any text, exact match (values in use: accounts facets).
- signal: job_change, funding, hiring, public_post, event, asset_view, tech_change.
  Accounts with a signal of that kind whose event time (when it happened, else
  when Ken found it) is in the last 90 days; job_change also matches
  leadership_hire. is_not matches accounts with none of them.
- latestSignal: the latest signal's event time in the lastTouch buckets:
  past_7_days, one_to_four_weeks, over_a_month, never (no signal or not scored).
- hasOpenOpportunity: true (a live opportunity in an open stage) or false.
last_touch, funding_round, latest_signal and has_open_opportunity are accepted for
lastTouch, fundingRound, latestSignal and hasOpenOpportunity.

delete

Write. Early access: needs accounts on for the workspace. DELETE https://api.ken.so/v1/account-views/{accountViewId}

Path: accountViewId

Delete one of the calling member's account views. Returns 204. Only on the user's request. The default view cannot be deleted.

DELETE /api/v1/account-views/{accountViewId}. Staff. Sends Ken-Version 1.1 and
X-Ken-Actor: agent. Deleting the active view makes the default view active with
no draft. Later views move up one position. The default view is default_view.

duplicate

Write. Early access: needs accounts on for the workspace. POST https://api.ken.so/v1/account-views/{accountViewId}/duplicate

Path: accountViewId

Copy a view as '{name} copy', right after it. Returns 201 with the copy.

POST /api/v1/account-views/{accountViewId}/duplicate. Staff. Sends Ken-Version 1.1
and X-Ken-Actor: agent. The copy takes the source's saved filters, not its draft.
It becomes the active view, with every draft cleared, when the source was active.
The default view cannot be duplicated (default_view).

list

Read. Early access: needs accounts on for the workspace. GET https://api.ken.so/v1/account-views

Query: timeZone string

List the calling member's saved account views, in strip order. Exactly one is active; only it can carry draftFilters.

GET /api/v1/account-views. Staff. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
Views are personal: one set per member per workspace. The first call creates four
views: All (the default view, active, no filters), Fresh signals (signal is
job_change or funding), Heating up (latestSignal is past_7_days) and Thin committee
(committee is none_engaged or under_half, and stage is not researching or
nurture). At most 50 views in one page (pagination.hasMore is always false).
Each view: id, name, filters, draftFilters (unsaved edits, omitted when none),
isDefault, isActive, position (0-based), accountCount, createdAt, updatedAt.
accountCount counts accounts that pass the saved filters, not the draft. Run the
accounts search operation with the view's filters for the list itself. time_zone: an
IANA zone the counts' day buckets count in, as on the accounts search operation.

update

Write. Early access: needs accounts on for the workspace. PATCH https://api.ken.so/v1/account-views/{accountViewId}

Path: accountViewId

Body (json): draftFilters array, filters array, isActive boolean, name string

Rename a view, save or draft its filters, or make it the active view. changes keys: name, filters, draft_filters (null clears), is_active (true only).

PATCH /api/v1/account-views/{accountViewId}. Staff. Sends Ken-Version 1.1 and
X-Ken-Actor: agent. Absent keys stay unchanged.
- name: 1 to 80 characters after trim. Cannot be null.
- filters: saves the view's conditions (null or [] = none) and clears its draft,
  unless draft_filters is in the same changes.
- draft_filters: unsaved conditions; null clears them. Only the view that is
  active after this call can hold a draft (view_not_active otherwise).
- is_active: only true, which makes this the active view and clears every other
  view's draft.
Conditions are the same as in the create operation. The default view (isDefault)
keeps its name and filters (default_view) but can hold a draft. Another member's
view is not_found.