MemoryStores

MCP tools for the MemoryStores module. See the MemoryStores module docs for permissions and data model.

list-memory-stores

List memory stores

Arguments

Argument	Type	Required	Description
project_id	string	no	Project ID (required if not using project key auth)
tags	array	no	Filter by tag pairs, written key:value (split on the first colon, so a value may contain colons). Repeat the parameter for several pairs; all must be present with exactly that value.
limit	number	no	Results per page. Above the maximum it is clamped, and limit in the response reports the page served; below 1 or not an integer it is 400 VALIDATION_FAILED.
offset	number	no	Results to skip. Negative or not an integer it is 400 VALIDATION_FAILED.

create-memory-store

Create a memory store

Arguments

Argument	Type	Required	Description
project_id	string	no	Project ID (required if not using project key auth)
name	string	yes	Memory store name
description	string	no	Optional description
tags	any	no	Optional key-value tags. Scopes the memory store in knowledge search, where every requested pair must match exactly.
duplicate_threshold	number | null	no	The store's dedup policy: cosine similarity at or above which an incoming fact is already known and the write is skipped. null (the default) uses the algorithm constant 0.95. A single POST /api/v1/memories call may override it; the agent tool and the post-turn rule never can.
supersede_threshold	number | null	no	Cosine similarity at or above which an incoming fact restates a known one that has changed: the matched memory is invalidated and replaced. null (the default) uses the algorithm constant 0.90. Must be lower than the effective duplicate_threshold, or the write is rejected with 400 VALIDATION_FAILED — equal makes superseded unreachable and inverted swallows skipped.

get-memory-store

Get a memory store

Arguments

Argument	Type	Required	Description
memory_store_id	string	yes	—

update-memory-store

Update a memory store

Arguments

Argument	Type	Required	Description
memory_store_id	string	yes	—
name	string	no	Memory store name
description	string | null	no	Optional description
tags	any	no	Optional key-value tags. Replaces the stored bag; null clears it.
duplicate_threshold	number | null	no	The store's dedup policy: cosine similarity at or above which an incoming fact is already known and the write is skipped. null (the default) uses the algorithm constant 0.95. A single POST /api/v1/memories call may override it; the agent tool and the post-turn rule never can.
supersede_threshold	number | null	no	Cosine similarity at or above which an incoming fact restates a known one that has changed: the matched memory is invalidated and replaced. null (the default) uses the algorithm constant 0.90. Must be lower than the effective duplicate_threshold, or the write is rejected with 400 VALIDATION_FAILED — equal makes superseded unreachable and inverted swallows skipped.

delete-memory-store

Delete a memory store

Arguments

Argument	Type	Required	Description
memory_store_id	string	yes	—

list-memory-store-assertions

List a memory store's write assertions

Arguments

Argument	Type	Required	Description
memory_store_id	string	yes	—
mechanism	string	no	Only assertions that came through this door.
outcome	string	no	Only assertions that resolved this way.
generation_id	string	no	Only assertions made during this generation. A generation that does not exist matches nothing rather than widening to the whole store.
from	string	no	Only assertions recorded at or after this instant (ISO 8601).
to	string	no	Only assertions recorded at or before this instant (ISO 8601).
limit	number	no	Results per page. Above the maximum it is clamped, and limit in the response reports the page served; below 1 or not an integer it is 400 VALIDATION_FAILED.
offset	number	no	Results to skip. Negative or not an integer it is 400 VALIDATION_FAILED.

get-memory-store-tags

Get memory store tags

Arguments

Argument	Type	Required	Description
memory_store_id	string	yes	Memory store ID

replace-memory-store-tags

Replace memory store tags

Arguments

Argument	Type	Required	Description
memory_store_id	string	yes	Memory store ID

merge-memory-store-tags

Merge memory store tags

Arguments

Argument	Type	Required	Description
memory_store_id	string	yes	Memory store ID