PT
QuickstartMCPRESTIntegrationsGuidesApp
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. 85 tools in the catalog (canonical + aliases + deprecated). This is the one tool count the docs publish; other pages link here.

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; covers what profile served — profile and the scratchpad slice retired 2026-09-29 (ClawMem-era, 0 customer calls in 60 days)
  • 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_draft · ChatGPT profile only: HTTP signed, non-persistent draft; requires user identity and write scope
  • memory_store · REST POST /api/v1/memory/store
  • memory_used · quality feedback loop — skill must require it
  • upsert_keyed_fact · REST POST /api/v1/keyed-facts · action=proposals|approve|decline: fact proposals decided in the conversation; approve/decline need a person-bound token + human_order (REST twin: /api/v1/keyed-facts/proposals)
  • 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); aliases memory_pin/memory_snooze removed 2026-09-28 (VAL-104) — zero external callers
  • 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; aliases diary_read/diary_write removed 2026-09-28 (VAL-104)
  • task_state · WS5 flagship: goal/progress + J-Space ledger (checkpoint exige verificador+cobertura; open exige settled_by; Next nunca vazio); ledger persiste em keyed_fact ledger:{session}; aliases set_goal/report_progress removed 2026-09-28 (VAL-104); scratchpad (and its REST twin) retired 2026-09-29 — working state lives here; goal status=complete closes it: it leaves __goals__ and read (VAL-230)
  • commitments · REST GET/POST /api/v1/commitments · registro de compromissos (ADR-087, migration 0272): promessas a quem é de fora da empresa; record por key, uma linha por promessa; close exige motivo (CHECK no banco); list open/due/overdue/closed/all; memory_prepare avisa os atrasados, os que vencem em 7 dias e os em_risco
  • team_briefing
  • team_handoff · WS3: gained action create|consume (default create); both verbs write-scoped as before; alias team_handoff_consume removed 2026-09-28 (VAL-104)
  • 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 — episodic memory is core product, not curation; aliases list_memory_episodes/get_memory_episode removed 2026-09-28 (VAL-104)
  • notifications · canonical check/mark_read (WS3); mark_read is write-scope gated per action; aliases notifications_check/notifications_mark_read removed 2026-09-28 (VAL-104)

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 · Datalog proof tree via pg_ripple.justify — reference docs/reference/kg-explain.md; proof_type: inferred | base (mirror-confirmed asserted) | absent | unverified | unknown (VAL-187). Derivation recording exists only in the pg_ripple semi-naive fixpoint (infer_with_stats/infer_goal/infer_wfs/remove_rule recalc) — the write path plain infer does not record, so runtime-derived facts answer unverified
  • 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); alias list_entity_cards removed 2026-09-28 (VAL-104)
  • find_causal_links · retrieve auto-routes why→causal
  • memory_evolution_status · curation niche
  • provenance · canonical trace/export (WS3); export format accepts turtle (default) or jsonld (PROV-JSON-LD)
  • 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 · MCP lifecycle_sweep retired 2026-09-29 (0 MCP calls in 60 days); the sweep stays on REST POST /lifecycle/sweep and the timer
  • lifecycle_restore · REST POST /lifecycle/restore · SaaS restore button lives here (94 REST calls)
  • reindex · vault_sync/list_vaults/beads_sync retired 2026-09-29 (ClawMem-era named vaults and Beads sync; near-zero use in 60 days)
  • index_stats
  • import_docs
  • export_docs
  • 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; alsoIn agent — contract item 5 mandates the defect loop on every agent connection (VAL-145)
  • 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
  • mental_models · beta · resposta permanente materializada por pergunta recorrente (port Hindsight): memory_prepare serve o answer com SELECT, tick reescreve em background por watermark de dados; flag mental_models (default off)
  • 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

Error catalog

Every ValorBrain error code with cause and action, generated from the engine catalog.

MCP tool schemas (generated)

registerTool() metadata from src/mcp-tools.ts, rebuilt with the docs.

On this page

agentgraphops