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