MCP Tools Reference

MCP Tools Reference

MemoryVault exposes 40+ tools via the Model Context Protocol. Tools marked with (mutating) require write access and are hidden from read-only sessions.

Memory Operations

memory_save (mutating)

Save a new memory.

Parameter	Type	Required	Description
type	'note' | 'fact' | 'journal'	Yes	Memory type
content	string	Yes	Memory content
title	string	No	Title (for notes)
key	string	No	Unique lookup key (for facts)
tags	string	No	Comma-separated tags
source	string	No	Origin/attribution
confidence	number (0-1)	No	Initial confidence (default 0.7)
importance	number (0-1)	No	Initial importance (default 0.5)

memory_get

Retrieve a memory by ID.

Parameter	Type	Required	Description
id	string	Yes	Memory ID

memory_get_fact

Fast lookup of a fact by its key.

Parameter	Type	Required	Description
key	string	Yes	Fact key name

memory_search

Search memories with hybrid lexical + semantic retrieval.

Parameter	Type	Required	Description
query	string	Yes	Search query
type	string	No	Filter by memory type
mode	'lexical' | 'semantic' | 'hybrid'	No	Search mode (default hybrid)
limit	number (1-20)	No	Max results (default 20)
min_score	number (0-1)	No	Minimum semantic similarity score

memory_list

List memories with optional filters.

Parameter	Type	Required	Description
type	string	No	Filter by type
tag	string	No	Filter by tag
limit	number (1-100)	No	Max results (default 20)

memory_update (mutating)

Update an existing memory.

Parameter	Type	Required	Description
id	string	Yes	Memory ID
content	string	No	New content
title	string	No	New title
tags	string	No	New tags
source	string	No	New source
confidence	number (0-1)	No	New confidence
importance	number (0-1)	No	New importance
archived	boolean	No	Archive/unarchive

memory_delete (mutating)

Permanently delete a memory.

Parameter	Type	Required	Description
id	string	Yes	Memory ID

memory_stats

Get memory statistics grouped by type, plus archived count. No parameters.

memory_reindex (mutating)

Rebuild semantic vector embeddings from D1 memories.

Parameter	Type	Required	Description
limit	number (1-2000)	No	Max memories to reindex (default 500)
include_archived	boolean	No	Include archived memories
wait_for_index	boolean	No	Wait for Vectorize readiness (default true)
wait_timeout_seconds	number (1-900)	No	Max wait time (default 180)

---

Graph & Relationships

memory_link (mutating)

Create a typed relationship between two memories.

Parameter	Type	Required	Description
from_id	string	Yes	Source memory ID
to_id	string	Yes	Target memory ID
relation_type	'related' | 'supports' | 'contradicts' | 'supersedes' | 'causes' | 'example_of'	No	Relationship type (default related)
label	string	No	Human-readable label

memory_unlink (mutating)

Remove a relationship.

Parameter	Type	Required	Description
from_id	string	Yes	Source memory ID
to_id	string	Yes	Target memory ID
relation_type	string	No	Only remove links of this type

memory_links

Get all relationships for a memory.

Parameter	Type	Required	Description
id	string	Yes	Memory ID

memory_link_suggest

Get scored link recommendations.

Parameter	Type	Required	Description
id	string	No	Seed memory ID
query	string	No	Text query for suggestions
limit	number	No	Max suggestions (default 20)
min_score	number (0-1)	No	Minimum suggestion score
include_existing	boolean	No	Include already-linked memories

memory_path_find

Find paths between two memory nodes.

Parameter	Type	Required	Description
from_id	string	Yes	Start node
to_id	string	Yes	End node
max_hops	number	No	Max path length (from brain policy)
limit	number	No	Max paths returned (default 5)

memory_subgraph

Extract a focused subgraph around a seed.

Parameter	Type	Required	Description
seed_id	string	No	Center node ID
query	string	No	Text query for center
tag	string	No	Filter by tag
radius	number	No	Hop radius (from brain policy)
limit_nodes	number	No	Max nodes (default 120)
include_inferred	boolean	No	Include tag-inferred edges

memory_neighbors

Seeded neighborhood traversal.

Parameter	Type	Required	Description
id	string	No	Seed memory ID
query	string	No	Text query for seed
max_hops	number (1-4)	No	Traversal depth (default 1)
limit_nodes	number	No	Max nodes (default 80)
relation_type	string	No	Filter by relationship type
include_inferred	boolean	No	Include inferred edges

memory_graph_stats

Graph topology metrics.

Parameter	Type	Required	Description
include_inferred	boolean	No	Include inferred edges in stats
top_hubs	number	No	Number of top hub nodes (default 12)
top_tags	number	No	Number of top tags (default 12)

memory_tag_stats

Tag frequency and co-occurrence analytics.

Parameter	Type	Required	Description
limit	number (1-100)	No	Max tags (default 20)
min_count	number	No	Min occurrences (default 2)
include_pairs	boolean	No	Include co-occurrence pairs

---

Neural Operations

memory_activate

Spreading activation retrieval from a seed node.

Parameter	Type	Required	Description
seed_id	string	No	Starting memory ID
query	string	No	Text query for seed
hops	number (1-4)	No	Activation depth (default 2)
limit	number (1-100)	No	Max activated memories (default 20)
include_inferred	boolean	No	Traverse inferred edges

memory_reinforce (mutating)

Hebbian reinforcement — boost confidence/importance of a memory and spread to neighbors.

Parameter	Type	Required	Description
id	string	Yes	Memory to reinforce
delta_confidence	number	No	Confidence boost (default +0.04)
delta_importance	number	No	Importance boost (default +0.06)
spread	number (0-1)	No	Spread factor to neighbors (default 0.35)
hops	number (0-3)	No	Spread depth (default 1)

memory_decay (mutating)

Homeostatic decay for stale, poorly-connected memories.

Parameter	Type	Required	Description
older_than_days	number	No	Min age to decay (default 30)
max_link_count	number	No	Only decay memories with <= this many links (default 1)
decay_confidence	number	No	Confidence reduction (default 0.01)
decay_importance	number	No	Importance reduction (default 0.03)
limit	number	No	Max memories to decay (default 200)

---

Knowledge Management

memory_consolidate (mutating)

Find and merge duplicate or overlapping memories.

Parameter	Type	Required	Description
type	string	No	Filter by type
tag	string	No	Filter by tag
older_than_days	number	No	Min age
limit	number (1-1000)	No	Max candidates (default 300)

memory_forget (mutating)

Soft-archive or hard-delete memories matching filters.

Parameter	Type	Required	Description
id	string	No	Specific memory to forget
mode	'soft' | 'hard'	No	Soft = archive, hard = delete
tag	string	No	Filter by tag
older_than_days	number	No	Min age
max_importance	number	No	Only forget below this importance
limit	number (1-200)	No	Max memories (default 25)

memory_conflicts

Detect contradictions between high-confidence memories.

Parameter	Type	Required	Description
min_confidence	number (0-1)	No	Min confidence threshold (default 0.7)
limit	number	No	Max conflict pairs (default 40)
include_resolved	boolean	No	Include already-resolved conflicts

memory_conflict_resolve (mutating)

Track conflict resolution status.

Parameter	Type	Required	Description
a_id	string	Yes	First memory in conflict
b_id	string	Yes	Second memory in conflict
status	'needs_review' | 'resolved' | 'superseded' | 'dismissed'	Yes	Resolution status
canonical_id	string	No	Winning memory ID
note	string	No	Resolution notes

memory_entity_resolve (mutating)

Manage entity aliases (canonical + alias mapping).

Parameter	Type	Required	Description
mode	'resolve' | 'lookup' | 'list'	No	Operation mode
canonical_id	string	No	Canonical memory ID
alias_id	string	No	Single alias to map
alias_ids	string[]	No	Multiple aliases to map
archive_aliases	boolean	No	Archive alias memories after mapping
confidence	number (0-1)	No	Alias confidence (default 0.9)
note	string	No	Resolution note
limit	number	No	Max results for list mode

---

Trust & Policy

memory_source_trust_set (mutating)

Set the trust weight for a source.

Parameter	Type	Required	Description
source	string	Yes	Source identifier
trust	number (0-1)	Yes	Trust weight (0.5 = neutral)
notes	string	No	Trust rationale

memory_source_trust_get

Read the trust map.

Parameter	Type	Required	Description
source	string	No	Filter to specific source
limit	number	No	Max entries (default 200)

brain_policy_get

Read the effective brain policy. No parameters.

brain_policy_set (mutating)

Configure per-brain behavior defaults.

Parameter	Type	Required	Description
decay_days	number	No	Days before decay applies
max_inferred_edges	number	No	Cap on tag-inferred graph edges
min_link_suggestion_score	number	No	Threshold for link suggestions
retention_days	number	No	Max memory retention
private_mode	boolean	No	Privacy flag
snapshot_retention	number	No	Max snapshots to keep
path_max_hops	number	No	Path-find max depth
subgraph_default_radius	number	No	Default subgraph radius

---

Snapshots

brain_snapshot_create (mutating)

Create a point-in-time backup of all memories and links.

Parameter	Type	Required	Description
label	string	No	Snapshot label
summary	string	No	Description
include_archived	boolean	No	Include archived memories

brain_snapshot_list

List available snapshots.

Parameter	Type	Required	Description
limit	number	No	Max snapshots (default 50)

brain_snapshot_restore (mutating)

Restore memories and links from a snapshot.

Parameter	Type	Required	Description
snapshot_id	string	Yes	Snapshot to restore
mode	'replace' | 'merge'	No	Replace all or merge with existing
restore_policy	boolean	No	Also restore brain policy
restore_source_trust	boolean	No	Also restore source trust map

---

Objectives

objective_set (mutating)

Create or update an autonomous objective.

Parameter	Type	Required	Description
title	string	Yes	Objective title
id	string	No	Update existing objective
content	string	No	Detailed description
kind	'goal' | 'curiosity'	No	Objective type
horizon	'short' | 'medium' | 'long'	No	Time horizon
status	'active' | 'paused' | 'done'	No	Current status
priority	number (0-1)	No	Priority weight (default 0.8)
tags	string	No	Comma-separated tags

objective_list

List objectives.

Parameter	Type	Required	Description
kind	string	No	Filter by kind
status	string	No	Filter by status
limit	number	No	Max results (default 50)

objective_next_actions

Get ranked next actions across active objectives.

Parameter	Type	Required	Description
limit	number	No	Max actions (default 12)
include_done	boolean	No	Include completed objectives

---

Monitoring & Observability

memory_changelog

Event audit stream for memory operations.

Parameter	Type	Required	Description
limit	number (1-200)	No	Max events (default 25)
since	number	No	Unix timestamp lower bound
event_type	string	No	Filter by event type
entity_id	string	No	Filter by entity

memory_watch (mutating)

Manage event subscriptions with optional webhook delivery.

Parameter	Type	Required	Description
mode	'create' | 'list' | 'delete' | 'set_active' | 'test'	No	Operation mode
id	string	No	Watch ID (for delete/set_active/test)
name	string	No	Watch name (for create)
event_types	string[]	No	Event types to watch
query	string	No	Text filter
webhook_url	string	No	Webhook delivery URL
secret	string	No	Webhook secret header
active	boolean	No	Active state (for set_active)
limit	number	No	Max watches for list (default 100)

memory_explain_score

Get a detailed breakdown of how confidence and importance are computed for a memory.

Parameter	Type	Required	Description
id	string	Yes	Memory ID
at	number	No	Unix timestamp for what-if evaluation

---

Tool Discovery

tool_manifest

Canonical tool registry with schema hashes and release metadata.

Parameter	Type	Required	Description
tool	string	No	Filter to specific tool
include_schema	boolean	No	Include full inputSchema
include_hashes	boolean	No	Include definition hashes
include_deprecated	boolean	No	Include deprecated tools

tool_changelog

Versioned changelog of tool, endpoint, scoring, and auth changes.

Parameter	Type	Required	Description
since_version	string	No	Semver lower bound
since	number	No	Unix timestamp lower bound
limit	number (1-100)	No	Max entries (default 20)