Lookups lookups
The Kenso Chrome extension's reads for one tab: what a LinkedIn profile, company page or website is to the workspace (get: the verdict, owner, account, committee coverage, campaigns, reply and waiting drafts) and its toolbar badge (lookup-badges-get). Stored data only. Needs the extension feature.
Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through lookups_read. 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: lookup-badges-get, get
lookup-badges-get
Read. Early access: needs extension on for the workspace. GET https://api.ken.so/v1/lookup-badges
Query: key string
Read the extension's toolbar badge for a LinkedIn or website key: none, mine, team, waiting or stop. Workspace data only: never Ken Search, never counted.
GET /api/v1/lookup-badges?key=. Staff. Sends Ken-Version 1.1 and X-Ken-Actor: agent. Needs the extension feature (on by default; a workspace override of false turns it off).
key as for lookups(operation="get"). Returns {key, badge}. badge: none, mine, team, waiting (a draft
waits or a fresh reply came) or stop, from the same precedence as the lookup's verdict, so a key only Ken
Search knows is none.
get
Read. Early access: needs extension on for the workspace. GET https://api.ken.so/v1/lookups
Query: key string
Look up a LinkedIn profile, company page or website: who it is to the workspace, the verdict, and what to show. From stored data only; nothing runs AI. A Ken Search hit counts toward the search browse quota once per key per 30 days.
GET /api/v1/lookups?key=. Staff. Sends Ken-Version 1.1 and X-Ken-Actor: agent. Needs the extension feature (on by default; a workspace override of false turns it off).
key: a LinkedIn profile (linkedin.com/in/...), company page (linkedin.com/company/..., any subpage) or Sales
Navigator lead URL, or a website (any URL or domain, matched by its registrable domain), at most 300 characters.
Anything else is a validation error with detail invalid_key.
Returns {key, kind, reason, verdict, holdReason, person, company, account, campaigns, reply, waitingTouches,
blocked, searchCounted}. kind: person, company or unmatched, with reason not_found, sales_navigator (lead pages
match nothing yet) or search_unavailable. verdict, in this precedence: stop (the blocklist holds the key, its
email or a parent domain; blocked has source, reason and createdAt), hold (holdReason draft_waiting or replied),
team (a teammate's account), mine, info (a campaign contact not in Accounts), clear, unmatched.
person and company: the workspace record (source workspace), else Ken Search (source search). A Search person
never carries an email. freeEmailAvailable is a hint that Ken's pool holds a verified address for the profile;
saving with use_ken_email fills it only when a recently verified, usable work address on the company's domain
exists and the emailPoolHits quota admits it. The Search step runs only for a caller with Search page View who is
not a client seat; otherwise an unknown key is unmatched with not_found. account: accountId, name, stage,
tier, ownerName, isMine, the stored whyNow and research (Ken's read), committee {covered, total} and the
person's seat {role, coverage}. With account scope own, a teammate's record is account.restricted true and
carries only the account name, ownerName, the person's name, title and LinkedIn URL, and blocked.
campaigns: [{campaignId, name, nextSendAt}] (live campaigns). reply: the newest campaign reply {receivedAt,
classification, snippet, isFresh}. waitingTouches: drafted or awaiting approval, at most 3 {touchId, channel,
status, subject, body, dueAt}. Search runs only when the workspace has no person (profile) or no account
(company page, website) and the blocklist does not stop the key; a blocked website with no account is kind
company with company and account null. waitingTouches for a profile are the person's seat's only, none when the
person has no seat. Past the searchBrowseRows quota the call is refused with quota_exceeded, the limit and the
reset time. For the badge only, use lookups(operation="lookup-badges-get").