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 · REST POST /search · top tool, 63% share with the next four
  • memory_recent · REST GET /api/v1/memory/team-activity · FB-0095: author+recency retrieval — 'what did agent X do recently'; topic search can't answer author questions
  • memory_prepare · REST POST /api/v1/memory/prepare
  • working_context · cheapest session-start orientation
  • memory_grep · exact-match lookups (ids, values, dates)
  • get · absorbs multi_get via paths[] in WS3
  • multi_get · merge into get (WS3)
  • keyed_facts_as_of · temporal fact snapshots
  • memory_store · REST POST /api/v1/memory/store
  • memory_used · quality feedback loop — skill must require it
  • upsert_keyed_fact
  • assert_authority_correction · correctability priority
  • authority_restore_demotion · FB-0092/0093 — undo prose demotion (restore confidence, unhide, cancel pending work) by fact_key/demotion_work_id
  • record_lesson
  • memory_curate · canonical pin/snooze/unpin/unsnooze (WS3); memory_forget stays separate — least reversible write, MRTR gate
  • memory_pin · alias · → memory_curate · REST POST /documents/:id/pin
  • memory_snooze · alias · → memory_curate
  • memory_forget · REST POST /documents/:id/forget · 294 REST calls — never judge by MCP alone; stays standalone (reversibility boundary)
  • append_entity_card · KG write path agents actually use
  • diary · canonical read/write (WS3); write action is write-scope gated per action
  • diary_read · alias · → diary
  • diary_write · alias · → diary
  • scratchpad · 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 goal
  • report_progress · alias · → task_state · demand real era REST /plans
  • profile
  • team_briefing
  • team_handoff · WS3: gained action create|consume (default create); both verbs write-scoped as before
  • team_handoff_consume · alias · → team_handoff
  • team_inbox
  • team_message
  • team_notify_human
  • team_roster
  • whoami · http-only
  • memory_health · REST GET /api/v1/memory/health · http-only
  • acl_me · REST GET /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ça
  • list_lessons
  • episodes · 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 curation
  • get_memory_episode · alias · → episodes
  • list_memory_episodes · alias · → episodes
  • notifications · canonical check/mark_read (WS3); mark_read is write-scope gated per action
  • notifications_check · alias · → notifications
  • notifications_mark_read · alias · → notifications

graph

  • timeline · REST GET /timeline/:id · retrieve auto-routes last-session; extended surface
  • find_similar · REST GET /graph/similar/:id · retrieve auto-routes related; extended
  • ripple_rag_retrieve · beta · VB-3203 experiment
  • decisions · 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 · REST POST /api/v1/decisions
  • list_decisions · alias · → decisions · REST GET /api/v1/decisions
  • trace_decision_chain · alias · → decisions · REST GET /api/v1/decisions/chain
  • find_similar_decisions · alias · → decisions · REST GET /api/v1/decisions/similar
  • add_decision_relation · alias · → decisions · REST POST /api/v1/decisions/relations
  • kg_query · REST /api/v1/kg/explore
  • kg_explain · ORPHAN: we sell KG explainability; skill teaches it in WS5
  • kg_entity_resolve_report
  • kg_quarantine · canonical list/approve/reject (WS3); approve/reject write-scope gated per action
  • list_kg_quarantine · alias · → kg_quarantine · REST /api/v1/kg/quarantine
  • approve_kg_quarantine · alias · → kg_quarantine
  • reject_kg_quarantine · alias · → kg_quarantine
  • entity_cards · canonical: lista cards + curadoria de apelido (propose/merge/reject — o tenant decide)
  • list_entity_cards · alias · → entity_cards
  • find_causal_links · retrieve auto-routes why→causal
  • memory_evolution_status · curation niche
  • provenance · canonical trace/export (WS3)
  • trace_lineage · alias · → provenance · REST /api/v1/provenance/lineage
  • export_provenance · alias · → provenance · REST /api/v1/provenance
  • conflicts · canonical detect/list/resolve (WS3); resolve write-scope gated per action
  • detect_conflicts · alias · → conflicts · REST POST /api/v1/conflicts/detect · also auto-detected by consolidation tick
  • list_conflicts · alias · → conflicts · REST GET /api/v1/conflicts
  • resolve_conflict · alias · → conflicts · REST POST /api/v1/conflicts/resolve
  • memory_arcs · canonical create/list (WS3); create write-scope gated per action; kills the list_arcs≡list_memory_arcs duplicate
  • create_memory_arc · alias · → memory_arcs · orphan; re-teach after task_state lands
  • list_arcs · alias · → memory_arcs · DUPLICATE of list_memory_arcs — merge in WS3
  • list_memory_arcs · alias · → memory_arcs

ops

  • lifecycle_status · REST GET /lifecycle/status
  • lifecycle_sweep · REST POST /lifecycle/sweep
  • lifecycle_restore · REST POST /lifecycle/restore · SaaS restore button lives here (94 REST calls)
  • reindex
  • index_stats
  • import_docs
  • export_docs
  • vault_sync
  • list_vaults
  • beads_sync
  • build_graphs
  • operations · canonical status/list/cancel (WS3); cancel keeps write scope via alias list until window closes
  • operation_status · alias · → operations
  • operation_list · alias · → operations
  • operation_cancel · alias · → operations
  • usage_report
  • harness_coverage · runtime delivery signal: MCP-active agents with zero ingestion — what file-level setup status cannot see
  • feedback · canonical submit/check (WS3); submit write-scope gated per action
  • feedback_submit · alias · → feedback
  • feedback_check · alias · → feedback
  • secrets · cofre: memória guarda referência secret://<nome>, valor só sai por get auditado; escopo fail-closed secrets:read/secrets:write
  • acl_grants · REST GET/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_audit
  • read_log · REST GET /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_audit
  • list_proposals · deprecated · http-only; memory_health already surfaces proposals — kill in WS3
  • store · deprecated · http-only duplicate of memory_store — kill in WS3

On this page