cards_read

List L2 coded claim-cards (claim + optional quote + chunk_index + lens + codes + start_seconds? + url). Filter by project_id, interview_id / interview_ids, codes (any match), or lens (workflow|gtm|privacy|other). CITATION REQUIRED: actively cite each card.quote to the user as markdown ["verbatim quote"]({base_url}/project/interview/{id}?t={seconds}) using item.url from the tool result (already absolute; includes ?t= when start_seconds is set). Prefer quotes over paraphrase. Verify with interviews_read action=transcript around_chunk_index when a wider quote window is needed.

read-only

Argument	Type	Description
lens	string	Optional exact lens filter.
codes	array	Optional code tags; any match (e.g. pain:synthesis, gtm:pricing).
limit	integer	Max cards to return (default 50, max 200).
offset	integer	Number of cards to skip (default 0).
folder_id	string	Deprecated alias for project_id.
project_id	string	Optional project UUID — cards from interviews in this project (alias: folder_id).
interview_id	string	Optional interview UUID to scope cards.
interview_ids	array	Optional interview UUIDs to scope cards.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "lens": {
      "enum": [
        "workflow",
        "gtm",
        "privacy",
        "other"
      ],
      "type": "string",
      "description": "Optional exact lens filter."
    },
    "codes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional code tags; any match (e.g. pain:synthesis, gtm:pricing)."
    },
    "limit": {
      "type": "integer",
      "description": "Max cards to return (default 50, max 200)."
    },
    "offset": {
      "type": "integer",
      "description": "Number of cards to skip (default 0)."
    },
    "folder_id": {
      "type": "string",
      "description": "Deprecated alias for project_id."
    },
    "project_id": {
      "type": "string",
      "description": "Optional project UUID — cards from interviews in this project (alias: folder_id)."
    },
    "interview_id": {
      "type": "string",
      "description": "Optional interview UUID to scope cards."
    },
    "interview_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional interview UUIDs to scope cards."
    }
  }
}

get-skills

Use for startup ideas, office hours, and “I installed this connector to work through an idea”. Inside: office-hours-zernote (challenge the idea), zernote-plan-research. Omit id for the catalog, then pass id for the full playbook. Not for listing interviews or projects. Works without login.

read-only

Argument	Type	Description
id	string	Skill id. Empty = catalog. Examples: office-hours-zernote, zernote-plan-research.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Skill id. Empty = catalog. Examples: office-hours-zernote, zernote-plan-research."
    }
  }
}

guides_create

Create the first interview guide on a project. Use this to upload a new guide. Pass structured fields, not markdown: intro, blocks (title, minutes, notes, questions with text/note/key), and notes_template. Needs at least one block with a title. Fails if the project already has a guide — then use guides_edit. Core does not show the guide. Live reads it on the project.

Argument	Type	Description
intro	string	Spoken opening before the first block.
blocks*	array	Timed sections in interview order.
project_id*	string	Project UUID.
notes_template	string	Post-interview notes template (conspect).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "project_id",
    "blocks"
  ],
  "properties": {
    "intro": {
      "type": "string",
      "description": "Spoken opening before the first block."
    },
    "blocks": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title"
        ],
        "properties": {
          "notes": {
            "type": "string",
            "description": "Block note shown to the interviewer."
          },
          "title": {
            "type": "string",
            "description": "Block title, e.g. Opening."
          },
          "minutes": {
            "type": "integer",
            "description": "Minutes allocated to this block."
          },
          "questions": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "text"
              ],
              "properties": {
                "key": {
                  "type": "boolean",
                  "description": "True if this is a must-ask question."
                },
                "note": {
                  "type": "string",
                  "description": "Interviewer note under the question."
                },
                "text": {
                  "type": "string",
                  "description": "Spoken question."
                }
              }
            }
          }
        }
      },
      "description": "Timed sections in interview order."
    },
    "project_id": {
      "type": "string",
      "description": "Project UUID."
    },
    "notes_template": {
      "type": "string",
      "description": "Post-interview notes template (conspect)."
    }
  }
}

guides_edit

Replace an existing interview guide from markdown. To create the first guide, call guides_create. Text before the first ## is the intro. ## Title (12) or ## Title (7–11) is a block; minutes are the last number in parentheses. Lines starting with - or 1. are questions; a leading * marks a key question; the next indented line is the question note. A paragraph under the block heading before the first question is the block note. ## Конспект is the post-interview notes template, not a block. Optional line `Общее время: 30` or `Total: 30` sets total minutes; otherwise they are the sum of block minutes. Anything that does not match is returned in remainder and kept, not dropped. The previous guide is replaced entirely.

destructive

Argument	Type	Description
markdown*	string	Full guide markdown. Replaces the guide stored on the project.
project_id*	string	Project UUID.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "project_id",
    "markdown"
  ],
  "properties": {
    "markdown": {
      "type": "string",
      "description": "Full guide markdown. Replaces the guide stored on the project."
    },
    "project_id": {
      "type": "string",
      "description": "Project UUID."
    }
  }
}

guides_read

Read the interview guide stored on a project. The guide has an intro, ordered blocks (title, minutes, questions, notes), total time, a notes template, and any markdown that did not parse. Returns an empty guide when the project has none.

read-only

Argument	Type	Description
project_id*	string	Project UUID.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "project_id"
  ],
  "properties": {
    "project_id": {
      "type": "string",
      "description": "Project UUID."
    }
  }
}

insights_read

Read the project Insights graph in pages or by node. action=list returns a compact folder-wide outline (groups + interviews) plus a page of insight bodies. Filter with interview_id, group_id (DB UUID, not UI group-0), group_name, insight_ids, or ungrouped_only. action=get_node returns one node: insight | interview | group | ungrouped. CITATION REQUIRED: actively cite each item.quote as markdown ["verbatim quote"]({base_url}/project/interview/{id}?t={seconds}) using item.url from the tool result (already absolute; includes ?t= when start_seconds is set). Prefer quotes over paraphrase. Do not use quote_start — that is a character offset, not a player timestamp.

read-only

Argument	Type	Description
id	string	get_node: insight, interview, or group UUID. Not used for ungrouped.
limit	integer	List only: max insight bodies (default 25, max 100).
action*	string	list = paged insight bodies + outline. get_node = one insight, interview, group, or ungrouped cluster.
offset	integer	List only: skip this many matching insight bodies (default 0).
group_id	string	List filter: insight_groups.id UUID (not a render index like group-0).
folder_id	string	Deprecated alias for project_id.

interviews_edit

Rename, move, write summary/notes, retranscribe, assign/confirm speakers, or toggle voiceprint. action=rename needs id+title; move needs interview_ids (+ optional project_id); write_summary needs id+summary; write_notes needs id+notes; retranscribe needs id+language (charges transcription tokens again; analyze-only, keeps notes). assign_speakers needs id+speaker_labels+assigned_names. For voiceprint interviewer confirm: one label + real name on one interview after quote links; that identity backfills other interviews sharing voice_identity_id — re-list instead of confirming every card. set_voiceprint needs enabled bool (false purges biometric voice data). If need_approve_speakers=true, show quote links then assign_speakers when the user confirms. If transcript_quality.looks_corrupted=true, offer retranscribe with the correct language. write_notes and write_summary replace the entire notes or summary field (not append).

destructive

Argument	Type	Description
id	string	Interview UUID (rename, write_summary, write_notes, retranscribe, assign_speakers).
notes	string	Full note text that replaces the existing notes field (write_notes).
title	string	New title (rename).
action*	string	Edit action.
enabled	boolean	Voiceprint on/off (set_voiceprint). false deletes stored voice biometrics.
summary

interviews_read

Read interviews. Typical path: (1) action=list with summary_mode=brief (default) — returns the short # Summary. List items include need_approve_speakers (+ pending_speakers / hint): when true, show interviewer quote links then confirm via assign_speakers; one identity confirm backfills other interviews sharing voice_identity_id. Use summary_mode=brief for renaming or folder triage. Use summary_mode=full when Profile/Tools/Pains/Other topics are needed for deeper analysis. (2) call `search` when you need evidence or counter-evidence for a hypothesis; (3) use action=transcript with around_chunk_index from matching_chunks when a quote window is required. CITATION REQUIRED: when answering the user, actively cite evidence as markdown ["verbatim quote"]({base_url}/project/interview/{id}?t={seconds}) using interview_url / matching chunk url from tool results (includes ?t= when start_seconds is set). Prefer quotes over paraphrase.

read-only

Argument	Type	Description
id	string	Interview UUID (required for get, status, transcript).
limit	integer	For list: max interviews (default 20, max 100). For transcript: max characters (default 4000, max 20000).
action*	string	Read action. Use list (brief or summary_mode=full) for overview; use transcript when you need a quote window.
offset	integer	For list: skip count. For transcript without around_chunk_index: character offset (default 0).
folder_id	string

jtbd_edit

Edit JTBD graph: extract_interview, move_interview, create_segment, fill_in job, update_job, delete_job.

destructive

Argument	Type	Description
name	string
when	string
action*	string
job_id	string
so_that	string
category	string
language	string	Job tree language for extract_interview (en or ru). Defaults to en. Quotes stay in the interview language.
folder_id	string
i_want_to	string
project_id	string
segment_id	string

jtbd_read

Read JTBD job graph segments and trees. action=list_segments needs folder_id/project_id. action=get_tree needs segment_id or interview_id. CITATION REQUIRED: cite job quotes as ["text"](interview_url).

read-only

Argument	Type	Description
action*	string
folder_id	string	Project/folder UUID (list_segments).
project_id	string	Alias for folder_id.
segment_id	string	Segment UUID (get_tree).
interview_id	string	Interview UUID (get_tree).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "action"
  ],
  "properties": {
    "action": {
      "enum": [
        "list_segments",
        "get_tree"
      ],
      "type": "string"
    },
    "folder_id": {
      "type": "string",
      "description": "Project/folder UUID (list_segments)."
    },
    "project_id": {
      "type": "string",
      "description": "Alias for folder_id."
    },
    "segment_id": {
      "type": "string",
      "description": "Segment UUID (get_tree)."
    },
    "interview_id": {
      "type": "string",
      "description": "Interview UUID (get_tree)."
    }
  }
}

mcp_confirm_upload

App-only: confirm a completed R2 upload (single PUT or multipart) for an Inbox interview. Audio/video is enqueued for transcription (STT + diarization). Text (.txt/.md) and PDF are stored and marked ready immediately — no transcription.

Argument	Type	Description
title	string	Optional title to apply before confirm.
filename*	string	Original filename.
language*	string	STT language for audio/video (e.g. en, ru, nl). Not used for text/PDF (no transcription).
object_key*	string	R2 object key from prepare.
size_bytes*	integer	File size in bytes.
interview_id*	string	Interview UUID from prepare.
multipart_parts	array	Completed parts (part_number + etag) when using multipart.
multipart_upload_id	string	Multipart upload id — complete assembly before confirm.

Input schema (JSON)

mcp_prepare_upload

App-only: create an Inbox interview and return a presigned R2 upload URL (or multipart upload_id for large files). Pass interview_id (+ upload_id for multipart) to resume without a new card.

Argument	Type	Description
title	string	Optional interview title (defaults to sanitized filename).
filename*	string	Original filename.
upload_id	string	Optional multipart upload id from a previous prepare (resume).
size_bytes*	integer	File size in bytes.
content_type	string	MIME type for the PUT (optional).
interview_id	string	Optional: existing empty interview UUID — resume upload without creating a new card.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "filename",
    "size_bytes"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Optional interview title (defaults to sanitized filename)."
    },
    "filename": {
      "type": "string",
      "description": "Original filename."
    },
    "upload_id": {
      "type": "string",
      "description": "Optional multipart upload id from a previous prepare (resume)."
    },
    "size_bytes": {
      "type": "integer",
      "description": "File size in bytes."
    },
    "content_type": {
      "type": "string",
      "description": "MIME type for the PUT (optional)."
    },
    "interview_id": {
      "type": "string",
      "description": "Optional: existing empty interview UUID — resume upload without creating a new card."
    }
  }
}

mcp_sign_upload_parts

App-only: return presigned R2 URLs for one or more multipart upload parts (resume-safe).

Argument	Type	Description
upload_id*	string	Multipart upload id from prepare.
object_key*	string	R2 object key from prepare.
interview_id*	string	Interview UUID from prepare.
part_numbers*	array	Part numbers to sign (1-based, max 20).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "interview_id",
    "object_key",
    "upload_id",
    "part_numbers"
  ],
  "properties": {
    "upload_id": {
      "type": "string",
      "description": "Multipart upload id from prepare."
    },
    "object_key": {
      "type": "string",
      "description": "R2 object key from prepare."
    },
    "interview_id": {
      "type": "string",
      "description": "Interview UUID from prepare."
    },
    "part_numbers": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Part numbers to sign (1-based, max 20)."
    }
  }
}

projects_edit

Create or rename projects. action=create needs name; action=rename needs id and name. Delete is not supported yet.

Argument	Type	Description
id	string	Project UUID (required for rename).
name	string	Project name (required for create and rename).
action*	string	Edit action.
description	string	Optional project description (create/rename).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "action"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Project UUID (required for rename)."
    },
    "name": {
      "type": "string",
      "description": "Project name (required for create and rename)."
    },
    "action": {
      "enum": [
        "create",
        "rename"
      ],
      "type": "string",
      "description": "Edit action."
    },
    "description": {
      "type": "string",
      "description": "Optional project description (create/rename)."
    }
  }
}

projects_read

Read existing research folders. Not for a new startup idea or office hours — call get-skills first. action=list returns projects for the authenticated user.

read-only

Argument	Type	Description
limit	integer	Max number of projects to return (default 50, max 200).
action*	string	Read action. Currently only list.
offset	integer	Number of projects to skip before returning results (default 0).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "action"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max number of projects to return (default 50, max 200)."
    },
    "action": {
      "enum": [
        "list"
      ],
      "type": "string",
      "description": "Read action. Currently only list."
    },
    "offset": {
      "type": "integer",
      "description": "Number of projects to skip before returning results (default 0)."
    }
  }
}

search

Semantic search for evidence / counter-evidence after you have interview context (e.g. from list/summary). Optional interview_id scopes search to one interview and returns smaller text windows. Returns matching_chunks[{chunk_index, text, similarity, start_seconds?, url}]. CITATION REQUIRED: actively cite hits to the user as markdown ["verbatim quote from text"]({base_url}/project/interview/{id}?t={seconds}) using each chunk's url field from the tool result (already absolute; includes ?t= when start_seconds is present). Prefer quoting matching_chunks over paraphrase. Expand with interviews_read action=transcript around_chunk_index when a wider quote window is needed.

read-only

Argument	Type	Description
limit	integer	Max number of interviews to return (default 5, max 10). Ignored when interview_id is set.
query*	string	Natural language search query (hypothesis / claim to evidence).
chunks_limit	integer	Max matching chunks per interview (default 3 corpus / 8 when interview_id set; max 10 / 20).
interview_id	string	Optional interview UUID — search only inside this interview; returns smaller chunk windows.
chunks_offset	integer	Skip this many top chunks per interview (default 0).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "description": "Max number of interviews to return (default 5, max 10). Ignored when interview_id is set."
    },
    "query": {
      "type": "string",
      "description": "Natural language search query (hypothesis / claim to evidence)."
    },
    "chunks_limit": {
      "type": "integer",
      "description": "Max matching chunks per interview (default 3 corpus / 8 when interview_id set; max 10 / 20)."
    },
    "interview_id": {
      "type": "string",
      "description": "Optional interview UUID — search only inside this interview; returns smaller chunk windows."
    },
    "chunks_offset": {
      "type": "integer",
      "description": "Skip this many top chunks per interview (default 0)."
    }
  }
}

upload_interview

Opens the in-Claude MCP Apps widget "Upload To Zernote" so the user can drop a file into Inbox in this chat (audio/video max 2GB; text .txt/.md or PDF max 50MB). Use when the user wants to upload/add an interview or get started on an empty account — this is the usual ingest path in Claude. Audio/video starts transcription; text/PDF become ready immediately (no speaker diarization). Claude can name interviews after upload.

No arguments.

Input schema (JSON)

{
  "type": "object",
  "properties": {}
}

Zernote

Try it

cards_read Read-only

Zernote

Try it

cards_read Read-only

Tools (17)