Kenso MCP tools

Onboarding onboarding

Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through onboarding_read and changes through onboarding_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: get, connect-plan-get, next-step-get, update

get

Read. GET https://api.ken.so/v1/onboarding

Read the signed-in person's onboarding: flow, step, path, role, build id and answers. Works before the person has a workspace. Full docs: describe_tools(['api_onboarding_get'])

GET /api/v1/onboarding. Sends Ken-Version 1.1, and X-Ken-Workspace-Id when client_id is set.
Returns segment, step, callBookedAt, selectedMcpClient, completedAt, checklistDismissed,
connected, prefill, flow (classic, v4 or v5), lane and answers. On flow v5 with a
workspace it also returns path (self_serve, pricing, referral, affiliate, partner, list,
claim, social, switcher, mcp, recruiting, agency, performance, teammate or client_seat),
role (owner, admin, editor, member or client), buildId (obd_<n>, the workspace's current
onboarding build; read it with onboarding_builds get) and performanceOffer (none, soft or
offer). Unset fields are omitted.

connect-plan-get

Read. GET https://api.ken.so/v1/onboarding/connect-plan

Return the Connect to launch plan: six categories, vendors and the setup score.

GET /api/v1/onboarding/connect-plan. Internal. Sends Ken-Version 1.1.
client_id is sent as X-Ken-Workspace-Id. Any member; needs onboarding_v5.
Categories in fixed order minus what the path drops; LinkedIn is locked
until a paid plan; setupScore.value is 0 to 100.

next-step-get

Read. GET https://api.ken.so/v1/onboarding/next-step

Return the signed-in person's one next step in onboarding. Internal. Behind the onboarding_v5 flag (404 when it is off).

GET /api/v1/onboarding/next-step. Internal. Sends Ken-Version 1.1.
client_id is sent as X-Ken-Workspace-Id when given. Without it the API uses the
caller's only workspace and answers 400 workspace_required when there are several.
Returns kind, title, detail, count, of, action {label, href, kind}, helpAssetId,
audience, waitingOnKen {what, etaSeconds} and computedAt. A person who is not
onboarding in v5 gets kind all_done.
Not a pure read: for a person onboarding in v5 it also records, once, what the
workspace's state already shows (the step on the build, the onboarding task and
closer events, the Performance question when due) and, for the build's owner who
answered auto_after_samples, turns the plan's remaining touches to auto approval
once the samples are approved. A repeat call records nothing new.

update

Write. PATCH https://api.ken.so/v1/onboarding

Body (json): answers any JSON, callBookedAt string, checklistDismissed boolean, completedAt string, lane string, replay boolean, segment string, selectedMcpClient string, step string

Save the signed-in person's onboarding step and answers. Unset fields stay as they are. Works before the person has a workspace. Full docs: describe_tools(['api_onboarding_update'])

PATCH /api/v1/onboarding. Sends Ken-Version 1.1, and X-Ken-Workspace-Id when client_id is set.
step: a step key, for the v5 flow chat, read, wow, connect, paywall or launched.
answers: the whole answers object (it replaces the stored one), at most 262,144 bytes,
for v5 {"version": 2, "persona": ..., "experience": ..., "goal": ..., "entry": {...}}.
lane: before_launch or after_launch. segment: new_to_outbound, experienced or expert_ai.
selected_mcp_client: the AI client chosen on the connect step (claude-code, cursor, ...).
checklist_dismissed: true hides the getting-started checklist.
completed_at: ISO-8601 instant onboarding finished. Returns the saved progress in the
onboarding get shape; path, role, buildId and performanceOffer come only from onboarding get.