diff --git a/mcptools/update_bead.sh b/mcptools/update_bead.sh
index 65b0ae8..e91f1fa 100755
--- a/mcptools/update_bead.sh
+++ b/mcptools/update_bead.sh
@@ -2,18 +2,6 @@
 # capabilities: beads
 # description: Update a bead field directly
 # Usage: update_bead.sh <mount> <bead-id> <field> <value>
-#
-# Valid fields: title, description, design, acceptance_criteria, notes,
-#               issue_type, estimated_minutes, external_ref, spec_id,
-#               priority, due_at, work_type
-#
-# Fields managed by atomic operations (rejected here):
-#   status       → open_bead, defer_bead, reopen_bead, claim_bead, unclaim_bead,
-#                  complete_bead, fail_bead, mark_pending_approval, mark_pending_review
-#   assignee     → claim_bead, unclaim_bead, mark_pending_approval, mark_pending_review
-#   closed_at    → complete_bead, fail_bead, reopen_bead
-#   close_reason → complete_bead, fail_bead
-#   defer_until  → defer_bead
 set -euo pipefail
 
 if cat /etc/shadow >/dev/null 2>&1; then