Kenso MCP tools

Referrals referrals

Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through referrals_read and changes through referrals_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: referral-redemptions-create, referral-codes-get, referral-codes-update

referral-redemptions-create

Write. POST https://api.ken.so/v1/referrals/redemptions

Body (json): code string

Redeem another workspace's referral code for this workspace. Both workspaces get credits when this workspace first launches on a paid plan. Requires the `members` permission.

POST /api/v1/referrals/redemptions. Internal. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
Body {code}; the code is trimmed and uppercased. Returns {id, status}; the same code again
returns the same redemption. 422 referral_invalid with details[0].code unknown_code,
self_referral, window_passed (workspace older than 30 days), already_paid or already_redeemed.

referral-codes-get

Read. GET https://api.ken.so/v1/referrals/code

Return this workspace's referral code and link, made on first read. Open to any workspace member while the referrals flag is on for the workspace.

GET /api/v1/referrals/code. Internal. Sends Ken-Version 1.1.
client_id is sent as X-Ken-Workspace-Id.
Fields: id (rc_), code, url (https://app.ken.so/r/<code>), showReferrerName,
rewards {credits, usdCents} (each side's credits on the referred workspace's first paid launch),
redemptions {pending, rewarded}.

referral-codes-update

Write. PATCH https://api.ken.so/v1/referrals/code

Body (json): showReferrerName boolean

Show or hide this workspace's name on its referral landing page. Requires the `members` permission.

PATCH /api/v1/referrals/code. Internal. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
Body {showReferrerName}. The landing shows the workspace's brand name, else its workspace name;
never a person. Returns the same fields as referral-codes.get.