Kenso MCP tools

Market Stories market_stories

Market news: the stories Kenso matched to the workspace from the day's headlines, each with an angle, tags and source links, and the topic profile they are matched against. list reads the open stories; get adds the suggested audience. profile-get reads the profile's industries, countries, vendors and keywords; profile-update replaces the lists sent. Not markets, which holds the writing rules of each market pack.

Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through market_stories_read and changes through market_stories_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: profile-get, get, list, profile-update

profile-get

Read. GET https://api.ken.so/v1/market-profile

Read the workspace's market news topic profile: the industries, countries, vendors and keywords stories match. Needs the market_news flag.

GET /api/v1/market-profile. Sends Ken-Version 1.1; client_id is sent as X-Ken-Workspace-Id.
Returns data with ownIndustries (what the workspace is) and targetIndustries (who it sells to) as market taxonomy
keys, countries (ISO 3166-1 alpha-2), vendors ([{name, domain}]: competitors and the tools its buyers use),
keywords, source (ai, or edited once a member changed a list), editedFields (the lists a rebuild leaves alone),
buildStatus (pending before the first build, built or failed), website, builtAt and editedAt (null when unknown)
and industryOptions (every taxonomy key with its label). Never builds the profile.
404 not_found where the market_news flag is off. Never open to a Client seat.

get

Read. GET https://api.ken.so/v1/market-stories/{storyId}

Path: storyId

Read one market news story with all its sources and the suggested audience.

GET /api/v1/market-stories/{storyId}. Sends Ken-Version 1.1. Requires Campaigns view and the market_news flag.
Never open to a Client seat.
story_id: the story's id from list. Answers the story in any status, expired or not, with up to 25 sources
(url, outlet, title, country, publishedAt), audience (description; filters with Ken Search industry names,
countries and keywords; vendorCustomers for a vendor story once known) and brief once a campaign was created
from it. 404 not_found when the workspace has no such story or the flag is off.

list

Read. GET https://api.ken.so/v1/market-stories

Query: campaignId integer, cursor string, includeExpired boolean, limit integer, status string

List the market news stories Kenso matched to the workspace, newest first.

GET /api/v1/market-stories. Sends Ken-Version 1.1. Requires Campaigns view and the market_news flag (404
not_found where it is off). Never open to a Client seat.
status: open (default), dismissed or used; comma-separated values mean OR. include_expired=true also lists
stories past their 5 days. campaign_id: only the story that campaign was created from. limit: 1 to 50, default
20. cursor: the previous page's pagination.nextCursor, unchanged, with the same filters.
Returns data, the array of stories, each with id, title, summary, eventType (security_incident,
vendor_trouble, regulation, industry_news, trend), reach (niche, industry, national, global), industries
(key, label), countries, companies, namesCompany, status, angle, angleType (direct, vendor), fitScore, vendor,
sources (the three newest, each url, outlet, title, publishedAt), firstSeenAt, matchedAt, expiresAt,
isExpired and campaignId; pagination.hasMore is true when older stories follow. When namesCompany is true,
copy may state only what the sources reported, attributed to the outlet.

profile-update

Write. PATCH https://api.ken.so/v1/market-profile

Body (json): countries array, keywords array, ownIndustries array, targetIndustries array, vendors array

Replace lists of the workspace's market news topic profile; lists left out stay as they are. A list sent replaces that list whole and a rebuild keeps it. Needs the workspace_settings permission.

PATCH /api/v1/market-profile. Sends Ken-Version 1.1. Consent scope campaigns.
own_industries, target_industries: market taxonomy keys (profile-get's industryOptions), at most 8 each.
countries: ISO 3166-1 alpha-2 codes, at most 20. vendors: [{"name": "Drata", "domain": "drata.com"}], name
required, domain optional (stored as a bare host), at most 30; a vendor whose host (or, with no domain, name)
repeats an earlier one is kept once. keywords: at most 30. Every value is at most 100 characters. An empty list
clears that list. Send the whole list: to add a vendor, read the profile first and send every vendor plus the new
one.
Returns the profile as profile-get does, with source edited and the lists sent in editedFields.
400 validation_failed names each bad value in error.details (an unknown industry key, a country that is not ISO
alpha-2, a vendor with no name, a vendor domain that is not a website or domain (vendors[i].domain), a list too
long, a value too long); nothing is saved. 403 forbidden without
Campaigns edit and the workspace_settings permission; 403 permission_denied for a Client seat. 404 not_found
where the market_news flag is off.