Kenso MCP tools

Ken Chats ken_chats

The Ken pane's chat history, shared in the workspace: list chats, read a chat's messages, and delete a chat. The ken-follow-ups operations are Ken checking back on a change made in Ken chat, and reminders: the caller's own pending ones. The ken-slack-reports operations list and stop the caller's recurring Slack reports. Workspace admins only; needs the ken_agent feature flag.

Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through ken_chats_read and changes through ken_chats_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: ken-follow-ups-cancel, ken-follow-ups-create, delete, get, list, ken-follow-ups-list, ken-slack-reports-list, list-messages, ken-slack-reports-stop

ken-follow-ups-cancel

Write. DELETE https://api.ken.so/v1/ken-follow-ups/{followUpId}

Path: followUpId

Cancel one of the caller's pending Ken follow-ups. Returns 204. Only on the user's request.

DELETE /api/v1/ken-follow-ups/{followUpId}. Internal. Sends Ken-Version 1.1 and
X-Ken-Actor: agent. The follow-up turns cancelled and is never sent. not_found
unless it is the caller's own pending follow-up in the workspace.

ken-follow-ups-create

Write. POST https://api.ken.so/v1/ken-follow-ups

Body (json): dueAt string, intent string, note string, slackTarget string, subjectId integer, subjectType string

Ask Ken to check back on a change, or to remind the caller about something. Workspace admins only on the MCP; needs the ken_agent flag.

POST /api/v1/ken-follow-ups. Internal. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
The follow-up belongs to the person whose credential makes the call. Ken delivers it
to that person in the app, and as a Slack DM when they turned Slack on for it.
intent: campaign_paused, campaign_resumed, campaign_launched, campaign_changed
  (subject_type campaign), inbox_paused, inbox_resumed (subject_type inbox), or
  reminder (a campaign, an inbox or no subject).
subject_type and subject_id go together.
note: only for a reminder, the person's own words, 300 characters at most.
due_at: an ISO 8601 time with Z or an offset (2026-11-03T20:00:00-05:00), in the
  future and at most 30 days out, kept exactly. Omit it and Ken checks back at 9:00
  on the person's next business morning; that automatic follow-up replaces their
  older automatic one for the same subject and intent.
Returns the follow-up: id, intent, subjectType, subjectId, dueAt (UTC), automatic,
status (pending), note, createdAt. validation_failed names the field; not_found
when follow-ups are off or the subject is not in the workspace; limit_reached at
20 pending follow-ups.

delete

Write. DELETE https://api.ken.so/v1/ken-chats/{kenChatId}

Path: kenChatId

Delete a Ken pane chat. Returns 204. Only on the user's request. Only the chat's author, a workspace admin or Ken staff may delete it.

DELETE /api/v1/ken-chats/{kenChatId}. Internal. Sends Ken-Version 1.1 and
X-Ken-Actor: agent. Soft delete: the chat leaves History for everyone in the
workspace and its eve session is never recreated. Anyone else is forbidden.
A support, Studio or Slack chat is not_found to anyone but its creator and
Ken staff, a workspace admin included. Requires the Ask permission and Edit
on Campaigns.

get

Read. GET https://api.ken.so/v1/ken-chats/{kenChatId}

Path: kenChatId

Return one Ken pane chat.

GET /api/v1/ken-chats/{kenChatId}. Internal. Sends Ken-Version 1.1 and
X-Ken-Actor: agent. Same fields as the list operation. A deleted chat,
another workspace's id, or a support, Studio or Slack chat someone else
created is not_found (Ken staff read every chat). Read the messages with the list-messages
operation. A support or Studio chat requires the Ask permission only; a ken or Slack
chat requires the Ask permission and Edit on Campaigns (forbidden without it).

list

Read. GET https://api.ken.so/v1/ken-chats

Query: cursor string, limit integer

List the workspace's Ken pane chats, most recently active first. Workspace admins only on the MCP; needs the ken_agent flag.

GET /api/v1/ken-chats. Internal. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
Ken pane chats are shared in the workspace. Ordered by updatedAt, newest first (a new
message moves a chat to the top). limit is 1 to 200 (default 50); pass the
previous page's pagination.nextCursor as cursor. Deleted chats are not listed.
Only Ken pane chats (kind ken) are listed. A support, Studio or Slack chat
is its creator's and Ken staff's only: any other caller, a workspace admin
included, gets not_found for it on every operation. Each chat: id, title, kind (ken|support|studio|slack),
eveSessionId, createdBy {kind: user|agent|api_key,
memberId, name}, messageCount, lastMessageAt, createdAt, updatedAt.
The route requires the Ask permission and Edit on Campaigns; view-only is forbidden.

ken-follow-ups-list

Read. GET https://api.ken.so/v1/ken-follow-ups

List the caller's pending Ken follow-ups, the soonest due first. Workspace admins only on the MCP; needs the ken_agent flag.

GET /api/v1/ken-follow-ups. Internal. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
Only the caller's own pending follow-ups in the workspace, at most 200, in one page
(pagination.hasMore is always false). Each: id, intent, subjectType (campaign|inbox),
subjectId, dueAt (UTC), automatic (Ken chose the time), status (pending), note
(a reminder's own words), slackTarget (the Slack thread it answers in), createdAt.
not_found while the ken_agent flag or follow-ups are off.

ken-slack-reports-list

Read. GET https://api.ken.so/v1/ken-slack-reports

List the caller's recurring Slack reports, the soonest next run first. Workspace admins only on the MCP; needs the ken_agent flag.

GET /api/v1/ken-slack-reports. Internal. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
Only the caller's own active reports in the workspace, at most 200, in one page
(pagination.hasMore is always false). Each: id, name, prompt (what Ken answers at each
run), postIn (channel|thread), slackTarget (where it was set up), every
(day|weekdays|week), at (HH:mm), weekday, timezone, schedule (in words), nextRunAt and
lastRunAt (UTC), status (active), createdAt. not_found while the ken_agent flag is off.

list-messages

Read. GET https://api.ken.so/v1/ken-chats/{kenChatId}/messages

Path: kenChatId

Query: cursor string, limit integer

List a Ken pane chat's messages, oldest first.

GET /api/v1/ken-chats/{kenChatId}/messages. Internal. Sends Ken-Version 1.1 and
X-Ken-Actor: agent. limit is 1 to 200 (default 50); pass the previous page's
pagination.nextCursor as cursor. Each message: id, kenChatId, externalId,
role (user, ken or approval), text, toolCalls [{tool, operation, status:
done|error, reason (why an error call failed, one plain line; null on a done
call and on calls saved before it was kept)}], answerIds [ans_<n>] ([] when none), durationMs, approval {tool,
operation, summary, decision: approved|dismissed}, attachments [{id, fileName,
kind: pdf|image|text|docx, contentType, sizeBytes}] (files on a user message,
[] when none), author {kind, memberId, name}, traceId (the turn's Langfuse
trace id, null when not recorded), createdAt. A deleted chat, or a support,
Studio or Slack chat someone else created, is not_found (Ken staff read
every chat). A support or Studio chat requires the Ask permission only; a ken
or Slack chat requires the Ask permission and Edit on Campaigns (forbidden
without it).

ken-slack-reports-stop

Write. DELETE https://api.ken.so/v1/ken-slack-reports/{reportId}

Path: reportId

Stop one of the caller's recurring Slack reports. Returns 204. Only on the user's request.

DELETE /api/v1/ken-slack-reports/{reportId}. Internal. Sends Ken-Version 1.1 and
X-Ken-Actor: agent. The report turns stopped and never runs again. not_found unless it
is the caller's own active report in the workspace.