initiate_krtrIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

No parameter schema in public metadata yet.

get_roleIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

No parameter schema in public metadata yet.

get_job_statusIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...1 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

jobIdstring

Job id from the submit verb that returned `{ jobId }`, or from `list_my_running_jobs`. Auth: owner-or-admin.

get_quotaIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

No parameter schema in public metadata yet.

resolve_by_nameIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

refstring

The user's exact words — a name, partial name, or partial id. Match ladder is exact-id > exact-name > substring > token-overlap (≥0.5).

kindstring

Entity type to resolve. `'workspace'` / `'deal'` resolve against the actor's accessible workspaces; `'company'` returns the workspace's `companyId`; `'founder'` returns the founder profile id of the workspace owner; `'firm'` (R209-09) matches against `actor.firmMemberships[].firmName` in-memory and returns the `firmId` — no Firestore reads, ideal for multi-firm members.one of deal · workspace · company · founder · firm

maxCandidatesinteger

Cap on the ambiguous-set size. Defaults to 5.

cancel_jobIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...1 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

jobIdstring

Job id from `list_my_running_jobs` (or the `{ jobId }` returned by a submit verb). Admins can cancel any job; non-admins only their own.

list_my_running_jobsIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

No parameter schema in public metadata yet.

select_active_roleIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

rolestring

The role you are operating in for this session. One of 'founder', 'investor', 'firm_member', 'admin'. Use the answer to the multi-role ceremony question from the initialize block.one of founder · investor · firm_member · admin

scopeobject

Optional scope narrowing for the role.

currentPhasestring

Slice R353-04 — optional phase narrowing. When supplied, the response's `availableWorkflows` is filtered to workflows whose cited tools include the current phase OR an adjacent phase in the same loop. Phase literals are from PHASES_BY_LOOP (e.g. 'signal', 'collaborate', 'decide'). Response carries `phaseFiltered: boolean` indicating whether the filter was applied. Cross-loop adjacency is NOT modeled — use `outOfScopeVerbs[]` on workflow terminal steps to gate cross-loop traversal.

get_workflowIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...2 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

ctxobject

Optional context. Omit to get the unfiltered step list (all preconditions ignored).

workflowNamestring

Canonical workflow name from `list_workflows` (e.g. 'investor-triage-loop', 'founder-score-loop').

list_workflowsIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...1 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

rolestring

Optional role to filter workflows by. Omit to enumerate every recipe in the registry. Workflows that span multiple roles appear in each matching list.one of founder · investor · firm_member · accelerator_coach · domain_expert · admin

learn_sectionIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...1 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

sectionIdstring

Stable wiki anchor (e.g. 'how-krtr-works', 'four-loops', 'disposition', 'recipe-investor-triage'). See the META_TOOL_CATALOG in the initialize block for the section directory. On a miss the response carries `data.didYouMean[]` candidates — call again with a candidate to recover. Aliases like 'what-is-krtr', 'intro', 'tour', 'onboard', 'show-me-around', 'help' resolve to the closest canonical anchor via `didYouMean[0]`.

describe_toolIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...1 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

toolNamestring

Canonical tool name (flat snake_case, e.g. 'get_workspace_report', 'submit_investor_signal'). Returns `not_found` if the tool isn't registered.

upload_to_founder_dataroomIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...8 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

uuidstring

Optional uuid for the destination Storage object. Defaults to a fresh uuid.

categorystring

Target dataroom category. Defaults to 'other' when unset. Sensitive categories ('legal', 'cap-table', 'ip', 'tax') are REJECTED on this verb — use `share_founder_dataroom_secure_link` for those.one of pitch · team · research · corporate · termsheet · financial

filenamestring

Original filename — surfaced in the dataroom UI + audit log.

metadataobject

Optional Storage object metadata.

contentTypestring

MIME type (PDF/DOCX/XLSX/CSV/PPTX/TXT/PNG/JPEG/WEBP — rejected otherwise).

stagingPathstring

Storage path of the previously-PUT bytes — produced by `request_founder_dataroom_upload_url`. Format: `staging/{uid}/{uuid}/{filename}`. The bytes are re-uploaded into the workspace dataroom path and the staging blob is best-effort deleted.

workspaceIdstring

Target workspace id. Actor must be the workspace owner (founder), a workspace member, or admin. Mutually exclusive with `workspaceRef`.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id). Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

organize_founder_dataroomIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...4 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

operationvalue

documentIdstring

Target Document id (from a prior dataroom listing).

workspaceIdstring

Workspace id the Document lives in.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id). Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

share_founder_dataroomIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...4 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

recipientobject

Optional invite target. Omit to just mint / fetch the token without inviting anyone.

accessLevelstring

`view` (default) — invitees can browse documents. `view_and_chat` — additionally enables the dataroom AI chat. Flips `chatEnabled: true` on the share doc.one of view · view_and_chat

workspaceIdstring

Workspace whose dataroom is being shared. Actor must own the workspace (or be admin.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id). Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

request_founder_dataroom_upload_urlIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

filenamestring

Original filename — bound onto the staging Storage object metadata + audit log.

sizeBytesinteger

Byte size of the file. HARD CAP: 50 MB. Larger files are rejected with `file_too_large` before any signed URL is allocated.

contentTypestring

MIME type — MUST match the `Content-Type` header sent with the PUT (the signed URL binds the content-type at signing time). Allowlist: PDF, DOCX, XLSX, CSV, PPTX, TXT, PNG/JPEG/WEBP.

share_founder_dataroom_secure_linkIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...5 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

urlstring

External URL the founder is sharing. MUST start `http://` or `https://`. KRTR stores the URL only — no extraction, no RAG indexing.

namestring

Human-readable label surfaced in the dataroom UI (e.g. "Cap Table — Series A").

categorystring

DocumentType slug — controls which section the secure link appears in. Use `global` for the workspace-wide pinned link visible across every dataroom section. Mutually exclusive with `workspaceRef`.one of pitch · team · research · corporate · legal · cap-table

workspaceIdstring

Target workspace id. Actor must be the workspace owner / member / admin.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id). Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

import_founder_dataroom_folderIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

filesarray

Files to import. Each must have already been PUT to its stagingPath. Limit 100 files per call.

workspaceIdstring

Target workspace id. Actor must be the workspace owner / member / admin. Mutually exclusive with `workspaceRef`.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id) for the workspace. Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

list_founder_dataroom_documentsIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...2 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

categorystring

Optional DocumentType filter. When unset, returns every non-deleted Document.one of pitch · team · research · corporate · legal · cap-table

workspaceIdstring

Target workspace id. Actor must be the workspace owner / member / admin.

list_investor_dealsIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...6 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

limitinteger

Page size (default 25, max 100). Larger values are silently clamped.

stagestring

Filter rows by `currentStage` exactly. `currentStage` is the disposition state when set, else funnelStage (`'screen'` / `'pitch'` / `'due_diligence'` / `'funded'` / `'archived'`). **Special case `'referred'`** — matches the RAW `funnelStage` field (not `currentStage`), so the result includes BOTH synthetic `sharedwithme:*` rows AND real KrtrConnectMatch rows whose `funnelStage === 'referred'`, regardless of disposition. Use this to materialize the Referred tab.

cursorstring

Opaque pagination cursor returned by the previous call (`data.nextCursor`). Pass back verbatim; do not parse.

industrystring

Match `industry` case-insensitively. Drops rows with no industry classification when set.

minScorenumber

Lower bound on `scoreSummary.overallScore`. Unscored deals are excluded when this is set.

dispositionstring

Filter rows by the investor's disposition state on the match. Drops rows with no disposition recorded.one of considering · interested · needs_work · monitoring · pass · funded

get_investor_deal_summaryIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

dealIdstring

KrtrConnectMatch id ("deal" surface id). Use `list_investor_deals` or `resolve_by_name({ kind: "deal" })` to obtain.

workspaceIdstring

Optional — resolved from `dealId` via collectionGroup when omitted (one extra read). Mutually exclusive with `workspaceRef`.

workspaceRefstring

R541-02 — free-text reference (name / partial name / partial id) for the workspace as an alternative to providing `workspaceId`. Resolved server-side via `resolve_by_name({kind: 'workspace'})`. `dealId` is still required — pass `workspaceRef` only to skip the collectionGroup-resolution path. Mutually exclusive with `workspaceId`.

get_investor_signalsIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...1 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

workspaceIdstring

Optional — scope to one workspace. Omit to scan every workspace the investor has a match on.

get_investor_own_signals_on_dealIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...2 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

dealIdstring

KrtrConnectMatch id ("deal" surface id). Filter is exact-match against `signal.dealId`.

workspaceIdstring

Workspace id where signals live (`workspaces/{wid}/pendingInvestorSignals`).

submit_investor_signalIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...6 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

kindstring

High-level intent hint stored on the digest doc. Does NOT override the richer per-directive kinds extracted by KRTR.one of concern · support · note · observation · risk

dealIdstring

KrtrConnectMatch id (the "deal" surface id) for the deal you are commenting on. Same as the `id` returned by `list_investor_deals`.

stancestring

Optional EXPLICIT stance toward the company on the claim this note is about. When KRTR binds the note to an existing claim, this stance is recorded verbatim and ALWAYS wins over KRTR's inferred suggestion. Omit it and KRTR records the bound reaction as a neutral re-study (the note prose carries the direction). `defends_company` = the finding is wrong/overstated (pushes UP); `raises_concern` = reinforces a concern (pushes DOWN); `neutral_observation` = no directional claim.one of defends_company · raises_concern · neutral_observation

noteTextstring

Free-form note text — concerns, support, observations, risks the founder should hear. Up to 10,000 chars. Flows through directive-extraction; structured directives land on the deal's `investorFeedbackDigest` and move scores on the next reassess.

workspaceIdstring

Optional. The op resolves workspaceId from the dealId via collectionGroup; pass it explicitly only when you already have it (saves one read).

idempotencyKeystring

Optional caller-supplied idempotency belt. Repeat calls with the same `(investorId, matchId, idempotencyKey)` return the existing `InvestorFeedbackDigest` with `idempotent: true` and do NOT re-run directive extraction. Use this when retrying a network failure or double-click — prevents duplicate digests + duplicate Gemini spend. Alphanumeric + dash + underscore only.

get_investor_claim_pickerIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

topNinteger

How many claims to return PER POLARITY (biggest lifts / biggest drags), ranked by |scoreDelta|. Defaults to 5. Increase (up to 50) to see more score-movers on a large deal. Δ0 claims are never returned — reacting to them is a no-op.

dealIdstring

KrtrConnectMatch id (the "deal" surface id). Same as the `id` returned by `list_investor_deals`. For a referred deal still in the `sharedwithme:` state, claim it first with `claim_investor_referred_deal`.

workspaceIdstring

Optional. Resolved from `dealId` via collectionGroup when omitted; pass it explicitly (e.g. for a referred deal) so the op resolves the match by doc id (one fewer read, and reliable when the match lacks a queryable `id` field).

submit_investor_claim_reactionsIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

dealIdstring

KrtrConnectMatch id (the "deal" surface id) for the deal whose claims you are reacting to. Same as the `id` returned by `list_investor_deals`.

reactionsarray

One or more per-claim reactions (max 50 per call).

workspaceIdstring

Optional. The op resolves workspaceId from the dealId via collectionGroup; pass it explicitly only when you already have it (saves one read).

set_investor_dispositionIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...8 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

dealIdstring

KrtrConnectMatch id (the "deal" surface id).

closeDatestring

REQUIRED when `disposition === 'funded'`. ISO date `YYYY-MM-DD`.

sendSignalboolean

When true AND `disposition === 'pass'`, fires the pass-handoff email + stamps `passSignalSentAt`. Default false — silent disposition change.

closeAmountnumber

REQUIRED when `disposition === 'funded'`. Positive USD amount.

dispositionstring

Investor's stance on the deal. `'considering'` is the soft default; `'pass'` triggers optional pass-handoff email; `'funded'` requires close metadata.one of considering · interested · needs_work · monitoring · pass · funded

workspaceIdstring

Optional — resolved from `dealId` via collectionGroup when omitted. Mutually exclusive with `workspaceRef`.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id) for the workspace. Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref` (writes never auto-execute on ambiguity). Mutually exclusive with `workspaceId`; both can be omitted (workspaceId resolves from dealId via collectionGroup).

passHandoffMessagestring

Only used when `disposition === 'pass'` AND `sendSignal === true`. Maps onto the underlying op's `reason` field — rendered in the pass-handoff email to the founder.

submit_investor_initial_assessmentIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...4 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

notesstring

Optional pre-assess free-form notes — same shape as `submit_investor_signal`'s `noteText`. Runs the directive-extraction pipeline BEFORE analysis, so the very first synthesis incorporates the investor's up-fronted concerns (PRP-170 Condition B). Up to 10,000 chars.

chargeSourcevalue

Which credit pool to debit. Omit when the investor only has one accessible pool — the op picks it automatically. When ambiguous, the op returns `requires_charge_choice` with the available options.

founderEmailstring

Optional — triggers founder-transfer when an onboarded user matches; pre-populates ribbon if released.

pitchUploadTokenstring

The token returned by `request_investor_pitch_upload_url`. Bytes must already have been PUT to the signed URL.

submit_investor_review_for_reassessIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...4 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

briefobject

Inline brief that materializes into an InvestorBriefSession before the reassess fires.

dealIdstring

KrtrConnectMatch id (the "deal" surface id).

workspaceIdstring

Optional — op resolves from `dealId` via collectionGroup; pass when already known to save one read.

chargeSourcevalue

Which credit pool to charge. Omit when only one pool is accessible — op picks automatically. When ambiguous, op returns `requires_charge_choice`; pass the user-selected option back as `chargeSource` and retry.

set_investor_funnel_positionIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...6 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

matchIdstring

KrtrConnectMatch id (the actor's personal-funnel deal id).

positionstring

Personal funnel position. 'screen' → 'pitch' → 'due_diligence' → 'funded' OR 'archived'. Per-investor; the same workspace can be at different positions for different investors.one of screen · pitch · due_diligence · funded · archived

archiveTagsarray

Reason tags written when transitioning to 'archived' (mirrors web route).

workspaceIdstring

Workspace id — matches are slash-pathed by workspace.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id). Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

unarchiveTagsarray

Reason tags written when transitioning out of 'archived'.

claim_investor_referred_dealIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

matchIdstring

Synthetic matchId from `list_investor_deals` — begins with `sharedwithme:`. Preferred form (the verb's MCP-natural input).

shareTokenstring

Raw share token (the `<token>` segment of `/report/shared/<token>`). Equivalent to passing `matchId: 'sharedwithme:<token>'`.

workspaceIdstring

Claim by workspace identity. Errors `multiple_shares_match` when >1 share entries reference the same workspace; pass a more specific reference instead.

import_shared_report_as_investorIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...2 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

shareUrlstring

Full KRTR shared-report URL — e.g. `https://krtr.ai/report/shared/<token>`. The verb extracts the token from the trailing path segment (any host / scheme accepted; only the path matters).

shareTokenstring

Raw share token — the `<token>` segment of `/report/shared/<token>`. Equivalent to passing the full URL.

request_investor_smart_searchIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

limitinteger

Max number of ranked deals to return. Default 10, hard cap 50.

querystring

Natural-language thesis query — e.g., "AI infrastructure deals with >20% revenue growth" or "fintech startups in Europe pre-Series A".

perWorkspaceChunksinteger

Max RAG chunks retrieved per workspace before ranking. Default 5. Higher values trade latency for recall.

request_investor_web_researchIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...2 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

workspaceIdstring

Target workspace id (you must hold a KrtrConnectMatch against this workspace). Mutually exclusive with `workspaceRef`.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id). Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

request_investor_market_valuationIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...2 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

workspaceIdstring

Target workspace id (you must hold a KrtrConnectMatch against this workspace). Mutually exclusive with `workspaceRef`.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id). Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

request_investor_patent_researchIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...2 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

workspaceIdstring

Target workspace id (you must hold a KrtrConnectMatch against this workspace). Mutually exclusive with `workspaceRef`.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id). Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

get_investor_workspace_reportIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...9 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

matchIdstring

Investor-side shorthand for a shared deal — pass a `sharedwithme:<token>` synthetic id returned by `list_investor_deals` to read the report a referrer dropped into your Referred tab. Resolves the workspace via the caller's `sharedWithMe/<token>` entry (no claim required — read is free; mutating verbs still need `claim_investor_referred_deal` first). Real (non-synthetic) matchIds are NOT accepted here; pass the `workspaceId` directly from `list_investor_deals` instead. Mutually exclusive with `workspaceId`, `shareToken`, and `workspaceRef`.

audiencestring

Optional audience pin. Founders + admins may request any audience for workspaces they can access; investor / firm actors are pinned to their role. Defaults to the actor's role-derived audience.one of founder · investor · firm · lp_memo · public_network

reportTypestring

Which report to fetch: `'assess'` (the canonical KRTR analysis), `'pitch_readiness'` (founder-side), the four research reports (`'broad_dd'` — aliased as `'web_research'` for symmetry with `reportRunStatus[K]` and the `request_*_web_research` trigger verbs; `'gap_research'`, `'patent_research'`, `'market_valuation'`), the meeting/feedback/deal-memo briefs, or `'founder_brief'`.one of assess · pitch_readiness · broad_dd · web_research · gap_research · patent_research

shareTokenstring

Raw share token from a `/report/shared/<token>` URL. Equivalent to `matchId: 'sharedwithme:<token>'` — same resolution path. Use this when the agent has the raw token (e.g. parsed out of a URL the user pasted) without going through the import flow. Mutually exclusive with `workspaceId`, `matchId`, and `workspaceRef`.

workspaceIdstring

Workspace id (default addressing form). Pass when you already know the workspace from a prior `list_*_workspaces` / `list_*_deals` call. Mutually exclusive with `matchId`, `shareToken`, and `workspaceRef`.

workspaceRefstring

R541-02 — free-text reference (a name, partial name, or partial id) for the workspace. Resolved server-side via `resolve_by_name({kind: 'workspace'})` (latest-wins on ambiguous reads). Use when the user named the workspace and you haven't yet enumerated the canonical id via `list_*_workspaces` / `list_*_deals`. Mutually exclusive with `workspaceId`, `matchId`, and `shareToken`.

narrativeModestring

How much narrative to return. `'full'` (default when omitted) returns the full markdown body in `data.narrative.markdown` capped per report type. `'sections'` returns just the section index (`data.narrative.sections[]`) with `markdown=''` — use for cheap drill-in planning. `'none'` returns `data.narrative=null` (score header only) — use for funnel scans across many workspaces. Overridden by `sectionAnchor` when both are set.one of full · sections · none

sectionAnchorstring

Drill into one section. Pass an anchor string from a prior call's `data.narrative.sections[].anchor` to return just that section's markdown in `data.narrative.markdown`, capped at 8K. The section index is still returned so sibling sections stay discoverable. Overrides `narrativeMode` when both are set. Returns `{ok: false, error: {kind: 'not_found', resource: 'section:<anchor>'}}` if the anchor doesn't match any section — call with `narrativeMode: 'sections'` to discover valid anchors.

includeSandboxboolean

R526-02 — when `true`, also consult the workspace's sandbox subtree (the founder's private iteration space) for a matching report, even when the workspace's `sandboxMode === 'off'`. Default `false` preserves the prior behavior (sandbox only consulted when sandboxMode is on). Use this when a founder asks "where did my Gap Fill go?" after sandbox iteration — the report is in sandbox but the verb wouldn't otherwise see it.

request_investor_pitch_upload_urlIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...6 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

stagestring

Optional initial funnel stage label (e.g., 'screening'). Commit-side tools can override at commit time.

filenamestring

Original filename — surfaced in the workspace UI and in the audit log.

sizeBytesinteger

Byte size of the pitch file. HARD CAP: 10 MB — files larger than 10 MB (10,485,760 bytes) are rejected at this step with `file_too_large` before any signed URL is allocated. If your PDF is larger, compress it first (use the UI Compress Dialog, or any PDF compressor). Matches the UI's universal 10 MB pitch upload limit.

contentTypestring

MIME type — MUST match the `Content-Type` header you send with the PUT (the signed URL binds the content-type at signing time).

chargeSourcevalue

Which quota pool the eventual assess debit lands on. Investor + firm-member actors typically pass `{ type: 'personal' }` or `{ type: 'firm', firmId }`. Founder actors OMIT this — the op detects founder mode and the commit-side tool consumes the token without a charge source.

founderEmailstring

Optional — used by investor/firm flows to pre-populate the founder-side ribbon when the deal is later released to the founder.

generate_investor_share_linkIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...4 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

audiencestring

Viewer role pinned on the share link — `'founder'` / `'investor'` / `'firm'` / `'lp_memo'` / `'public_network'`. Determines section ordering + which fields are visible to anyone with the link.one of founder · investor · firm · lp_memo · public_network

reportIdstring

Optional. Specific report id to share — pass the `reportId` from `get_<role>_workspace_report` to pin a specific version. OMIT to auto-resolve the latest report of `reportType` for `workspaceId` (dedup recycles per `(workspaceId, reportType, audience)` regardless of this field).

reportTypestring

Which report to share. Audience-pinned renderer auto-selects section ordering + visibility.one of assess · pitch_readiness · broad_dd · gap_research · patent_research · market_valuation

workspaceIdstring

Workspace id from `get_<role>_workspace_report` or a list endpoint.

list_investor_collectionsIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...2 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

limitinteger

Max rows (default 50, max 200).

dealIdstring

Filter by KrtrConnectMatch id.

create_investor_pre_assess_collectionIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

namestring

Display name for the bucket.

dealIdstring

KrtrConnectMatch id (the investor-facing deal id).

workspaceIdstring

Optional workspace anchor (derived from match at materialize time if omitted).

append_to_investor_pre_assess_collectionIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...2 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

payloadvalue

collectionIdstring

Bucket id from `create_investor_pre_assess_collection`.

materialize_investor_review_from_collectionIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...1 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

collectionIdstring

Bucket id from `create_investor_pre_assess_collection`. Must be an investor-owned `pre_assess_brief` collection with a `dealId` anchor.

draft_investor_deal_memoIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...10 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

dealIdstring

KrtrConnectMatch id from your personal investor funnel (`list_investor_deals`).

actingAsstring

Per-memo affiliation override (e.g. SPV name, different fund). Defaults to user.company.

audiencestring

Memo audience. IC mode emphasizes risk + decision framing; LP mode leads with thesis fit.one of ic · lp

sectionsarray

Optional override of which sections to include. Omit to use audience defaults.

sentimentstring

Pull-quote sentiment — rendered verbatim as an italic block at the top.

syndicatestring

Optional syndicate / co-investor signaling block.

includeScoresboolean

Surface the assess composite score in the memo header. Defaults false.

recommendationstring

The author's stance — rendered prominently in the memo header.one of strong_pass · pass · consider · strong_consider · invest

referencesNotestring

Optional diligence references / contacts block.

includeSubscoresboolean

Surface per-category subscores under matching sections. Defaults false.

edit_investor_deal_memo_sectionIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...5 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

memoIdstring

Memo doc id from `draft_investor_deal_memo`.

bulletsarray

New bullets array (markdown allowed). Max 20 bullets × 1000 chars. Empty array drops bullets.

paragraphstring

New paragraph body (markdown). Max 5000 chars. Omit to leave paragraph unchanged.

sectionKeystring

Which memo section to overwrite. Section key must be one of the known sections (thesis, team, market, risks, etc.). Sections not in the memo cannot be edited — re-draft via `draft_investor_deal_memo` to change section coverage.one of snapshot · thesis_fit · team · problem · market · business_model

workspaceIdstring

Workspace id of the deal whose memo is being edited. Must match the workspaceId the memo was drafted on.

share_investor_deal_memoIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

memoIdstring

Memo doc id from `draft_investor_deal_memo`.

audiencestring

Audience pin. Defaults to `investor`. Valid: `investor` (default), `lp_memo`, `public_network`.one of founder · investor · firm · lp_memo · public_network

workspaceIdstring

Workspace id of the deal whose memo is being shared. Must match the workspaceId the memo was drafted on.

add_investor_match_tagIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...5 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

colorstring

Optional Tailwind color name (e.g. 'amber', 'sky', 'rose').

labelstring

Tag label. Normalized server-side: trimmed, lowercased, sliced to 50 chars. Empty after normalization → rejected. Mutually exclusive with `workspaceRef`.

matchIdstring

KrtrConnectMatch id (the investor-facing deal id) — from `list_investor_deals`.

workspaceIdstring

Workspace id — required because matches are slash-pathed under the workspace.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id). Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

remove_investor_match_tagIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...4 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

labelstring

Tag label. Normalization mirrors `add_investor_match_tag`.

matchIdstring

KrtrConnectMatch id.

workspaceIdstring

Workspace id — required because matches are slash-pathed.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id). Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

list_investor_match_tagsIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...2 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

matchIdstring

KrtrConnectMatch id.

workspaceIdstring

Workspace id — required because matches are slash-pathed.

invite_investor_to_founder_workspaceIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...6 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

templateIdstring

Optional saved-email-template id (admin-config).

workspaceIdstring

Workspace id to transfer / invite founder to claim.

referralCodestring

Optional referral code propagated into the signup URL.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id). Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

recipientEmailstring

Founder's email address.

tailoredMessagestring

Optional plain-text override body — appended above the standard gift line.

refer_investor_deal_to_firmIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...5 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

matchIdstring

KrtrConnectMatch id in your personal funnel.

workspaceIdstring

Workspace id the match belongs to.

referralTagsarray

Optional referral-tag overrides — trimmed/lowercased/sliced(50)/filtered before write.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id). Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

destinationFirmIdstring

Firm to refer the deal into. Must be a firm you are an active member of with firmToolsActive=true.

ping_investor_to_founderIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...4 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

presetstring

Ping preset.one of checking_in · any_update · fyi_new_release · got_time_to_chat

matchIdstring

KrtrConnectMatch id under that workspace.

workspaceIdstring

Workspace id the match belongs to (the founder's workspace). Mutually exclusive with `workspaceRef`.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id) for the workspace. Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

chat_with_matched_investor_dataroomIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...5 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

historyarray

Prior conversation turns. v1 stateless — agent supplies the history it accumulated.

messagestring

User-authored question. Empty / whitespace-only is rejected.

workspaceIdstring

Workspace id of the matched founder. You must hold a KrtrConnectMatch on this workspace AND the founder must have enabled AI chat. Mutually exclusive with `workspaceRef`.

workspaceRefstring

R541-02 — free-text reference (name / partial name / partial id) for the matched founder's workspace. Resolved server-side via `resolve_by_name({kind: 'workspace'})`. Mutually exclusive with `workspaceId`.

conversationIdstring

Optional conversation thread id. v1 echoes back without persistence.

investor_invite_founder_to_claim_workspaceIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...2 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

batchPitchIdstring

Batch-pitch workspace id (in KRTR, batch-pitch creates a workspace stub keyed by id — `batchPitchId === workspaceId` for this flow).

founderEmailstring

Founder's email address — they will be invited to claim the workspace and become its owner.

list_firm_member_affiliationsIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

No parameter schema in public metadata yet.

list_firm_dealsIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...8 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

limitinteger

Page size (default 25, max 100). Larger values are silently clamped.

stagestring

Filter rows by firm stage id (`firmCustomConfig.stages[].id`). Exact match.

cursorstring

Opaque pagination cursor returned by the previous call (`data.nextCursor`). Pass back verbatim; do not parse.

firmIdstring

VcFirm id. Per-stage visibility (PRP-182) is enforced — actor only sees deals at stages their role permits.

industrystring

Match `industry` case-insensitively. Drops rows with no industry classification on the workspace when set.

minScorenumber

Lower bound on `scoreSummary.overallScore`. Unscored deals are excluded when this is set.

dispositionstring

Filter rows by `disposition.state` exactly. Drops rows without a disposition recorded.one of considering · interested · needs_work · monitoring · pass · funded

includePitchFailedboolean

Default `false` — `pitchStatus: 'failed'` shells (assess crashed at intake; no score ever produced) are hidden so the funnel view matches the web UI. Pass `true` to surface them when probing for broken state. The response always carries `pitchFailedHidden` so the agent knows how many rows are behind the flag.

get_firm_deal_summaryIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

dealIdstring

Firm deal id (NOT a KrtrConnectMatch). Use `resolve_firm_deal_reference` when user references by name. Mutually exclusive with `workspaceRef`.

firmIdstring

VcFirm id. Actor must have `firm.deals.read` + stage visibility on the deal.

workspaceRefstring

R541-02 — free-text reference (name / partial name / partial id) for the underlying workspace. Resolved server-side via `resolve_by_name({kind: 'workspace'})`; the handler then reverse-looks up the firmDeal for this firmId matching the resolved workspaceId. Use when the user named the deal and you haven't yet enumerated the firmDeal id via `list_firm_deals`. Mutually exclusive with `dealId`.

resolve_firm_deal_referenceIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

refstring

User's exact words — a name, partial name, or partial dealId. Matching ladder: exact dealId → 8-char id prefix → company name substring.

firmIdstring

VcFirm id to scope the resolution to. Actor must have `firm.deals.read` for this firm.

maxCandidatesinteger

Cap on ambiguous-set size. Defaults to 5.

submit_firm_initial_assessmentIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

firmIdstring

VcFirm id — the firm under which the deal will be created. Actor must have `firm.deals.create` permission.

founderEmailstring

Optional — triggers founder-transfer when an onboarded user matches.

pitchUploadTokenstring

Token returned by `request_firm_pitch_upload_url` allocated with `chargeSource: { type: 'firm', firmId }`. Investor-scoped (`personal`) tokens are rejected here.

submit_firm_review_for_reassessIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

briefobject

Inline brief that materializes into a FirmBriefSession before the reassess fires.

dealIdstring

Firm deal id (NOT a KrtrConnectMatch). Use `resolve_firm_deal_reference` to map a free-text ref.

firmIdstring

VcFirm id. Actor must have `firm.deals.reassess` permission.

submit_firm_team_signalIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...4 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

kindstring

Optional intent hint — surfaced in the response summary only; not stored on the note doc.one of concern · support · note · observation · risk

dealIdstring

Firm deal id (NOT a KrtrConnectMatch). Use `resolve_firm_deal_reference` to map a free-text ref to a firm-deal id.

firmIdstring

VcFirm id — call `resolve_by_name({ kind: "firm", ref })` or `list_firm_member_affiliations` to obtain.

contentstring

Free-form coordination text — internal chat between firm members. NOT score-moving. R209-09: identical `content` from the same author as the most recent prior note returns the existing noteId + `idempotent: true` instead of appending a duplicate row.

submit_firm_signalIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...7 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

kindstring

High-level intent hint, forwarded to the mint-new fallback only.one of concern · support · note · observation · risk

dealIdstring

Firm deal id (NOT a KrtrConnectMatch).

firmIdstring

VcFirm id. Actor must have `firm.signals.write` permission.

stancestring

Optional EXPLICIT stance toward the company on the claim this note is about. When KRTR binds the note to an existing claim, this stance is recorded verbatim and ALWAYS wins over KRTR's inferred suggestion. Omit it and KRTR records the bound reaction as a neutral re-study. `defends_company` = the finding is wrong/overstated (pushes UP); `raises_concern` = reinforces a concern (pushes DOWN); `neutral_observation` = no directional claim.one of defends_company · raises_concern · neutral_observation

noteTextstring

Free-form note text. Up to 10,000 chars. KRTR binds it to the score-driving claim when it can, else falls back to directive-extraction.

idempotencyKeystring

Optional caller-supplied idempotency belt (mint-new lane only). Repeat calls with the same key return the existing digest. Alphanumeric + dash + underscore only.

shareWithFounderboolean

Default false. When true (mint-new lane only), the note also creates a CommentSession visible in the founder's Feedback Intelligence.

get_firm_claim_pickerIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

topNinteger

How many claims to return PER POLARITY (biggest lifts / biggest drags), ranked by |scoreDelta|. Defaults to 5. Increase (up to 50) to see more score-movers. Δ0 claims are never returned — reacting to them is a no-op.

dealIdstring

Firm deal id (NOT a KrtrConnectMatch id). Use `list_firm_deals` or `resolve_firm_deal_reference` to obtain.

firmIdstring

VcFirm id. Actor must have `firm.signals.write` permission + stage visibility on the deal.

submit_firm_claim_reactionsIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

dealIdstring

Firm deal id (NOT a KrtrConnectMatch). Same as the `id` returned by `list_firm_deals`.

firmIdstring

VcFirm id. Actor must have `firm.signals.write` permission + stage visibility on the deal.

reactionsarray

One or more per-claim reactions (max 50 per call).

set_firm_deal_dispositionIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...7 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

dealIdstring

Firm deal id. Use `resolve_firm_deal_reference` when user references by name.

firmIdstring

VcFirm id. Actor must have `firm.deals.disposition` permission (admin/super-user).

closeDatestring

REQUIRED when `disposition === 'funded'`. ISO date `YYYY-MM-DD`.

sendSignalboolean

When true AND `disposition === 'pass'`, fires the D1 pass-handoff email + stamps the signal timestamp. Default false.

closeAmountnumber

REQUIRED when `disposition === 'funded'`. Positive USD amount.

dispositionstring

Firm's collective stance on the deal. `'funded'` requires close metadata.one of considering · interested · needs_work · monitoring · pass · funded

passHandoffMessagestring

Only used when `disposition === 'pass'` AND `sendSignal === true`. Rendered in the D1 pass-handoff email to the founder.

advance_firm_funnel_stageIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...4 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

forceboolean

Set true to allow a backwards move (newStage.order < currentStage.order). Default false — backwards without force returns typed `backward_without_force`.

dealIdstring

FirmDeal id under `vcDatabase/main/firms/{firmId}/firmDeals/`.

firmIdstring

Firm id — the `vcFirm.id` under `vcDatabase/main/firms/{firmId}`. Must be a firm the caller is an active, non-halted member of.

newStagestring

Stage ID — built-in FirmDealStage value or a custom stage id from `firmCustomConfig.stages[].id`. The op validates it against the firm config.

assign_firm_member_roleIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

rolestring

Target role. 'member' demotes from admin/superUser.one of admin · superUser · member

firmIdstring

vcInvestorIdstring

Target member, identified by VC database id (NOT User uid).

set_firm_member_visibilityIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

firmIdstring

Firm id — the `vcFirm.id` under `vcDatabase/main/firms/{firmId}`. Caller must be a firm admin of this firm to assign role-visibility tags.

vcInvestorIdstring

Target member's vcInvestor id (NOT a Firebase uid). Identifies the firm member whose visibility tags are being set.

customRoleIdsarray

Full-replace list of custom-role IDs to assign. Each ID must match `firm.firmCustomConfig.customRoles[].id`. Empty array clears all tags.

configure_firm_funnel_stagesIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...2 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

firmIdstring

Firm id. Actor must hold `firm.config.write` (admin-only).

stagesarray

Ordered list of pipeline stages. At least 2. Stage IDs must be unique slugs. Built-in stage IDs (referred, inbox, screen, pitch, due_diligence, funded, passed, archived) require isBuiltIn:true + builtInKey === id. allowedRoles[] (optional, per stage) must reference built-in role IDs (admin / superUser / member) or firmCustomConfig.customRoles[] IDs.

configure_firm_visibility_rulesIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...2 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

rulesarray

Per-stage visibility rules. Each rule targets one existing stage. Rules omitted leave the stage unchanged. allowedRoles must be built-in (admin / superUser / member) or registered custom-role ids.

firmIdstring

Firm id. Actor must hold `firm.config.write` (admin-only).

configure_firm_brandingIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...2 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

firmIdstring

Firm id. Actor must hold `firm.config.write` (admin-only).

brandingobject

At least one field (logoUrl, brandColor, displayName) must be present.

configure_firm_role_tagsIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...2 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

firmIdstring

Firm id. Actor must hold `firm.config.write` (admin-only).

roleTagsarray

Desired complete role-tag taxonomy. Full-replace — IDs missing from this array are considered removed. Removed IDs still referenced from stages.allowedRoles[] OR firmMemberCustomRoles[*] return a typed orphan error; resolve via `configure_firm_visibility_rules` first.

request_firm_web_researchIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

firmIdstring

Optional pin for which firm to charge. REQUIRED when you're a member of multiple firms AND more than one of them holds a deal on this workspace — otherwise the dispatcher refuses with `invalid_input` listing candidates (cross-firm pool-charge side effects are unacceptable). For single-firm actors or when only one of your firms holds the deal, omit and let the dispatcher resolve.

workspaceIdstring

Target workspace id (your firm must hold a firmDeal against this workspace). Mutually exclusive with `workspaceRef`.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id). Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

request_firm_market_valuationIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

firmIdstring

Optional pin for which firm to charge. REQUIRED when you're a member of multiple firms AND more than one of them holds a deal on this workspace — otherwise the dispatcher refuses with `invalid_input` listing candidates (cross-firm pool-charge side effects are unacceptable). For single-firm actors or when only one of your firms holds the deal, omit and let the dispatcher resolve.

workspaceIdstring

Target workspace id (your firm must hold a firmDeal against this workspace). Mutually exclusive with `workspaceRef`.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id). Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

request_firm_patent_researchIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

firmIdstring

Optional pin for which firm to charge. REQUIRED when you're a member of multiple firms AND more than one of them holds a deal on this workspace — otherwise the dispatcher refuses with `invalid_input` listing candidates (cross-firm pool-charge side effects are unacceptable). For single-firm actors or when only one of your firms holds the deal, omit and let the dispatcher resolve.

workspaceIdstring

Target workspace id (your firm must hold a firmDeal against this workspace). Mutually exclusive with `workspaceRef`.

workspaceRefstring

R541-03 — free-text reference (name, partial name, or partial id). Resolved via `resolve_by_name({kind: 'workspace'})`. Write-mode is strict: multi-match returns `ambiguous_ref`. Mutually exclusive with `workspaceId`.

get_firm_workspace_reportIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...9 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

matchIdstring

Investor-side shorthand for a shared deal — pass a `sharedwithme:<token>` synthetic id returned by `list_investor_deals` to read the report a referrer dropped into your Referred tab. Resolves the workspace via the caller's `sharedWithMe/<token>` entry (no claim required — read is free; mutating verbs still need `claim_investor_referred_deal` first). Real (non-synthetic) matchIds are NOT accepted here; pass the `workspaceId` directly from `list_investor_deals` instead. Mutually exclusive with `workspaceId`, `shareToken`, and `workspaceRef`.

audiencestring

Optional audience pin. Founders + admins may request any audience for workspaces they can access; investor / firm actors are pinned to their role. Defaults to the actor's role-derived audience.one of founder · investor · firm · lp_memo · public_network

reportTypestring

Which report to fetch: `'assess'` (the canonical KRTR analysis), `'pitch_readiness'` (founder-side), the four research reports (`'broad_dd'` — aliased as `'web_research'` for symmetry with `reportRunStatus[K]` and the `request_*_web_research` trigger verbs; `'gap_research'`, `'patent_research'`, `'market_valuation'`), the meeting/feedback/deal-memo briefs, or `'founder_brief'`.one of assess · pitch_readiness · broad_dd · web_research · gap_research · patent_research

shareTokenstring

Raw share token from a `/report/shared/<token>` URL. Equivalent to `matchId: 'sharedwithme:<token>'` — same resolution path. Use this when the agent has the raw token (e.g. parsed out of a URL the user pasted) without going through the import flow. Mutually exclusive with `workspaceId`, `matchId`, and `workspaceRef`.

workspaceIdstring

Workspace id (default addressing form). Pass when you already know the workspace from a prior `list_*_workspaces` / `list_*_deals` call. Mutually exclusive with `matchId`, `shareToken`, and `workspaceRef`.

workspaceRefstring

R541-02 — free-text reference (a name, partial name, or partial id) for the workspace. Resolved server-side via `resolve_by_name({kind: 'workspace'})` (latest-wins on ambiguous reads). Use when the user named the workspace and you haven't yet enumerated the canonical id via `list_*_workspaces` / `list_*_deals`. Mutually exclusive with `workspaceId`, `matchId`, and `shareToken`.

narrativeModestring

How much narrative to return. `'full'` (default when omitted) returns the full markdown body in `data.narrative.markdown` capped per report type. `'sections'` returns just the section index (`data.narrative.sections[]`) with `markdown=''` — use for cheap drill-in planning. `'none'` returns `data.narrative=null` (score header only) — use for funnel scans across many workspaces. Overridden by `sectionAnchor` when both are set.one of full · sections · none

sectionAnchorstring

Drill into one section. Pass an anchor string from a prior call's `data.narrative.sections[].anchor` to return just that section's markdown in `data.narrative.markdown`, capped at 8K. The section index is still returned so sibling sections stay discoverable. Overrides `narrativeMode` when both are set. Returns `{ok: false, error: {kind: 'not_found', resource: 'section:<anchor>'}}` if the anchor doesn't match any section — call with `narrativeMode: 'sections'` to discover valid anchors.

includeSandboxboolean

R526-02 — when `true`, also consult the workspace's sandbox subtree (the founder's private iteration space) for a matching report, even when the workspace's `sandboxMode === 'off'`. Default `false` preserves the prior behavior (sandbox only consulted when sandboxMode is on). Use this when a founder asks "where did my Gap Fill go?" after sandbox iteration — the report is in sandbox but the verb wouldn't otherwise see it.

request_firm_pitch_upload_urlIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...6 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

stagestring

Optional initial funnel stage label (e.g., 'screening'). Commit-side tools can override at commit time.

filenamestring

Original filename — surfaced in the workspace UI and in the audit log.

sizeBytesinteger

Byte size of the pitch file. HARD CAP: 10 MB — files larger than 10 MB (10,485,760 bytes) are rejected at this step with `file_too_large` before any signed URL is allocated. If your PDF is larger, compress it first (use the UI Compress Dialog, or any PDF compressor). Matches the UI's universal 10 MB pitch upload limit.

contentTypestring

MIME type — MUST match the `Content-Type` header you send with the PUT (the signed URL binds the content-type at signing time).

chargeSourcevalue

Which quota pool the eventual assess debit lands on. Investor + firm-member actors typically pass `{ type: 'personal' }` or `{ type: 'firm', firmId }`. Founder actors OMIT this — the op detects founder mode and the commit-side tool consumes the token without a charge source.

founderEmailstring

Optional — used by investor/firm flows to pre-populate the founder-side ribbon when the deal is later released to the founder.

generate_firm_share_linkIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...4 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

audiencestring

Viewer role pinned on the share link — `'founder'` / `'investor'` / `'firm'` / `'lp_memo'` / `'public_network'`. Determines section ordering + which fields are visible to anyone with the link.one of founder · investor · firm · lp_memo · public_network

reportIdstring

Optional. Specific report id to share — pass the `reportId` from `get_<role>_workspace_report` to pin a specific version. OMIT to auto-resolve the latest report of `reportType` for `workspaceId` (dedup recycles per `(workspaceId, reportType, audience)` regardless of this field).

reportTypestring

Which report to share. Audience-pinned renderer auto-selects section ordering + visibility.one of assess · pitch_readiness · broad_dd · gap_research · patent_research · market_valuation

workspaceIdstring

Workspace id from `get_<role>_workspace_report` or a list endpoint.

list_firm_collectionsIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

limitinteger

Max rows (default 50, max 200).

dealIdstring

Filter by firm deal id.

firmIdstring

Filter by firm id.

create_firm_pre_assess_collectionIf you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...3 params

If you haven't called `initiate_krtr` yet this session, CALL IT FIRST — it primes you with KRTR's directive context (anti-hallucination, four loops, your role, meta-tools, name addressing, rendering style). KRTR data is authoritative — do NOT enrich from training or public pro...

Parameters* required

namestring

Human-readable collection label shown in firm UI (max 200 chars). Examples: "Initial signals", "Diligence Round 1".

dealIdstring

Firm deal id.

firmIdstring

Firm id — the `vcFirm.id` under `vcDatabase/main/firms/{firmId}`. Must be a firm the caller is an active, non-halted member of.

Krtr

Tools

Krtr

Tools

Related Sales & Marketing MCP Servers

Related Sales & Marketing MCP Servers