diff --git a/api-reference/mcp.mdx b/api-reference/mcp.mdx
index 7d06474..1672167 100644
--- a/api-reference/mcp.mdx
+++ b/api-reference/mcp.mdx
@@ -88,14 +88,16 @@ Authoring tools mutate a draft model. Trait and sample edits apply only while th
 
 | Tool | Purpose |
 |------|---------|
-| `train` | Train a draft model, or re-tune a ready one. Runs asynchronously. |
-| `discover_traits` | Derive intrinsic traits from a draft model's samples. Runs asynchronously. |
-| `synthesize_samples` | Generate labelled samples from a draft model's trait definitions. Runs asynchronously. |
+| `train` | Train a draft model, or re-tune a ready one. Enqueues the run and returns immediately. |
+| `discover_traits` | Derive intrinsic traits from a draft model's samples. Blocks until the run completes, streaming progress. |
+| `synthesize_samples` | Generate labelled samples from a draft model's trait definitions. Blocks until the run completes, streaming progress. |
 | `tag_version` | Pin a tag to the active version. |
 | `untag_version` | Remove a tag. |
 | `activate_version` | Point the model at a version — roll back or pin. |
 
-`train`, `discover_traits`, and `synthesize_samples` return once the run is enqueued; the model reports a `busy` state until the run completes. Poll `get_model` for the state rather than waiting on the call.
+`train` returns once the run is enqueued — the model reports a `busy` state until the run completes; poll `get_model` for the outcome.
+
+`discover_traits` and `synthesize_samples` **block until the run finishes**, streaming progress on the same request. Calls may take several minutes. Poll `get_model` only if the call times out or the client disconnects.
 
 ## Models as resources