Memory Write
memory_writeSave a durable fact about a person, project, or thing with self-contained text and provenance. Use to remember user preferences, decisions, or project details for any AI.
Instructions
Store a durable fact the user will want remembered — provenanced, deduped, bitemporal. Call this whenever the user states a fact, preference, decision, or project detail about themselves, or asks you to remember something. source tags provenance. space: 'private' (default — your own space) or 'shared' (the team space). Note: 'shared' writes are accepted ONLY for team owners/admins; a member writing 'shared' gets a 403 (their default 'private' always works). Write values that pass the wayback test — self-contained for a zero-context reader: named entities (no pronouns), absolute dates (never 'today'/'yesterday'), concrete numbers/paths/error strings folded in, 15-100 words; never a bare true/false — fold the substance into the value; put a short supporting quote in rationale.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | Yes | Attribute name for the fact (e.g. 'status', 'preference') | |
| scope | No | Project scope id (default 'default') | default |
| space | No | Memory space routing: 'private' (default — your own space) or 'shared' (the team space) | private |
| value | Yes | The fact text itself — self-contained for a zero-context reader | |
| entity | Yes | Subject the fact is about (a named person, project, or thing) | |
| source | No | Provenance tag for where the fact came from | mcp |
| rationale | No | Short supporting quote or why this was saved |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| deduped | No | True if an identical fact already existed (no new row written) | |
| fact_id | No | Id of the stored (or deduped) fact — usable with fetch | |
| superseded | No | How many prior facts this write superseded |