recall

공개 MCP 도구

recall

목적

가볍고 유연한 best-effort lookup을 수행하고 답변 전에 저장된 memory 중 가장 관련 있는 몇 개를 반환합니다.

사용 시점

• 빠른 unscoped answer가 필요하고 약하지만 유용한 relevance를 허용할 수 있는 경우.
• 호출자가 prompt 크기의 context pack이 아니라 소량의 ranked memory set을 원하는 경우.
• task 시작 확인에서 엄격한 project/team filter 없이 최근 working context가 필요한 경우.

사용하지 않을 시점

• 약한 match를 answer로 제시해서는 안 되는 경우에는 사용하지 않습니다. 엄격한 matching에는 search_memory를 사용합니다.
• prompt injection을 위해 여러 bounded memory를 조립할 때 사용하지 않습니다. recall_context를 사용합니다.
• memory를 write, update 또는 delete할 때 사용하지 않습니다.
• REST API는 public MCP tool보다 더 넓은 field set을 허용합니다. scope, bucket, team 및 provenance filter는 /docs/api/memory를 참고합니다.

필수 스코프

• memory:read가 필요하며 반환되는 memory도 인증된 owner/team scope에 의해 계속 제한됩니다.

매개변수

반환 스키마

각 memory reference, location, content 및 사용 가능한 attribution boundary를 포함한 ranked text 응답입니다. 빈 결과는 authorization signal이 아니라 유효한 no-match 응답입니다.

예제

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

오류

• 401/403: 요청에 유효한 bearer token이 없거나 memory:read가 없습니다.
• Validation failure: query, limit 또는 filter syntax가 유효하지 않습니다.
• Scope 또는 team mismatch: 요청한 boundary가 인증된 owner에게 보이지 않습니다.

관련 도구

• search_memory — project/team filter를 사용한 엄격한 targeted matching을 수행합니다.
• recall_context — 범위가 제한된 multi-memory context pack을 사용합니다.
• remember — 명시적으로 영구적인 fact 또는 decision을 저장합니다.