{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"MCP tool reference","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"mcp-tool-reference","__idx":0},"children":["MCP tool reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Junior's MCP connector exposes 4 read-only tools. Every tool is scoped to the signed-in user: it returns only the projects, calls, and entities that user can already see in the Junior web app."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You don't call these yourself — the assistant picks the right one from what you ask. This page is here so you can see exactly what it can reach. For phrasing that works well, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/mcp-connector"},"children":["What you can ask"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"at-a-glance","__idx":1},"children":["At a glance"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Tool"},"children":["Tool"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it does"},"children":["What it does"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Example ask"},"children":["Example ask"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["get_call"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Read one call — summary, Key Takeaways, Q&A, and optionally the transcript"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Summarise the call with the former Head of Procurement"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_calls"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Find calls by expert network, country, job title, segment, rating, cost, duration, or date"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Expert calls in France rated 4+ from GLG since March"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_entities"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["See the companies and products recognized across a project's calls"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Which competitors came up most across the diligence?"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_projects"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["List your projects and the segment names their calls are tagged with"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"em","attributes":{},"children":["What segments do we have calls for on the Acme diligence?"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Server version ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0.5.0"]}," — this changes whenever a tool name, parameter, or response shape changes, so clients that cache tool definitions can tell they need to refresh."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reference","__idx":2},"children":["Reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Parameters and response fields for each tool — useful for security review or for anyone building against the same data."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get_call","__idx":3},"children":["get_call"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Get a call"]}," · read-only · requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls:read"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Fetch one call's detail by its public ID (get the ID from list_calls first). Returns metadata, a summary, cleaned Q&A, and Key Takeaways by default. Set include_transcript=true ONLY when you need exact quotes or precise wording — for most questions the summary and Q&A are enough and far smaller."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"parameters","__idx":4},"children":["Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["call_id"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["required"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Call's public ID — the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," field returned by list_calls. Under the hood this is transcript.public_id (transcript and call share one identifier in Junior's data model)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["include_ktas"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean · default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Include Key Takeaways: a curated markdown summary of the call's most important points. Defaults to true; keep on when the user wants headline insights rather than full detail."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["include_notes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean · default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Include your scratchpad notes from the call (the ScribblePad you type during a call). Defaults to true; set false to omit."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["include_qa"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean · default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Include the cleaned, structured Q&A extracted from the call (question/answer pairs by section). Defaults to true; use for content and quotes organized by topic."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["include_summary"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean · default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Include the call's AI summary (markdown). Defaults to true; set false to omit (e.g. when you only need Q&A or metadata)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["include_transcript"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean · default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verbatim transcript text. Defaults to false. Set true ONLY when you need exact quotes or precise wording — it can be large, and the summary and Q&A cover most questions."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"response","__idx":5},"children":["Response"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["anonymity_status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Redaction state for this call: 'not_requested', 'started', 'complete', or 'errored'. 'complete' means anonymized variants of the identity fields exist — but this tool still returns the originals, so treat this as informational rather than as a description of what you received."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["call_status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Where the call sits in the scheduling workflow: 'scheduled', 'reached_out', 'not_scheduled', 'done', 'rescheduled', 'not_interested', 'canceled', or 'candidate'. 'done' means the call actually happened."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cost"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["created_at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 timestamp of when the call record was created in Junior — not when the call took place. See ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date"]}," for that."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 timestamp of when the call took place."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["duration_minutes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Call duration in minutes, derived from the recording/transcript. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," when the duration is unknown."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expert"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Who was interviewed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expert.bio"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expert.country"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The interviewee's country, e.g. 'France'."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expert.job_title"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The interviewee's job title, e.g. 'VP of Procurement'."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expert.name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The interviewee's name as recorded. Identity fields are returned as-is: MCP does not substitute the anonymized variant, even for calls that have been through redaction, which matches what the Junior web app shows. (The REST API differs — it can return an anonymized name depending on organization settings.) See ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["anonymity_status"]}," for whether this call was redacted."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expert.organization"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The interviewee's employer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The call's public ID — the value you passed in."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kta_approval_status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"approved\""]}," | ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"pending\""]}," | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["'pending' = AI-generated, not yet human-reviewed (treat as draft); 'approved' = reviewed. Omitted when include_ktas=false."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ktas"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Key Takeaways as markdown. Omitted when include_ktas=false; null if none have been generated for the call."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["notes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your scratchpad notes from the call (the ScribblePad — transcript.scribble_pad). Omitted when include_notes=false."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["qa_blocks"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The call's cleaned question-and-answer pairs. Omitted when include_qa=false."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["qa_blocks[].answer"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The answer, rewritten as a clean standalone statement rather than raw transcript speech."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["qa_blocks[].id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["QA block UUID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["qa_blocks[].question"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The question as asked."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["qa_blocks[].section"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rating"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["segment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The call's segment — a per-project label grouping calls by interviewee type, e.g. 'Buyer' or 'Former Employee'. Call list_projects to see a project's segment vocabulary."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Where the call came from — free text, usually an expert-network name such as 'GLG' or 'AlphaSights', or an import label."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["summary"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The call's AI summary (markdown). Omitted when include_summary=false."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transcript"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Verbatim transcript text. Present only when include_transcript=true."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transcript_public_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Same value as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}," — transcript and call share one identifier in Junior's data model."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"list_calls","__idx":6},"children":["list_calls"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["List calls"]}," · read-only · requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls:read"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List calls (interviews) most recent first. Defaults to calls the authenticated user personally conducted (scope=\"mine\"). Pass scope=\"all\" to widen to every call you can access — project calls, teammates' calls, and your own uncategorized (not-yet-filed) calls. Pass ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["project_id"]}," to narrow to a single project (works with any scope). Filter params (country, organization, job title, source, segment, rating, cost range, duration range, date range, call type, call status) are AND-combined and applied at query time, so you can fetch 'expert calls with people in France rated 4+ from GLG since March' without paginating through everything. Returns metadata only — use get_call for the transcript, Questions & Answers, and Key Takeaways."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"parameters-1","__idx":7},"children":["Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["call_status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (1–64)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Exact-match filter on interview.call_status. Case-sensitive. Valid values: 'scheduled', 'reached_out', 'not_scheduled', 'done', 'rescheduled', 'not_interested', 'canceled', 'candidate'. Most common in queries is 'done' (the call actually happened)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["call_type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"interview\""]}," | ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"meeting\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filter on transcript.call_type. 'interview' = expert call, 'meeting' = internal/recorded meeting."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (1–64)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Filter on interview.country. Case-insensitive exact match (e.g. 'France', 'United States')."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cursor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date_after"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (date-time)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 timestamp. Returns calls with interview.date >= this. Use for date-range queries."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date_before"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (date-time)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 timestamp. Returns calls with interview.date <= this."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["job_title_contains"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (1–128)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Case-insensitive substring match on interview.job_title (e.g. 'VP', 'CFO', 'Engineer')."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer (1–100) · default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["25"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_cost"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number (min 0)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return only calls with interview.cost <= this. Cost is the call's recorded spend in the project's currency — the 'Cost' column in the web call tracker. Combine with min_cost for a range."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["max_duration_minutes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number (min 0)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return only calls whose transcript duration <= this many minutes — the 'Duration' column in the web call tracker. Combine with min_duration_minutes for a range."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["min_cost"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number (min 0)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return only calls with interview.cost >= this. See max_cost."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["min_duration_minutes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number (min 0)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return only calls whose transcript duration >= this many minutes. See max_duration_minutes."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["min_rating"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer (1–5)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Return only calls with interview.rating >= this. 1–5 scale."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["organization_contains"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (1–128)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Case-insensitive substring match on interview.organization (e.g. 'Goldman', 'Microsoft')."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["project_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Project UUID. Omit to list calls across every accessible project."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scope"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"mine\""]}," | ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"all\""]}," | ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"project\""]}," · default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"mine\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Which calls to list. \"mine\" (default) = calls you personally conducted (interview.created_by = you). \"all\" = every call you can access: project calls, teammates' calls, and your own uncategorized (not-yet-filed) calls. (\"project\" is a deprecated alias for \"all\".) Combine with project_id to narrow to a single project."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["segment_contains"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (1–128)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Case-insensitive substring match on the call's segment name (interview_segment.segment) — the 'Segment' column in the web call tracker. Segments are per-project labels grouping calls by interviewee type (e.g. 'Buyer', 'Competitor', 'Former Employee')."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["source_contains"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (1–128)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Case-insensitive substring match on interview.source (e.g. 'GLG', 'AlphaSights'). The source field is free text — usually an expert-network name or import label — so substring match handles common variants ('GLG' vs 'Gerson Lehrman')."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"response-1","__idx":8},"children":["Response"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Matching calls, most recent first."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls[].call_status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Where the call sits in the scheduling workflow: 'scheduled', 'reached_out', 'not_scheduled', 'done', 'rescheduled', 'not_interested', 'canceled', or 'candidate'. 'done' means the call actually happened."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls[].cost"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls[].country"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The interviewee's country, e.g. 'France'."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls[].created_at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 timestamp of when the call record was created in Junior — not when the call took place. See ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["date"]}," for that."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls[].date"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 timestamp of when the call took place."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls[].duration_minutes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Call duration in minutes, derived from the recording/transcript. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," when the duration is unknown."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls[].id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The call's public ID. Pass as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["call_id"]}," to get_call for the transcript, Questions & Answers, and Key Takeaways."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls[].job_title"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The interviewee's job title, e.g. 'VP of Procurement'."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls[].name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The interviewee's name as recorded. Not anonymized: MCP returns the original even for calls that have been through redaction, matching the Junior web app. get_call returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["anonymity_status"]}," if you need to know whether a call was redacted."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls[].organization"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The interviewee's employer."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls[].rating"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls[].segment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The call's segment — a per-project label grouping calls by interviewee type, e.g. 'Buyer' or 'Former Employee'. Call list_projects to see a project's segment vocabulary."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["calls[].source"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Where the call came from — free text, usually an expert-network name such as 'GLG' or 'AlphaSights', or an import label."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["next_cursor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pass as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cursor"]}," to fetch the next page. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," when this is the last page."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"list_entities","__idx":9},"children":["list_entities"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["List entities in a project"]}," · read-only · requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entities:read"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List entities (companies, products, etc.) recognized across the calls in a project."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"parameters-2","__idx":10},"children":["Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cursor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer (1–200) · default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["50"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["project_id"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["required"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string (uuid)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Project UUID"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Optional entity-type filter (e.g. \"company\", \"product\"). Omit to return all types."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"response-2","__idx":11},"children":["Response"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entities"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Entities recognized across the project's calls."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entities[].category"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entities[].competitor_tier"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entities[].created_at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 timestamp of when the entity was first recognized in this project."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entities[].description"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entities[].domain"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The entity's web domain, where one has been resolved."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entities[].id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Entity UUID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entities[].is_competitor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entities[].name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Entity name as recognized across the project's calls."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entities[].overview"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["entities[].type"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Entity type, e.g. 'company' or 'product'. Pass as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["type"]}," to filter."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["next_cursor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pass as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cursor"]}," to fetch the next page. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," when this is the last page."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"list_projects","__idx":12},"children":["list_projects"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["List projects"]}," · read-only · requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["projects:read"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["List projects in your organization (most recent first). Defaults to projects you actively run as creator or lead (scope=\"mine\"). Pass scope=\"all\" to include projects you were auto-added to as a member. Each project includes its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["segments"]}," — the segment names calls in that project are tagged with. Read these first when a user asks to filter calls by segment, then pass the exact value to list_calls' segment_contains."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"parameters-3","__idx":13},"children":["Parameters"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cursor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Opaque pagination cursor from a previous response"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["include_archived"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean · default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Include archived projects in the result"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["integer (1–100) · default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["25"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Max rows to return (1–100, default 25)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["scope"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"mine\""]}," | ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"all\""]}," · default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"mine\""]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Which projects to list. \"mine\" (default) = projects you created or are a lead of. \"all\" = every project you have any membership in."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"response-3","__idx":14},"children":["Response"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["next_cursor"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Pass as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cursor"]}," to fetch the next page. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," when this is the last page."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["projects"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your projects, most recently created first."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["projects[].created_at"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ISO 8601 timestamp of when the project was created."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["projects[].id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Project UUID. Pass as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["project_id"]}," elsewhere."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["projects[].is_archived"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["boolean | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Archived projects are hidden by default; pass ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["include_archived"]}," to list them."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["projects[].name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Project name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["projects[].role"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your role on this project — 'lead' or 'member'. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," on a project you created but were never explicitly added to."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["projects[].sector"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Reserved. Currently returns ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["projects[].segments"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["array of string"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The segment names calls in this project are tagged with, e.g. 'Buyer', 'Competitor', 'Former Employee'. Segments are per-project — read these before filtering list_calls by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["segment_contains"]}," rather than guessing a value."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["projects[].status"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["—"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["projects[].summary"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["string | null"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Short description of the project's research scope."]}]}]}]}]}]},"headings":[{"value":"MCP tool reference","id":"mcp-tool-reference","depth":1},{"value":"At a glance","id":"at-a-glance","depth":2},{"value":"Reference","id":"reference","depth":2},{"value":"get_call","id":"get_call","depth":3},{"value":"Parameters","id":"parameters","depth":4},{"value":"Response","id":"response","depth":4},{"value":"list_calls","id":"list_calls","depth":3},{"value":"Parameters","id":"parameters-1","depth":4},{"value":"Response","id":"response-1","depth":4},{"value":"list_entities","id":"list_entities","depth":3},{"value":"Parameters","id":"parameters-2","depth":4},{"value":"Response","id":"response-2","depth":4},{"value":"list_projects","id":"list_projects","depth":3},{"value":"Parameters","id":"parameters-3","depth":4},{"value":"Response","id":"response-3","depth":4}],"frontmatter":{"title":"MCP tool reference","seo":{"title":"MCP tool reference"}},"lastModified":"2026-07-28T04:52:37.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp-connector/tools","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}