Skip to content

Commit cd62dc6

Browse files
t3dotggclaude
andcommitted
docs(mcp): thread tools reach threads in any project
#15219 let MCP thread tools target any thread in the environment, but the orchestrator MCP doc still said they stop at the calling project. Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
1 parent 250e052 commit cd62dc6

1 file changed

Lines changed: 14 additions & 11 deletions

File tree

‎docs/orchestration-v2/orchestrator-mcp-server.md‎

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -331,15 +331,16 @@ launching again. `create_threads` remains the batch option for a shared checkout
331331

332332
### `t3_thread_list`
333333

334-
Lists durable thread shells in the calling thread's project, newest first.
335-
Callers can filter by title, run status, and whether app-owned sub-agent threads
336-
are included. Results are bounded and offset-paginated. Deleted threads and
337-
threads from other projects are never exposed.
334+
Lists durable thread shells in one project, newest first: `projectId` when
335+
given, else the calling thread's project. Callers can filter by title, run
336+
status, and whether app-owned sub-agent threads are included. Results are
337+
bounded and offset-paginated. Deleted threads are never listed.
338338

339339
### `t3_thread_read`
340340

341-
Reads a project-scoped thread's durable state, recent runs, and visible
342-
timeline. The default `messages` view returns user messages, assistant
341+
Reads the durable state, recent runs, and visible timeline of any thread in
342+
the environment by thread ID. A deleted thread returns `thread_not_found`. The
343+
default `messages` view returns user messages, assistant
343344
messages, and proposed plans. The `activity` view also returns summarized tool,
344345
reasoning, checkpoint, handoff, and runtime-request items. Large item text is
345346
bounded and reports whether it was truncated. `afterPosition` and
@@ -353,7 +354,7 @@ distinguishable from human-authored messages.
353354

354355
### `t3_thread_update`
355356

356-
Updates metadata for the calling thread or another thread in the same project.
357+
Updates metadata for the calling thread or any other thread in the environment.
357358
The typed actions are `rename`, `regenerate_title`, `link_pull_request`, and
358359
`unlink_pull_request`. A link input supplies the repository, number, and URL;
359360
the server records the target thread's project ID. Branch and workspace changes
@@ -367,7 +368,7 @@ detail also exposes an in-flight title regeneration.
367368

368369
### `t3_thread_send`
369370

370-
Sends a message to an ordinary or delegated thread in the calling project:
371+
Sends a message to any ordinary or delegated thread in the environment:
371372

372373
- `auto` starts an idle thread, steers a fully active turn, or queues behind a
373374
turn that is not yet steerable;
@@ -434,9 +435,11 @@ results use the latest assistant content from the final work turn.
434435
mode. It may not escalate privileges.
435436
- A child interaction mode may stay equal to or narrow from `default` to
436437
`plan`. It may not escalate from `plan` to `default`.
437-
- General thread management is limited to the calling thread's project. Send
438-
additionally enforces the same runtime and interaction privilege ceiling as
439-
child creation.
438+
- Thread tools take any thread in the environment as a target. For a thread
439+
caller, list and search cover one project: its own unless `projectId` is given.
440+
- A tool that changes another thread needs the calling thread's live run, and
441+
the target's runtime and interaction modes may not be broader than the
442+
caller's. This is the same privilege ceiling as child creation.
440443
- Provider instances must be enabled, installed, available, authenticated, and
441444
backed by a V2 adapter.
442445
- A requested model must be advertised by the selected provider when the

0 commit comments

Comments
 (0)