From c7e207c290e376db5c2f210f9ac08fe170ef3ec4 Mon Sep 17 00:00:00 2001
From: morluto <76467478+morluto@users.noreply.github.com>
Date: Tue, 29 Sep 2026 18:42:57 +0800
Subject: [PATCH] docs: clarify aggregate context tools

---
 docs/mcp-contracts.md | 7 ++++---
 1 file changed, 4 insertions(+), 3 deletions(-)

diff --git a/docs/mcp-contracts.md b/docs/mcp-contracts.md
index 70fdb738c..bce580a8f 100644
--- a/docs/mcp-contracts.md
+++ b/docs/mcp-contracts.md
@@ -69,9 +69,10 @@ current/containing procedure. Its capability inventory exposes a
 the caller supplies `document` and the provider lacks `current_document`. A
 cursor outside a procedure is represented as
 `procedure: null`. `inspect_address_context` requires an explicit address and
-returns bounded name, procedure, comment, inline-comment, and bookmark facets;
-unsupported facets are local `unavailable` outcomes. The scalar getters remain
-available while the aggregate contracts are evaluated.
+returns name, procedure, comment, inline-comment, and bookmark facets;
+unsupported facets are local `unavailable` outcomes. Use `current_document`,
+`current_address`, and `current_procedure` for direct single-field lookups; use
+the aggregate tools when you need related context together.
 
 ## Permission policy