Blitz blitz
People, companies, a company's decision-makers and job postings from Blitz, on the workspace's own Blitz API key: every row spends that Blitz plan's records, never Kenso credits, and Blitz returns no emails. Import the people you pick with contacts contact-imports-create, source blitz. Not Kenso Search.
Call it from an MCP client connected to https://mcp.ken.so/mcp: changes through blitz_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: decision-makers-find, companies-search, jobs-search, people-search
decision-makers-find
Write. POST https://api.ken.so/v1/blitz/decision-makers
Body (json): companyLinkedInUrl string, cursor string, employeeFilters object, limit integer, titleTiers array
Find the decision-makers at one company in Blitz, by title tiers or by level and function. Spends the workspace's Blitz records (1 per person returned), never Kenso credits.
POST /api/v1/blitz/decision-makers. Sends Ken-Version 1.1 and X-Ken-Workspace-Id. Search page view. company_linkedin_url is the company's LinkedIn page (https://www.linkedin.com/company/acme). Give exactly one of: - title_tiers: 1-10 tiers, each 1-50 job titles, best first ([["CEO", "Founder"], ["VP Sales"]]). Blitz walks the tiers in order and returns the people of the first tiers that match, each with icpTier and ranking. One page only: a cursor is refused. - employee_filters: an object (or JSON string) with jobLevels, jobFunctions, countryCodes, continents, salesRegions, minConnections, isRecentHire. Pages with cursor. limit is 1-50 (default 25). Returns data (the people-search fields plus icpTier and ranking for title tiers), pagination and usage. Errors as blitz people-search; a company URL that is not a LinkedIn company page is 400 validation_failed.
companies-search
Write. POST https://api.ken.so/v1/blitz/companies/search
Body (json): cursor string, filters object, limit integer
Search companies in Blitz on the workspace's own Blitz key. Spends the workspace's Blitz records (1 per company returned), never Kenso credits.
POST /api/v1/blitz/companies/search. Sends Ken-Version 1.1 and X-Ken-Workspace-Id. Search page view.
filters is an object (or JSON string) with company: name, industry, type, keywords ({include, exclude}
each), employeeRanges, employeeCount, revenue, foundedYear ({min, max} each) and hq ({city, state: {include,
exclude}, countryCodes, continents, salesRegions}). company.linkedInUrls is refused here (that is a lookup,
not a search). limit is 1-50 (default 25). cursor is pagination.nextCursor from the previous page.
Returns data (name, linkedInUrl, domain, website, industry, type, size, revenueRange, employeesOnLinkedIn,
foundedYear, about, hq {city, state, countryCode, countryName}), pagination {nextCursor, hasMore,
totalCount} and usage {recordsUsed, recordsRemaining, resetAt}. Find a company's decision-makers with
blitz(operation="decision-makers-find", company_linkedin_url=...). Errors as blitz people-search.
jobs-search
Write. POST https://api.ken.so/v1/blitz/jobs/search
Body (json): companyLinkedInUrl string, cursor string, filters object, limit integer
Search job postings in Blitz, across companies or at one company. Spends the workspace's Blitz records (1 per posting returned), never Kenso credits.
POST /api/v1/blitz/jobs/search. Sends Ken-Version 1.1 and X-Ken-Workspace-Id. Search page view.
filters is an object (or JSON string) with job and company:
- job: title, description, keywords, city, countryCodes ({include, exclude} each), postedInLastDays.
- company: industry, keywords, hqCountryCodes ({include, exclude} each), employeeCount ({min, max}).
company_linkedin_url lists one company's open roles instead (then filters.company is refused).
limit is 1-50 (default 25). cursor is pagination.nextCursor from the previous page.
Returns data (title, url, postedAt, companyName, companyLinkedInUrl, summary, city, countryCode),
pagination and usage. Errors as blitz people-search.
people-search
Write. POST https://api.ken.so/v1/blitz/people/search
Body (json): cursor string, filters object, limit integer
Search people in Blitz on the workspace's own Blitz key. Spends the workspace's Blitz records (1 per person returned), never Kenso credits.
POST /api/v1/blitz/people/search. Sends Ken-Version 1.1 and X-Ken-Workspace-Id. Search page view.
filters is an object (or JSON string) with company and people, both optional:
- company: linkedInUrls (people at these companies), name, industry, type, keywords ({include: [...],
exclude: [...]} each), employeeRanges (["11-50", "51-200"]), employeeCount, revenue, foundedYear ({min,
max} each), hq ({city, state: {include, exclude}, countryCodes, continents, salesRegions}).
- people: jobTitle and jobDescription ({include, exclude}), includeLinkedInHeadline, jobFunctions,
jobLevels, minConnections, isRecentHire, location ({city: {include, exclude}, countryCodes, continents,
salesRegions}), includeActiveJobs, includePastJobs.
An unknown key is 400 validation_failed. limit is 1-50 (default 25). cursor is pagination.nextCursor from
the previous page.
Returns data (fullName, firstName, lastName, title, linkedInUrl, location {city, stateCode, countryCode},
company {name, linkedInUrl, domain}), pagination {nextCursor, hasMore, totalCount} and usage {recordsUsed,
recordsRemaining, resetAt}. No emails: import the people you pick with
contacts(operation="contact-imports-create", source="blitz", campaign_id=..., contacts=[{full_name, title,
linkedin_url, company_name, company_domain, company_linkedin_url}]); their emails come from the import's
enrichment, as for Search people.
Errors: 409 not_connected (no Blitz key, or a demo workspace), key_invalid (Blitz refused the key) or
plan_excludes_endpoint (the Blitz plan does not include people search); 402 provider_quota_exhausted (the
plan's records are used up; details.resetAt says until when); 429 rate_limited with Retry-After; 400
invalid_filters (Blitz refused the filters); 503 or 504 when Blitz is down or slow. An empty page costs nothing.