Performance Deal performance_deal
The workspace's done-for-you performance deal with Kenso: read its terms, offers and approved rate card, preview the card, add and edit offers (first-year ACV per company size band and the personas each targets) while the deal is draft or proposed, submit it for staff approval, and list its invoices and payments.
Call it from an MCP client connected to https://mcp.ken.so/mcp: reads go through performance_deal_read and changes through performance_deal_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: archive-offer, create-offer, get, list-invoices, list-payments, preview-card, submit, update-offer
archive-offer
Write. Early access: needs performance_pricing on for the workspace. POST https://api.ken.so/v1/performance/offers/{offerId}/archive
Path: offerId
Archive an offer: it drops out of new rate cards and stops being the default.
POST /api/v1/performance/offers/{offerId}/archive. Needs the workspace settings feature (Admin, Editor); never a
client seat. Only while the deal is draft or proposed (409 invalid_state after). A retry is safe; an offer of
another workspace is 404. Returns the offer.
Example: performance_deal(operation="archive-offer", offer_id=12)
create-offer
Write. Early access: needs performance_pricing on for the workspace. POST https://api.ken.so/v1/performance/offers
Body (json): acvCentsByBand object, defaultSizeBand string, description string, isDefault boolean, name string, personas array
Add an offer to the deal: what the workspace sells, its first-year ACV per company size and who buys it.
POST /api/v1/performance/offers. Needs the workspace settings feature (Admin, Editor); never a client seat. Only
while the deal is draft or proposed (409 invalid_state after).
name: 1 to 200 characters. acv_cents_by_band maps a size band (employees_1_50, employees_51_200,
employees_201_1000, employees_1001_5000, employees_5001_plus) to the first-year ACV in cents, or null for not
billed. personas: at most 50, each {title or function, seniority (optional), role: decision_maker or
influencer}. default_size_band: the band a contact with no known company size prices at. The first active offer
becomes the default; is_default true moves the default here. Fields set here are marked as the client's, so
Ken's pre-fill never overwrites them. Returns the offer as get shows it.
Example: performance_deal(operation="create-offer", name="Food safety audits",
acv_cents_by_band={"employees_51_200": 900000}, personas=[{"title": "VP Quality", "role": "decision_maker"}])
get
Read. Early access: needs performance_pricing on for the workspace. GET https://api.ken.so/v1/performance/deal
Read the workspace's performance deal: terms, active offers, approved rate card and Ken's latest pre-fill.
GET /api/v1/performance/deal. Any member.
Returns data {dealId, status (draft|proposed|approved|active|paused|ended), canEdit, website, clientType
(b2b_saas|agency|b2b_services|other_b2b), industry, billingUnit (meeting|reply|signup), monthlyResultCap,
plannedAccountsContactsPerMonth, plannedCampaignsContactsPerMonth, firstSendDay, commitmentMonths,
commitmentEndDay, priceLockEndDay, monthlyMinimumCents, fieldMeta, offers, approvedCard, latestPrefillRun,
createdAt, updatedAt}. Money is integer US cents. canEdit is true while the deal is draft or proposed, the only
time offers change. fieldMeta maps a field to who set it ({source: client|staff|ken_prefill, confidence 0-1 on a
Ken pre-fill, at}). Each offer is {offerId, name, description, isDefault, defaultSizeBand, acvCentsByBand,
personas [{title, function, seniority, role}], status, fieldMeta, archivedAt, createdAt, updatedAt}.
approvedCard {rateCardId, version, status, approvedAt, card} is absent until Kenso staff approve one. A
workspace with no deal is 404 (Kenso staff start it).
Example: performance_deal(operation="get")
list-invoices
Read. Early access: needs performance_pricing on for the workspace. GET https://api.ken.so/v1/performance/invoices
Query: cursor string, limit integer
List the workspace's performance invoices, newest first.
GET /api/v1/performance/invoices. Any member. limit 1 to 200 (default 50); cursor from pagination.nextCursor.
Each invoice is {invoiceId, kind, dealMonth, status, totalCents, paidCents, number, sentAt, dueDate,
createdAt}. Empty until performance invoicing ships. A workspace with no deal is 404.
Example: performance_deal(operation="list-invoices", limit=20)
list-payments
Read. Early access: needs performance_pricing on for the workspace. GET https://api.ken.so/v1/performance/payments
Query: cursor string, limit integer
List the payments on the workspace's performance invoices, newest first.
GET /api/v1/performance/payments. Any member. limit 1 to 200 (default 50); cursor from pagination.nextCursor.
Each payment is {paymentId, invoiceId, amountCents, paidDate, method, source, recordedAt}. Empty until
performance invoicing ships. A workspace with no deal is 404.
Example: performance_deal(operation="list-payments")
preview-card
Read. Early access: needs performance_pricing on for the workspace. GET https://api.ken.so/v1/performance/rate-cards/preview
Price the deal's active offers now, as a rate card preview; nothing is saved.
GET /api/v1/performance/rate-cards/preview. Any member.
Returns data {card, isFitTierAssumed}. card has one table per active offer: the price in cents of one meeting and
one positive reply per company size band and persona role, with the fixed-fee terms and the estimate from the
volume plan. Until Kenso staff set the deal's fit tier, offers are priced at fit tier b (the standard rate) and
isFitTierAssumed is true. The approved card can differ. A deal with no active offer is 400.
Example: performance_deal(operation="preview-card")
submit
Write. Early access: needs performance_pricing on for the workspace. POST https://api.ken.so/v1/performance/deal/submit
Submit the performance deal for Kenso staff to price and approve.
POST /api/v1/performance/deal/submit. Needs the workspace settings feature (Admin, Editor); never a client seat. Moves a draft deal to proposed. Needs at least one active offer (400 otherwise). A proposed deal stays proposed, so a retry is safe; an approved, active, paused or ended deal is 409 invalid_state. Returns the deal as get does. Example: performance_deal(operation="submit")
update-offer
Write. Early access: needs performance_pricing on for the workspace. PATCH https://api.ken.so/v1/performance/offers/{offerId}
Path: offerId
Body (json): acvCentsByBand object, defaultSizeBand string, description string, isDefault boolean, name string, personas array
Change an active offer's name, description, default, ACV per size band or personas.
PATCH /api/v1/performance/offers/{offerId}. Needs the workspace settings feature (Admin, Editor); never a client
seat. Only while the deal is draft or proposed and the offer is active (409 invalid_state otherwise); an offer of
another workspace is 404.
changes is a JSON object of the fields to set, camelCase as get returns them: name, description, isDefault,
defaultSizeBand, acvCentsByBand, personas. An absent field keeps its value and null clears it;
acvCentsByBand and personas replace the whole value. Returns the offer.
Example: performance_deal(operation="update-offer", offer_id=12, changes={"acvCentsByBand":
{"employees_51_200": 1200000}})