diff --git a/docs/specification.md b/docs/specification.md
index 4accaad8b..dbe7bd381 100644
--- a/docs/specification.md
+++ b/docs/specification.md
@@ -22063,6 +22063,7 @@ Bridges external MCP servers into the tool model:
    - Creates a checkpoint if the tool is marked checkpointable
 
    After the MCP tool returns its `content[]` response, the adapter:
+   - **Error detection**: If `isError: true` is present in the response, the error message is extracted from `content[0].text` per the MCP 1.4.0 protocol (the non-standard top-level `error` key is not used). Falls back to `"unknown error"` when `content` is absent or malformed.
    - Parses the result into the CleverAgents `Result` format
    - Records any resource mutations as `Change` objects in the plan's `ChangeSet`