From 798aee394b8d43e02cfbbdf538db159d181b84ad Mon Sep 17 00:00:00 2001 From: Aakash Date: Thu, 27 Aug 2026 05:03:59 +0000 Subject: [PATCH] docs(mcp): document find_threads and existing thread tools Syncs Consensus-NLP/common#8238 and the create_thread/add_to_thread tools introduced in common#8236-8237. Co-Authored-By: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> --- consensus-mcp.mdx | 62 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 62 insertions(+) diff --git a/consensus-mcp.mdx b/consensus-mcp.mdx index ac4d997..6fa6662 100644 --- a/consensus-mcp.mdx +++ b/consensus-mcp.mdx @@ -302,6 +302,68 @@ Each search returns: - "Recent research on large language model hallucination from top tier journals" - "Use Consensus Deep Research to compare evidence for different treatments for insomnia" +## Research thread tools + +If your Consensus account has thread tools enabled, you can use the research thread tools below. They require a signed-in OAuth session; API-key and anonymous callers cannot use them. + +### create_thread + +Start a new research thread and dispatch the Consensus research agent. Use this for detailed, citation, synthesis, comparison, contradiction, literature-review, or multi-step research questions. For a simple list of papers, use `search` instead. + +#### Parameters + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| input_message | string | Yes | The complete research brief. Include the question, scope, constraints, and any ordered sub-tasks. | +| mode | string | No | Research depth. `pro` (default, ~20 papers, fast) or `deep` (~50 papers, up to 10 minutes, requires a paid account). | +| filters | object | No | Same structured filters as `search`. | +| attachments | object | No | Optional `paper_attachments` or `collection_ids` to scope the research. | + +#### Response + +Returns a dispatch confirmation with `thread_id`, `interaction_id`, `title`, `status` (`running`), `mode`, and a `url` to view the thread on Consensus. + +### add_to_thread + +Add a new interaction to an existing research thread. Use this only for a genuine follow-up after you see the previous interaction's results. + +#### Parameters + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| thread_id | string | Yes | The `thread_id` returned by `create_thread`. | +| input_message | string | Yes | A new follow-up question. | +| mode | string | No | `pro` (default) or `deep`. | +| title | string | No | The thread title, used only for the deep-link label. | +| filters | object | No | Same structured filters as `search`. | +| attachments | object | No | Same as `create_thread`. | + +#### Response + +Returns a dispatch confirmation with the new `interaction_id`, `thread_id`, `status` (`running`), `mode`, and `url`. + +### find_threads + +List your research threads. This is useful for finding or resuming a previous conversation. + +#### Parameters + +| Parameter | Type | Required | Description | +| --- | --- | --- | --- | +| query | string | No | Optional title substring search. Leave empty to list all threads. | +| limit | integer | No | Maximum threads to return. Default `20`, minimum `1`, maximum `100`. | +| offset | integer | No | Pagination offset. Default `0`. | + +#### Response + + + Array of thread objects, each with `thread_id`, `title`, `status` (`idle`, `running`, `failed`, or `unknown`), `preview`, `interaction_count`, `last_activity_at`, and `url`. + + + + `true` when more results are available. + + ## Troubleshooting