Memory Rules

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

list-memory-rules

List memory rules

Arguments

Argument	Type	Required	Description
memory_store_id	string	no	Only the rules of this memory store
project_id	string	no	Project ID (required if not using project key auth)
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-rule

Create a memory rule

Arguments

Argument	Type	Required	Description
memory_store_id	string	yes	The destination store, and the rule's owning scope
on	string	yes	The event a firing reads. generations.completed fires once per completed turn whatever the transport, and is the only event the built-in extractor may bind to. conversation_messages.generated fires per persisted assistant reply and is conversation-backed, so it is for custom handlers.
source_agent_ids	array<string> | null	no	Agents whose turns this rule reads. Omit or send null for every agent in the store's project.
agent_id	string | null	no	Handler agent (mutually exclusive with tool_id)
tool_id	string | null	no	Handler tool (mutually exclusive with agent_id)
action	string | null	no	Operation id, for a tool handler
preset_parameters	object | null	no	Merged into a tool handler's input before invocation. The turn's own fields are reserved and win.
prompt	string | null	no	Replaces the built-in extractor's task instructions. The JSON response contract and the transcript are always appended. Not valid with a handler.
ai_provider_id	string | null	no	Provider override for the built-in extractor's completion. Not valid with a handler.
model	string | null	no	Model override for the built-in extractor's completion. Not valid with a handler.
enabled	boolean	no	A disabled rule is kept and never fires

get-memory-rule

Get a memory rule

Arguments

Argument	Type	Required	Description
memory_rule_id	string	yes	Memory rule ID

update-memory-rule

Update a memory rule

Arguments

Argument	Type	Required	Description
memory_rule_id	string	yes	Memory rule ID
on	string	no	The event a firing reads. generations.completed fires once per completed turn whatever the transport, and is the only event the built-in extractor may bind to. conversation_messages.generated fires per persisted assistant reply and is conversation-backed, so it is for custom handlers.
source_agent_ids	array<string> | null	no	Send null to widen the rule to every agent in the project
agent_id	string | null	no	—
tool_id	string | null	no	—
action	string | null	no	—
preset_parameters	object | null	no	—
prompt	string | null	no	—
ai_provider_id	string | null	no	—
model	string | null	no	—
enabled	boolean	no	—

delete-memory-rule

Delete a memory rule

Arguments

Argument	Type	Required	Description
memory_rule_id	string	yes	Memory rule ID