Kenso MCP tools

White Label white_label

Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through white_label_read and changes through white_label_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, client-credits-get, brand-update, client-seats-update

get

Read. GET https://api.ken.so/v1/white-label

Return the white-label settings of the current master workspace. Brand (with accent color), client-seat switches, hostname, email domain, plan limits, allocation, and children. Workspace admins and staff.

GET /api/v1/white-label. Internal (workspace admin and staff). Sends Ken-Version 1.1.
client_id is sent as X-Ken-Workspace-Id and must be a master workspace.
Requires the white-label permission (admins by default). 403 white_label_disabled when the feature is off.
403 white_label_master_only when the workspace is a child.
Fields: enabled, isMaster, brand {productName, logoUrl, faviconUrl,
accentColor}, clientSeats {readReplies},
hostname {hostname, status, cnameTarget, verificationRecord, verifiedAt,
lastCheckedAt, lastError}, emailDomain {domain, fromAddress, fromName, status, dnsRecords, verifiedAt},
plan, allocated, unallocated (each emails, leads, aiCredits, domains,
mailboxes; -1 is unlimited), children [{id, name, isActive, createdAt,
caps, usage}], and clientApprovalLinks (bool, on when never set; off makes
every external approval rule in the master and its children act as auto).
While custom email senders are on, also emailSender {configured, provider,
fromAddress, verifiedAt} (domain_setup operation white-label-email-sender-get
has the rest); omitted while the feature is off.
Status is none, pending, verified, or failed.
brand.accentColor is uppercase #RRGGBB, or null for Kenso's default #4F00D0.
The brand applies to the master and every child workspace.
clientSeats.readReplies (default false): the Client role can read and reply
in the inbox. It is set on the master and children inherit it.

client-credits-get

Read. GET https://api.ken.so/v1/white-label/client-credits

Return the master's client credits: balance, reserved for clients, free, and each client's credits this month. Workspace admins and staff. Amounts are millicredits (1 credit = 1,000).

GET /api/v1/white-label/client-credits. Internal (workspace admin and staff).
Sends Ken-Version 1.1. client_id is sent as X-Ken-Workspace-Id and must be a
master workspace. 403 white_label_disabled when the feature is off, 403
white_label_master_only when the workspace is a child.
Fields: balanceMillicredits, availableMillicredits, reservedMillicredits (what
the monthly allowances still hold this month, an earmark that never blocks the
master's own spend), freeMillicredits (available minus reserved, at least 0),
overAllocatedMillicredits (the part of reserved that available, counted
from 0, does not cover: 0 to reserved, and 0 when exempt),
usedMillicredits, usdPerCredit ("0.02"), exempt (caps are not enforced and
used reads 0), periodStart, periodEnd (the master's billing month), children.
Each child: {workspaceId, name, mode (monthly_allowance or shared_pool),
monthlyCredits (whole credits), atLimit (pause or draw_from_parent),
unusedCredits (roll_over or return_to_parent), rolledOverMillicredits,
addedMillicredits, capMillicredits (monthly credits plus rolled over plus
added), usedMillicredits, reservedMillicredits (0 for shared_pool), status
(on_track, near_limit from 85% of the cap, at_limit), capChosen (false while
the client keeps the default row it got at creation, an intake submission
included: the agency has not picked a cap yet)}, ordered by workspaceId.

brand-update

Write. PATCH https://api.ken.so/v1/white-label/brand

Body (json): accentColor string, clientApprovalLinks boolean, productName string

Set or clear the white-label product name and accent color, or switch external approval links. Pass product_name and/or accent_color (#RRGGBB) to set them, or clear_product_name / clear_accent_color true to fall back to Kenso's. client_approval_links false turns external approvals off for the master and its children.

PATCH /api/v1/white-label/brand {productName, accentColor, clientApprovalLinks}.
Internal (workspace admin and staff). Sends Ken-Version 1.1. Requires
the white-label permission (admins by default) on a master workspace. Change one or more fields in one call; a
field you leave out is not sent and stays as it is. For each field pass the
value or its clear_* flag, not both. Clearing sends null: productName falls
back to Kenso, accentColor to Kenso's default #4F00D0.
accent_color is #RRGGBB in any case, checked here and sent uppercase. It is
the one brand color (buttons, links, the sign-in page and approval links)
for the master and every child workspace. White text on it needs a contrast
of at least 4.5:1, so very light colors are refused: 400 validation_failed
with error.details[0].field accentColor and code invalid (not a hex color)
or low_contrast (pick a darker color).
client_approval_links is sent only when passed; false makes every external
approval rule in the master and its children act as auto, true turns them
back on. The brand is written first, so a refused product name or accent
color leaves the switch unchanged.
Returns the brand block {productName, logoUrl, faviconUrl, accentColor};
read white_label(operation="get") for clientApprovalLinks.

client-seats-update

Write. PATCH https://api.ken.so/v1/white-label/client-seats

Body (json): readReplies boolean

Turn the "Clients can read replies" client-seat switch on or off. Set on the master workspace; every child inherits it.

PATCH /api/v1/white-label/client-seats {readReplies}. Internal (workspace
admin and staff). Sends Ken-Version 1.1. Requires the white-label permission (admins by default) on a master
workspace. read_replies is required.
read_replies (default false): the Client role's built-in permissions get
Inbox edit and reply. A workspace that edited its own Client template keeps
its edit. Applies where workspace permissions are on.
Errors: 403 white_label_disabled, 403 white_label_master_only.
Returns {readReplies}.