Ferramentas MCP
Nomes canônicos de src/tool-catalog.ts. Aliases continuam funcionando; integrações novas devem chamar a ferramenta canônica.
Fonte da verdade: src/tool-catalog.ts no engine. Contagens e nomes desta
página vêm desse arquivo, não de um README.
Tokens MCP novos usam o toolset agent por padrão. Tokens criados antes de
2026-08-17 veem all (fail-open). graph e ops são aditivos.
Ferramentas deprecadas continuam visíveis em all durante a janela de alias.
Não as ensine a um cliente novo.
Toolset agent (padrão)
Recall:
| Ferramenta | Serve para |
|---|---|
memory_retrieve | Uma pergunta bem formada. O servidor expande e funde. Gêmea REST: POST /search. |
memory_prepare | Montar contexto para uma tarefa. Gêmea REST: POST /api/v1/memory/prepare. |
working_context | Início de sessão mais barato: fatos estáveis + decisões recentes. |
memory_grep | String exata, id, data, chave. |
get / multi_get | Corpo completo de um doc que você já achou. |
keyed_facts_as_of | Snapshots de fatos com viagem no tempo. |
whoami | Confirmar tenant / usuário / agente. Só HTTP. |
memory_health | Saúde do índice e do pipeline. |
Escrita e correção:
| Ferramenta | Serve para |
|---|---|
memory_store | Resultado durável e tipado (decision, problem, lesson, …). |
memory_used | Declarar os docids em que você realmente se apoiou. verdict opcional. |
upsert_keyed_fact | Escrever um snapshot de fato datado. |
assert_authority_correction | Corrigir um valor errado para a próxima sessão ver a verdade. |
record_lesson | Um aprendizado que deve mudar comportamento futuro. |
memory_curate | pin / snooze / unpin / unsnooze. |
memory_forget | A escrita menos reversível — standalone de propósito. |
append_entity_card | Caminho de escrita no KG que agentes realmente usam. |
diary | Leitura/escrita do diário do agente. |
Estado de trabalho e time:
| Ferramenta | Serve para |
|---|---|
scratchpad | Rascunho de sessão. |
task_state | Ledger de objetivo / progresso. |
profile | Perfil do usuário. |
team_briefing | Inbox, handoffs, missão. |
team_handoff | create / consume. |
team_inbox / team_message / team_notify_human / team_roster | Team OS (no-op se o tenant não tem membros). |
episodes | list / get de memórias episódicas. |
notifications | check / mark_read. |
list_lessons | Lições gravadas para este tenant. |
Toolset graph
Grafo de conhecimento, decisões, proveniência, conflitos. Nomes canônicos:
kg_query, kg_explain, kg_entity_resolve_report, kg_quarantine,
list_entity_cards, find_causal_links, memory_evolution_status,
provenance, conflicts, memory_arcs, timeline, find_similar,
decisions. ripple_rag_retrieve é beta.
Nomes antigos (record_decision, trace_lineage, detect_conflicts, …)
são aliases dessas ferramentas canônicas. Continuam funcionando.
Toolset ops
Curadoria e medição: lifecycle_*, reindex, index_stats,
import_docs, export_docs, vault_sync, list_vaults, beads_sync,
build_graphs, operations, usage_report, feedback.
Deprecadas — não ensine
| Nome | Realidade |
|---|---|
store | Duplicata só-HTTP de memory_store. |
list_proposals | Só HTTP; memory_health já mostra propostas. |
A página de marketing em /docs ainda diz "MCP store tool". Esse nome é o
deprecado. Chame memory_store.