recall

Ferramenta MCP pública

recall

Finalidade

Faça uma consulta leve e tolerante, baseada no melhor esforço, e retorne as poucas memórias salvas mais relevantes antes de responder.

Quando usar

• Você precisa de uma resposta rápida sem escopo, e uma relevância aproximada mas útil é aceitável.
• O chamador quer um conjunto pequeno e classificado de memórias, não um pacote de contexto do tamanho de um prompt.
• Uma verificação no início da tarefa precisa do contexto de trabalho recente sem um filtro estrito de projeto/equipe.

Quando NÃO usar

• Não use quando uma correspondência fraca não puder ser apresentada como resposta; use search_memory para uma correspondência estrita.
• Não use para reunir várias memórias limitadas para injeção em um prompt; use recall_context.
• Não use para gravar, atualizar ou excluir memórias.
• A API REST aceita um conjunto de campos mais amplo que a ferramenta MCP pública; consulte /docs/api/memory para os filtros de scope, bucket, team e provenance.

Escopo necessário

• memory:read é obrigatório; as memórias retornadas continuam limitadas ao escopo do owner/equipe autenticado.

Parâmetros

Esquema de retorno

Uma resposta de texto classificada contendo a referência, a localização, o conteúdo e o limite de atribuição disponível de cada memória. Resultados vazios são uma resposta válida quando não há correspondência, não um sinal de autorização.

Exemplos

recall({
  query: "current MCP authentication decision",
  limit: 3
})

Erros

• 401/403: a solicitação não tem um bearer token válido ou não possui memory:read.
• Falha de validação: a sintaxe de query, limit ou dos filtros é inválida.
• Incompatibilidade de escopo ou equipe: o owner autenticado não pode visualizar o limite solicitado.

Ferramentas relacionadas

• search_memory — Use correspondência estrita e direcionada com filtros de projeto/equipe.
• recall_context — Use um pacote de contexto limitado com várias memórias.
• remember — Persista um fato ou uma decisão explicitamente duradoura.