diff --git a/docs/mcp.md b/docs/mcp.md
index c368f5d06..fb9b3cfc5 100644
--- a/docs/mcp.md
+++ b/docs/mcp.md
@@ -1862,12 +1862,13 @@ already walks Image Trace. Short agent entry points:
   `paint.setFill` and `paint.setStroke` (solid, none, gradient or pattern) and `paint.invert` and `paint.complement`
   on a solid color change that object's fill or stroke for this instance only when `ids`, `id` and `item` are omitted.
   `transparency.set` with opacity and/or blend does the same when `ids`, `id` and `item` are omitted; with `ids` or
-  `id` it edits those objects, so the instance's id changes the instance. It records an undo step only when the
-  override changes, so the same opacity again records none. `appearance.copyFrom` takes the source's fill and
-  stroke (including a gradient or pattern) for this instance only when `ids` is omitted and `reverse`, `append`
-  and `defaultsOnly` are false or omitted. With `ids`, and `reverse` false or omitted, it copies onto those
-  objects; with `reverse` true it copies from the first of `ids` onto `source`. The paint commands and the
-  Eyedropper each record one undo step. A painted stroke on type without a weight gets 1 pt. `paint.invert` and `paint.complement`
+  `id` it edits those objects, so the instance's id changes the instance. `appearance.copyFrom` takes the source's
+  fill and stroke (including a gradient or pattern) for this instance only when `ids` is omitted and `reverse`,
+  `append` and `defaultsOnly` are false or omitted, and only for each paint the Eyedropper Options pick up and
+  apply; a paint disabled in either tree stays as it was. With `ids`, and `reverse` false or omitted, it copies
+  onto those objects; with `reverse` true it copies from the first of `ids` onto `source`. The paint commands,
+  Transparency and the Eyedropper each record an undo step only when the override changes; an unchanged override
+  records none. A painted stroke on type without a weight gets 1 pt. `paint.invert` and `paint.complement`
   on a gradient or pattern, or on type whose characters differ in color, are refused with a status message, and so are
   Eyedropper options that pick up neither color, an Eyedropper source that is not a path, compound path or type (a
   symbol instance or a group, for which the paint defaults stay as they are too), isolate, knockout, knockoutShape,