API and MCP

Fields

A Theme id is thm_ plus the theme id. themeId is that same id. An unthemed Atom row uses an atm_ id. phraseId is the deprecated phr_ id for the same Atom. atomId is the Atom row id on a quote: the evidence id and the href segment, not a Theme id and not an atm_ id. label and descriptor are the name. phrase is a deprecated alias of label. kind is theme or atom. A Theme needs at least 3 distinct calls in the current filters. A group on 1 or 2 calls is left out. calls and accounts are distinct calls and accounts in those filters. A text query does not shrink them. matchedCalls, matchedAccounts, and matchedAtoms count the Atoms that matched q. themes counts Themes. phrases is a deprecated alias of that count. atoms counts unthemed Atoms and is separate from themes. get_quotes pages with limit and cursor. The default page is 50 quotes and the maximum is 100. truncated is true when nextCursor is set. Any API key for a workspace, including free-trial keys, can read every deal's amount and win/loss outcome.

Endpoints

• GET /api/v1 — Index of the read API.
• GET /api/v1/categories — Categories with theme counts, atom counts, and denominators.
• GET /api/v1/categories/{category}/themes — Themes in one category.
• GET /api/v1/themes — Themes. Supports limit and cursor.
• GET /api/v1/themes/{id}/quotes — Quotes for one Theme or one Atom. Supports limit and cursor.
• GET /api/v1/atoms — Atoms in this workspace. Supports limit and cursor.
• GET /api/v1/calls — Analyzed calls in this workspace. Supports limit and cursor.
• GET /api/v1/deals — Deals in this workspace. Supports limit and cursor. Any API key for a workspace, including free-trial keys, can read every deal's amount and win/loss outcome.
• GET /api/v1/evidence/{atomId} — One quote by Atom row id.
• GET /api/v1/ready-fields — Pain, Atom to use, objection, and quotes for one segment.
• GET /api/v1/prospect-columns — The same columns as a Clay import, for one segment or a saved list.
• GET /api/v1/openapi.json — OpenAPI document for this API.

Deprecated

These aliases still respond. GET /api/v1/phrases — Deprecated alias of /api/v1/themes. Also returns unthemed Atoms. GET /api/v1/phrases/{id}/evidence — Deprecated alias of /api/v1/themes/{id}/quotes. GET /api/v1/categories/{category}/phrases — Deprecated alias of /api/v1/categories/{category}/themes.

MCP tools

• search_themes — Themes in this workspace. Set includeUnthemedAtoms to also return unthemed Atoms, each with kind.
• get_themes — Themes and unthemed Atoms in one category.
• get_quotes — Quotes for a Theme or one Atom, paged with limit and cursor.
• get_segment_fields — Pain, Atom to use, objection, and quotes for one company, domain, persona, industry, or account.

tools/list omits search_buyer_language, get_category, get_evidence, get_ready_fields. A client can still call those names.