Kenso MCP tools

Loopster loopster

People and companies from Loopster, on the workspace's own Loopster API key: a search spends only that key's request limits, never Kenso credits. List the filters first, then search. Import the people you pick with contacts contact-imports-create, source loopster. Not Kenso Search.

Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through loopster_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: search-filters-list, companies-search, people-search

search-filters-list

Read. GET https://api.ken.so/v1/loopster/search-filters

Query: entity string

List the filters Loopster search takes for people or companies, with each filter's value shape. Read it before loopster(operation="people-search") or companies-search. Spends nothing.

GET /api/v1/loopster/search-filters?entity=people|companies. Sends Ken-Version 1.1 and X-Ken-Workspace-Id.
Search page view.

entity is people (default) or companies.

Returns data (one entry per filter: id, the key to send it under in filters; label; kind, the value shape;
help; excludable; options [{value, label}] for a pick list (send value); indexed, false when the filter makes a
search slower; available, false while Loopster has no data behind it), pagination {hasMore: false} and meta
{entity, vocabulary {source live|fallback, stale, fetchedAt, notice}, valueEnvelopes [{kind, shape, example,
notes}]}: the exact value each kind takes, with Loopster's example.

Errors: 409 not_connected (no Loopster key in Integrations, a demo workspace, or Loopster refused the key: the
message says which); 429 rate_limited with Retry-After; 503 provider_unavailable when Loopster is down.

Read. POST https://api.ken.so/v1/loopster/companies/search

Body (json): cursor string, filters any JSON, limit integer, searchId string

Search companies in Loopster on the workspace's own Loopster key. Spends nothing: only the key's request limits.

POST /api/v1/loopster/companies/search. Sends Ken-Version 1.1 and X-Ken-Workspace-Id. Search page view.

Give exactly one of filters (an object or JSON string keyed by the filter ids
loopster(operation="search-filters-list", entity="companies") returns) or search_id (meta.searchId of an earlier
page, with cursor). limit is 1-50 (default 25). cursor is pagination.nextCursor from the previous page.

Returns data (id, position, fields as Loopster sent them), pagination {nextCursor, hasMore, totalCount} and meta
{searchId, totalIsLowerBound, warnings}. Companies are not imported as contacts: search people at them with
loopster(operation="people-search"). Errors as loopster people-search.

Read. POST https://api.ken.so/v1/loopster/people/search

Body (json): cursor string, filters any JSON, limit integer, searchId string

Search people in Loopster on the workspace's own Loopster key. Spends nothing: only the key's request limits. Import picked people with contacts contact-imports-create.

POST /api/v1/loopster/people/search. Sends Ken-Version 1.1 and X-Ken-Workspace-Id. Search page view.

Give exactly one of:
- filters: an object (or JSON string) keyed by the filter ids loopster(operation="search-filters-list",
  entity="people") returns, each value in the shape meta.valueEnvelopes gives for that filter's kind (a text
  list is {"include": [...], "exclude": [...]}). Starts a new search.
- search_id: meta.searchId of an earlier page (kept about 24 hours), with cursor, for the next page.
limit is 1-50 (default 25). cursor is pagination.nextCursor from the previous page.

Returns data (one record per person: id, position, the 0-based place in the results, linkedInUrl when Loopster
has it, fields as Loopster sent them: name, title, companyName, country and more), pagination {nextCursor,
hasMore, totalCount, Loopster's approximate total} and meta {searchId, totalIsLowerBound (totalCount means "at
least"), warnings [{code, filter, message}]: what Loopster dropped or respelled}.

To import, pass the picked records as they came with the page's meta.searchId:
contacts(operation="contact-imports-create", source="loopster", campaign_id=..., search_id=...,
records=[{id, position, fields}]). Up to 1,000 per import.

Errors: 409 not_connected (no key, a demo workspace, or a key Loopster refused) or provider_plan_required (the
Loopster plan, for example an ended trial, does not include search); 422 search_too_slow (narrow the filters, or
use fewer unindexed ones); 429 rate_limited with Retry-After; 400 validation_failed (details name the filter
Loopster refused, or code search_expired on searchId about 24 hours after the search: search again with the
filters); 503 provider_unavailable when Loopster is down.