Kenso MCP tools

Website website

Your website's Kenso script (ken.js): the snippet, allowed domains, consent mode and visitor ID provider, the pages you tag as high intent with their points, and the human visits it saw. Also the outbound site: the rebuilt home page your outbound domains show, its fields, refresh, versions and preview.

Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through website_read and changes through website_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: outbound-site-domain-get, outbound-site-get, get, pages-create, pages-delete, pages-list, pages-update, outbound-site-preview, outbound-site-refresh, rotate-key, outbound-site-update, update, outbound-site-versions-list, outbound-site-versions-restore, visits-list

outbound-site-domain-get

Read. Early access: needs domain_pages on for the workspace. GET https://api.ken.so/v1/domains/{domainId}/website

Path: domainId

Read what people see on one domain: mode (unset, redirect or page), the live page version, and each hostname's page status, attach path and why it is unsupported.

GET /api/v1/domains/{domainId}/website. Needs the domain_pages flag (404 while it is off) and Delivery view.
Sends Ken-Version 1.1. A domain outside the workspace is not_found.
data: domainId, mode, currentVersionId, hostnames. mode unset means nobody answered: the domain keeps its
redirect. To change it, ask the person "What should people see when they open these domains? A rebuild of your website (recommended) or a redirect to your website?" and pass their answer to domains(operation="update", domain_id=..., changes={"website_mode": ...}); never
choose for them.
hostnames[] (apex first, then www; empty until Kenso has checked the domain): hostname, attachPath
(worker_route, custom_hostname, or null when the domain cannot show the page), dnsWriterKind (kenso when
Kenso writes the hostname's DNS, else other; null when Kenso cannot write it; prefer it over dnsWriter), status
(detached, attaching, active, detaching or failed), sslStatus, unsupportedReason, checkedAt,
lastError (one short sentence on why Kenso's last attach or detach failed, null when it did not) and
stopped (true when Kenso stopped retrying after repeated failures). For a stopped hostname tell the person
"Ken stopped trying: <lastError>. Switch to redirect and back to retry."
currentVersionId is the workspace's live page version, absent until the page was first published.

Example: website(operation="outbound-site-domain-get", domain_id=14, client_id=7)

outbound-site-get

Read. Early access: needs domain_pages on for the workspace. GET https://api.ken.so/v1/outbound-site

Read the workspace's outbound site: the page its outbound domains show, its fields and the latest build.

GET /api/v1/outbound-site. Needs the domain_pages flag (404 while it is off) and Delivery view. Sends Ken-Version 1.1.

data: mainSiteUrl (the profile's own URL or null), effectiveMainSiteUrl (mainSiteUrl, else the workspace website;
a Kenso brand site other than getken.ai becomes the Kenso cold root https://getken.ai),
brandName, contactEmail, legalName, postalAddress, showMainSiteLink, currentVersion {id, source (generated,
regenerated_with_note or restored), note, htmlBytes, assetBytes, rounds, model, isBelowThreshold, isCurrent, runId,
createdByUserId, createdAt} or null before the first build, latestRun {id, status (queued, running, succeeded,
failed or canceled), trigger, note, versionId, error, requestedByUserId, createdAt, startedAt, finishedAt} or null.
A read never creates anything.

Example: website(operation="outbound-site-get", client_id=7)

get

Read. Early access: needs website_signals on for the workspace. GET https://api.ken.so/v1/website

Get the workspace's website setup: the script snippet, domains, consent and provider. Read only: a workspace with no site gets data.configured false and no snippet.

GET /api/v1/website. Staff. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
Never creates the site. A workspace with no site yet gets data.configured false,
the defaults a new site gets (provider none, no domains, consentMode eu,
defaultPoints 10) and an empty data.siteKey and data.snippet; the first website
update (any field, for example changes={"consent_mode": "eu"}), rotate-key or
page create sets the site up and returns its snippet. data.configured is true once it exists.
Returns data.siteKey, data.snippet (the script tag to paste before </head>),
data.domains, data.consentMode (eu: visitors in the EU, EEA and UK wait for consent;
all: every visitor waits), data.matchCompaniesBeforeConsent, data.defaultPoints
(points a known person's visit to an untagged page gives, 0 to 50), data.provider
(none, rb2b, vector, snitcher, warmly or ken), data.providerWebhookUrl (the URL to paste
into rb2b, Vector, Snitcher or Warmly while one of them is the provider; null for none or ken),
data.status (receiving when the script sent an event in the last 7 days, else
not_installed), data.lastEventAt and data.publishedAt.

pages-create

Write. Early access: needs website_signals on for the workspace. POST https://api.ken.so/v1/website/pages

Body (json): label string, pattern string, points integer

Tag a website page as high intent, such as /pricing (label Pricing, 25 points). Republishes the site config the script reads.

POST /api/v1/website/pages. Staff. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
pattern: starts with /, at most 500 characters, no spaces, * only as the last
character (/docs/* matches every page under /docs/). label: 1 to 100 characters.
points: 0 to 50 (default 10). At most 50 tagged pages and no two with the same
pattern (validation_failed with codes limit_reached and duplicate). Needs the
workspace_settings permission. Returns the page.

pages-delete

Write. Early access: needs website_signals on for the workspace. DELETE https://api.ken.so/v1/website/pages/{pageId}

Path: pageId

Remove a tagged page. Its past visits keep their points. Republishes the site config the script reads.

DELETE /api/v1/website/pages/{pageId}. Staff. Sends Ken-Version 1.1 and
X-Ken-Actor: agent. The pattern can be tagged again afterwards. Needs the
workspace_settings permission. A page that is already removed is not_found.

pages-list

Read. Early access: needs website_signals on for the workspace. GET https://api.ken.so/v1/website/pages

List the website's tagged pages, oldest first (at most 50, one page).

GET /api/v1/website/pages. Staff. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
Each page: id, pattern (an exact path such as /pricing, or a prefix ending in * such
as /docs/*), label, points (0 to 50, what a visit to it gives), createdAt, updatedAt.

pages-update

Write. Early access: needs website_signals on for the workspace. PATCH https://api.ken.so/v1/website/pages/{pageId}

Path: pageId

Body (json): label string, pattern string, points integer

Change a tagged page's pattern, label or points. Absent keys stay unchanged. Republishes the site config the script reads.

PATCH /api/v1/website/pages/{pageId}. Staff. Sends Ken-Version 1.1 and
X-Ken-Actor: agent. changes keys: pattern, label, points, with the rules of
pages-create. Another tagged page's pattern fails with validation_failed (code
duplicate). Needs the workspace_settings permission. Returns the page.

outbound-site-preview

Read. Early access: needs domain_pages on for the workspace. GET https://api.ken.so/v1/outbound-site/preview

Query: domainId integer (required)

Get a signed link to the live page as one domain serves it, valid for one hour.

GET /api/v1/outbound-site/preview?domainId=. Needs the domain_pages flag and Delivery view. Sends Ken-Version 1.1.
domain_id is a domain of the workspace (domains(operation="list")). data: url (a signed link on Kenso's edge that
renders the current version with the slots filled for that domain) and expiresAt (one hour; ask again after it).
404 when the domain is not the workspace's or nothing is published yet; 503 when previews are not configured.

Example: website(operation="outbound-site-preview", domain_id=5, client_id=7)

outbound-site-refresh

Write. Early access: needs domain_pages on for the workspace. POST https://api.ken.so/v1/outbound-site/refresh

Body (json): note string

Rebuild the page from the live website, optionally with an instruction. Answers with the queued build.

POST /api/v1/outbound-site/refresh. Needs the domain_pages flag and Delivery edit. Sends Ken-Version 1.1.
note (optional, at most 1000 characters) is an instruction for the rebuild, such as "drop the pricing section".
Answers 202 with the run {id, status queued, trigger refresh or refresh_with_note, ...}; the page changes when the run
succeeds (poll outbound-site-get, latestRun). run_in_progress (409) while a build is queued or running;
website_missing (409) when neither main_site_url nor the workspace website is set (set main_site_url first).
Each queued build counts on the workspace's outboundSiteRefresh quota: 3 a day and 10 in 30 days. Past it the call
fails with quota_exceeded (429), queues nothing, and the error names the limit and when it resets ("This workspace
reached its limit of 3 page rebuilds in a day. ... It resets at <time>."): tell the user that time and do not retry
before it.

Example: website(operation="outbound-site-refresh", note="drop the pricing section", client_id=7)

rotate-key

Write. Early access: needs website_signals on for the workspace. POST https://api.ken.so/v1/website/rotate-key

Replace the site key: the installed snippet stops working until it is replaced. Only on the user's explicit request. Identity links already sent stop identifying visitors.

POST /api/v1/website/rotate-key. Staff. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
Issues a new site key and identity secret, deletes the old key's config at the edge
and publishes the new one. Returns the site with the new siteKey and snippet, which
the user must paste in place of the old one. Needs the workspace_settings permission.

outbound-site-update

Write. Early access: needs domain_pages on for the workspace. PATCH https://api.ken.so/v1/outbound-site

Body (json): brandName string, contactEmail string, legalName string, mainSiteUrl string, postalAddress string, showMainSiteLink boolean

Change the outbound site's fields. Absent keys stay unchanged; null clears a text field. The live page updates at once, without a rebuild.

PATCH /api/v1/outbound-site. Needs the domain_pages flag and Delivery edit. Sends Ken-Version 1.1.
changes keys (snake_case or camelCase): main_site_url (absolute http or https URL, at most 2048; null uses the
workspace website), brand_name (at most 200), contact_email (one address, such as hello@acme.com), legal_name (at
most 200), postal_address (at most 500), show_main_site_link (true or false, never null). A bad field fails with
validation_failed and one detail per field; nothing is saved. The first write creates the outbound site. Returns the
outbound site, as outbound-site-get does. service_unavailable (503) means the change was saved but the live page did
not update: send the same changes again.

Example: website(operation="outbound-site-update", changes={"contact_email": "hello@acme.com"}, client_id=7)

update

Write. Early access: needs website_signals on for the workspace. PATCH https://api.ken.so/v1/website

Body (json): consentMode string, defaultPoints integer, domains array, matchCompaniesBeforeConsent boolean, provider string

Change the website setup. Absent keys stay unchanged. Republishes the site config the script reads.

PATCH /api/v1/website. Staff. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
changes keys: domains (replaces the list: at most 10 bare domains such as acme.com,
no scheme, path or port; lowercased, a leading www. dropped; [] clears it),
consent_mode (eu or all), match_companies_before_consent (bool), default_points
(0 to 50) and provider (none, rb2b, vector, snitcher, warmly or ken). Setting rb2b, vector,
snitcher or warmly creates the provider's webhook and returns its URL in data.providerWebhookUrl
(switching between them keeps the URL); none or ken pauses it. provider ken while
Kenso-managed visitor ID is off for the workspace is refused with feature_off. A bad
field fails with validation_failed and one detail per field; nothing is saved.
Creates the site, with a new site key, when the workspace has none (data.configured
false on website get). Needs the workspace_settings permission. Returns the site,
as website get does.

outbound-site-versions-list

Read. Early access: needs domain_pages on for the workspace. GET https://api.ken.so/v1/outbound-site/versions

List the page versions, newest first, with the live one marked.

GET /api/v1/outbound-site/versions. Needs the domain_pages flag and Delivery view. Sends Ken-Version 1.1.
At most 200, one page (pagination.hasMore false). Each item as outbound-site-get's currentVersion; isCurrent marks
the live one.

Example: website(operation="outbound-site-versions-list", client_id=7)

outbound-site-versions-restore

Write. Early access: needs domain_pages on for the workspace. POST https://api.ken.so/v1/outbound-site/versions/{versionId}/restore

Path: versionId

Make an earlier page version live again on every page-mode domain. Only on the user's request.

POST /api/v1/outbound-site/versions/{versionId}/restore. Needs the domain_pages flag and Delivery edit. Sends
Ken-Version 1.1. Adds a restored copy of the version and makes it current; restoring the current version only
updates the domains again. version_html_missing (409) when the version's page is no longer stored. validation_failed
(400) with page_refused on versionId when the version's page fails today's page checks (it was stored under older
rules); its message lists the problems, and nothing is written or published. A version of another workspace is 404.
service_unavailable (503) means send it again; when its message says the live page did not update, the restore itself
was saved. Returns the outbound site, as outbound-site-get does.

Example: website(operation="outbound-site-versions-restore", version_id=11, client_id=7)

visits-list

Read. Early access: needs website_signals on for the workspace. GET https://api.ken.so/v1/website/visits

Query: accountId integer, cursor string, known boolean, limit integer, pageId integer, personId integer, since date-time

List human visits to the website, newest first. Filters: account_id, person_id, page_id, known (Kenso matched a person), since.

GET /api/v1/website/visits. Staff. Sends Ken-Version 1.1 and X-Ken-Actor: agent.
Only visits the script judged human. since is an ISO-8601 instant: visits first
seen at or after it. limit 1 to 200 (default 50); pass pagination.nextCursor back as
cursor with the same filters. Each visit: id, visitorId, personId, accountId, host,
path, pageId (the tagged page it matched, else null), points, known, companyDomain,
companySource (rb2b, vector, snitcher, warmly or ken), country, visibleMs, firstSeenAt and
lastSeenAt.
companyConfidence is high or medium for a Kenso visitor ID match; a Dealfront match
may also be low; null for a person, a provider webhook match or no match.