API
MCP catalog (generated)
src/tool-catalog.ts, regenerated at docs build. Do not edit.
Source: /opt/valorbrain/src/tool-catalog.ts. New tokens default to the agent toolset.
99 names in the catalog (canonical + aliases + deprecated).
agent
memory_retrieve· RESTPOST /search· top tool, 63% share with the next fourmemory_recent· RESTGET /api/v1/memory/team-activity· FB-0095: author+recency retrieval — 'what did agent X do recently'; topic search can't answer author questionsmemory_prepare· RESTPOST /api/v1/memory/prepareworking_context· cheapest session-start orientationmemory_grep· exact-match lookups (ids, values, dates)get· absorbs multi_get via paths[] in WS3multi_get· merge into get (WS3)keyed_facts_as_of· temporal fact snapshotsmemory_store· RESTPOST /api/v1/memory/storememory_used· quality feedback loop — skill must require itupsert_keyed_factassert_authority_correction· correctability priorityauthority_restore_demotion· FB-0092/0093 — undo prose demotion (restore confidence, unhide, cancel pending work) by fact_key/demotion_work_idrecord_lessonmemory_curate· canonical pin/snooze/unpin/unsnooze (WS3); memory_forget stays separate — least reversible write, MRTR gatememory_pin·alias· →memory_curate· RESTPOST /documents/:id/pinmemory_snooze·alias· →memory_curatememory_forget· RESTPOST /documents/:id/forget· 294 REST calls — never judge by MCP alone; stays standalone (reversibility boundary)append_entity_card· KG write path agents actually usediary· canonical read/write (WS3); write action is write-scope gated per actiondiary_read·alias· →diarydiary_write·alias· →diaryscratchpad· REST/api/v1/scratchpad· gains ledger mode → task_state (WS3/WS5)set_goal·alias· →task_state· ORPHAN no more: task_state + skill teaching when to open a goalreport_progress·alias· →task_state· demand real era REST /plansprofileteam_briefingteam_handoff· WS3: gained action create|consume (default create); both verbs write-scoped as beforeteam_handoff_consume·alias· →team_handoffteam_inboxteam_messageteam_notify_humanteam_rosterwhoami· http-onlymemory_health· RESTGET /api/v1/memory/health· http-onlyacl_me· RESTGET /api/v1/acl/me· ADR-031 A4: domínios efetivos do chamador (união user+role+agent) com a fonte de cada grant — o trace real do simulador de governançalist_lessonsepisodes· canonical list/get (WS3); moved agent←graph 2026-08-17 — real usage (hermes-default calls list_memory_episodes) and episodic memory is core product, not curationget_memory_episode·alias· →episodeslist_memory_episodes·alias· →episodesnotifications· canonical check/mark_read (WS3); mark_read is write-scope gated per actionnotifications_check·alias· →notificationsnotifications_mark_read·alias· →notifications
graph
timeline· RESTGET /timeline/:id· retrieve auto-routes last-session; extended surfacefind_similar· RESTGET /graph/similar/:id· retrieve auto-routes related; extendedripple_rag_retrieve·beta· VB-3203 experimentdecisions· canonical record/relate/trace/similar/list (WS3); record/relate write-scope gated per action; auto-populated by decision-extractor hook (119 calls)record_decision·alias· →decisions· RESTPOST /api/v1/decisionslist_decisions·alias· →decisions· RESTGET /api/v1/decisionstrace_decision_chain·alias· →decisions· RESTGET /api/v1/decisions/chainfind_similar_decisions·alias· →decisions· RESTGET /api/v1/decisions/similaradd_decision_relation·alias· →decisions· RESTPOST /api/v1/decisions/relationskg_query· REST/api/v1/kg/explorekg_explain· ORPHAN: we sell KG explainability; skill teaches it in WS5kg_entity_resolve_reportkg_quarantine· canonical list/approve/reject (WS3); approve/reject write-scope gated per actionlist_kg_quarantine·alias· →kg_quarantine· REST/api/v1/kg/quarantineapprove_kg_quarantine·alias· →kg_quarantinereject_kg_quarantine·alias· →kg_quarantineentity_cards· canonical: lista cards + curadoria de apelido (propose/merge/reject — o tenant decide)list_entity_cards·alias· →entity_cardsfind_causal_links· retrieve auto-routes why→causalmemory_evolution_status· curation nicheprovenance· canonical trace/export (WS3)trace_lineage·alias· →provenance· REST/api/v1/provenance/lineageexport_provenance·alias· →provenance· REST/api/v1/provenanceconflicts· canonical detect/list/resolve (WS3); resolve write-scope gated per actiondetect_conflicts·alias· →conflicts· RESTPOST /api/v1/conflicts/detect· also auto-detected by consolidation ticklist_conflicts·alias· →conflicts· RESTGET /api/v1/conflictsresolve_conflict·alias· →conflicts· RESTPOST /api/v1/conflicts/resolvememory_arcs· canonical create/list (WS3); create write-scope gated per action; kills the list_arcs≡list_memory_arcs duplicatecreate_memory_arc·alias· →memory_arcs· orphan; re-teach after task_state landslist_arcs·alias· →memory_arcs· DUPLICATE of list_memory_arcs — merge in WS3list_memory_arcs·alias· →memory_arcs
ops
lifecycle_status· RESTGET /lifecycle/statuslifecycle_sweep· RESTPOST /lifecycle/sweeplifecycle_restore· RESTPOST /lifecycle/restore· SaaS restore button lives here (94 REST calls)reindexindex_statsimport_docsexport_docsvault_synclist_vaultsbeads_syncbuild_graphsoperations· canonical status/list/cancel (WS3); cancel keeps write scope via alias list until window closesoperation_status·alias· →operationsoperation_list·alias· →operationsoperation_cancel·alias· →operationsusage_reportharness_coverage· runtime delivery signal: MCP-active agents with zero ingestion — what file-level setup status cannot seefeedback· canonical submit/check (WS3); submit write-scope gated per actionfeedback_submit·alias· →feedbackfeedback_check·alias· →feedbacksecrets· cofre: memória guarda referência secret://<nome>, valor só sai por get auditado; escopo fail-closed secrets:read/secrets:writeacl_grants· RESTGET/POST/DELETE /api/v1/acl/grants· ADR-031 A4: admin CRUD de grants do source ACL (user|role|agent → domínio, reason obrigatória, validade temporal); escopo fail-closed acl_grants:read/acl_grants:write; mutação vai ao mutation_auditread_log· RESTGET /api/v1/read-log· ADR-031 B3: trilha 'quem leu, qual versão' (1 linha por consulta; query só como hash — LGPD; docs_touched = pares hash+revisão); escopo fail-closed read_log:read; a própria consulta é auditada em mutation_auditlist_proposals·deprecated· http-only; memory_health already surfaces proposals — kill in WS3store·deprecated· http-only duplicate of memory_store — kill in WS3