Next: , Previous: , Up: MCP Tools   [Contents][Index]

5.9 The forget tool

Deletes a memory. Soft-delete by default (the row stays but is hidden from recall/list_memories/text_search and becomes a tombstone that the dedup-on-write check consults). Pass hard_delete=true to drop the row entirely.

5.9.1 Inputs

id

Required integer. The memory’s id.

hard_delete

Boolean. Optional, default false. When true, the row is removed from the database completely.

reason

String. Optional. Free-text reason recorded as forget_reason. Rejected with INVALID_INPUT if hard_delete=true (a hard delete has no row to attach the reason to).

replaced_by_id

Integer. Optional. Id of the memory that supersedes this one. Same restriction as reason: not allowed with hard_delete.

5.9.2 Output

{
  "ok": true,
  "memory_id": 123,
  "message": "Forgotten"
}

5.9.3 Errors

INVALID_INPUT, NOT_FOUND, DATABASE_ERROR.