Associate Memories
associate_memoriesCreate typed relationships between memories to build a knowledge graph, improving recall by surfacing related context; link single pairs or up to 500 associations in batch.
Instructions
Create typed relationships between memories. This builds a knowledge graph that improves recall by surfacing related context. Supports single-pair mode or batch mode with associations[] (max 500).
When to use:
After storing a new memory: link it to related existing memories
When a bug fix relates to an original feature implementation
When a new decision updates or invalidates a previous one
To connect patterns with their concrete examples
Authorable relationship types:
RELATES_TO: General relationship (default)
LEADS_TO: Causal relationship (A caused B)
OCCURRED_BEFORE: Temporal ordering
PREFERS_OVER: Chosen alternative
EXEMPLIFIES: Concrete example of a pattern
CONTRADICTS: Conflicts with another memory
REINFORCES: Strengthens another memory's validity
INVALIDATED_BY: Superseded by another memory
EVOLVED_INTO: Updated version of a concept
DERIVED_FROM: Implementation of a decision/pattern
PART_OF: Component of a larger effort
Read-only/internal relations:
System/internal relations such as SIMILAR_TO, PRECEDED_BY, EXPLAINS, SHARES_THEME, PARALLEL_CONTEXT, and DISCOVERED may appear in recall results, but they are not valid inputs for associate_memories.
Examples:
associate_memories({ memory1_id: "8f3a2c1e-5b7d-4e9a-a1c3-2d4f6b8e0a91", memory2_id: "3c9e7b2a-1f4d-4a8e-9b6c-5d2e8f1a7c34", type: "RELATES_TO", strength: 0.9 }) // bug fix → feature
associate_memories({ memory1_id: "3c9e7b2a-1f4d-4a8e-9b6c-5d2e8f1a7c34", memory2_id: "8f3a2c1e-5b7d-4e9a-a1c3-2d4f6b8e0a91", type: "EVOLVED_INTO", strength: 0.8 }) // old decision → new
associate_memories({ associations: [{ memory1_id: "8f3a2c1e-5b7d-4e9a-a1c3-2d4f6b8e0a91", memory2_id: "3c9e7b2a-1f4d-4a8e-9b6c-5d2e8f1a7c34", type: "RELATES_TO", strength: 0.8 }] })
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "associate_memories"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | PART_OF only. | |
| type | No | ||
| reason | No | PREFERS_OVER, CONTRADICTS, INVALIDATED_BY or EVOLVED_INTO only. | |
| context | No | PREFERS_OVER or PART_OF only. | |
| strength | No | 0.9+ direct causation, 0.7-0.9 strong, 0.5-0.7 moderate | |
| timestamp | No | INVALIDATED_BY only. | |
| confidence | No | EXEMPLIFIES, EVOLVED_INTO or DERIVED_FROM only. | |
| memory1_id | No | Source memory ID | |
| memory2_id | No | Target memory ID | |
| resolution | No | CONTRADICTS only. | |
| associations | No | Batch mode. Do not combine with top-level memory1_id/memory2_id/type/strength. | |
| observations | No | REINFORCES only. | |
| pattern_type | No | EXEMPLIFIES only: pattern label. | |
| transformation | No | DERIVED_FROM only. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| failed | No | Batch mode. | |
| message | Yes | ||
| success | Yes | False when any batch item failed. | |
| summary | No | Batch mode. | |
| succeeded | No | Batch mode. | |
| failed_count | No | Batch mode. | |
| created_count | No | Batch mode. |