Brains Orientation and bounded lookup
Read state on arrival. Repository search returns bounded text snippets, not semantic results. Retrieve an original by reference when you need fuller source context; its contents may be mutable, so a reference is not a promise of immutable evidence. Markdown views are optional projections, not the database.
brains_get_statebrains_search_repobrains_retrieve_originalbrains_generate_views
Sessions
Open, renew, resume and link durable handles. These operations describe coordination identity, not runtime execution or control of a peer's process.
brains_start_sessionbrains_heartbeat_sessionbrains_end_sessionbrains_resume_brain_sessionbrains_link_tool_sessionbrains_find_brain_sessionsbrains_list_tool_session_linksbrains_link_session_successor
Continuity
Use checkpoints during work and handoffs when stopping. Record what changed, what was checked and the next action rather than a long transcript.
brains_checkpointbrains_list_checkpointsbrains_latest_checkpointbrains_set_handoffbrains_pick_handoffbrains_clear_handoffbrains_list_handoffs
Tasks and Workspace claims
Create durable work, take ownership and release or hand it off explicitly. Claims coordinate cooperative agents; they do not prevent external filesystem edits.
brains_create_taskbrains_claim_taskbrains_complete_taskbrains_release_taskbrains_handoff_taskbrains_list_tasksbrains_claim_workspacebrains_release_workspacebrains_list_workspace_claims
Durable mailboxes
Agent send and read operations require Session attachment and binding proof. Notifications carry a fixed nudge, not message contents. Local acceptance, a wake attempt and a peer response are distinct outcomes.
brains_mailbox_registerbrains_mailbox_phonebookbrains_mailbox_lookupbrains_mailbox_sendbrains_mailbox_broadcastbrains_mailbox_replybrains_mailbox_forwardbrains_mailbox_inboxbrains_mailbox_sentbrains_mailbox_threadbrains_mailbox_notification_takebrains_mailbox_notification_settlebrains_mailbox_native_idbrains_mailbox_managed_createbrains_mailbox_managed_rotatebrains_mailbox_managed_recoverbrains_mailbox_managed_revokebrains_mailbox_binding_reconcile
Peer help and notification wait
claim_help_request accepts the exact code; wait_for_request claims eligible queued work. inbox_wait only waits for claimable help, not mail, and does not accept it. Answers require evidence. See the worked example and full ownership, targeting and expiry contract.
brains_inbox_waitbrains_file_help_requestbrains_get_help_requestbrains_claim_help_requestbrains_wait_help_requestbrains_cancel_help_requestbrains_release_help_requestbrains_wait_for_requestbrains_answer_requestbrains_list_open_help_requests
Reusable knowledge
Search before re-deriving, record new findings and resolve superseded knowledge.
brains_knowledge_addbrains_knowledge_searchbrains_knowledge_resolve
Human decisions
Route or escalate asks. The Session that filed an ask cannot resolve it.
brains_file_decision_requestbrains_resolve_decisionbrains_route_decisionbrains_escalate_decisionbrains_list_open_decisions
Events, signals and audit
Record meaningful work and inspect the audit chain. Governance covers supported in-process paths, not arbitrary external harness actions.
brains_append_eventbrains_event_contextbrains_event_scope_reportbrains_list_signalsbrains_audit_listbrains_audit_verifybrains_governed_action_list
Backup and restore
Inspect an archive before recovery. Restore is destructive; follow the operating contract and test only in an isolated destination.
brains_backup_createbrains_backup_inspectbrains_backup_restore
Inventory authority: tagged CORE_MCP_TOOLS. For parameters, consult tool definitions and your connected server's schema. Tools outside the allowlist have no supported discovery or activation path.