MemoryGraph exposes these MCP tools to your AI assistant.

Core Tools

store_memory

Store a new memory in the knowledge graph.

store_memory(
  type: string,       # Memory type: solution, problem, pattern, error, fix, etc.
  title: string,      # Short, searchable title
  content: string,    # Detailed content
  tags?: string[],    # Optional tags for categorization
  importance?: float, # 0.0-1.0, default 0.5
  context?: object    # Optional context (project_path, etc.)
)

Example:

store_memory(
  type="solution",
  title="Redis connection timeout fix",
  content="Increased pool size to 20 and added retry logic...",
  tags=["redis", "timeout", "production"],
  importance=0.8
)

recall_memories

Search for memories by query. Recommended for most recall operations.

recall_memories(
  query: string,           # Natural language search query
  memory_types?: string[], # Filter by types
  limit?: int,             # Max results (default 20)
  project_path?: string    # Filter by project
)

Example:

recall_memories(
  query="timeout solutions",
  memory_types=["solution", "fix"],
  limit=10
)

search_memories

Advanced search with fine-grained control.

search_memories(
  query?: string,              # Text search
  terms?: string[],            # Multiple search terms
  match_mode?: "any" | "all",  # OR vs AND matching
  memory_types?: string[],     # Filter by types
  tags?: string[],             # Filter by tags
  min_importance?: float,      # Minimum importance
  search_tolerance?: string,   # strict, normal, fuzzy
  limit?: int
)

get_memory

Retrieve a specific memory by ID.

get_memory(
  memory_id: string,
  include_relationships?: bool  # Include related memories
)

Relationship Tools

create_relationship

Link two memories with a typed relationship.

create_relationship(
  from_memory_id: string,
  to_memory_id: string,
  relationship_type: string,  # SOLVES, CAUSES, RELATED_TO, etc.
  context?: string,           # Description of relationship
  strength?: float            # 0.0-1.0
)

Relationship Types (35 total, organized by category):

Causal

• CAUSES - Direct cause of an effect
• TRIGGERS - Initiates or starts something
• LEADS_TO - Results in a consequence
• PREVENTS - Stops something from happening
• BREAKS - Causes failure or malfunction

Solution

• SOLVES - Solution resolves a problem
• ADDRESSES - Handles or deals with an issue
• ALTERNATIVE_TO - Different approach to same goal
• IMPROVES - Enhances or makes better
• REPLACES - Supersedes or substitutes

Context

• OCCURS_IN - Happens within a context
• APPLIES_TO - Relevant to a domain
• WORKS_WITH - Compatible or integrates with
• REQUIRES - Needs as a prerequisite
• USED_IN - Employed within something

Knowledge

• BUILDS_ON - Extends or develops from
• CONTRADICTS - Conflicts with
• CONFIRMS - Validates or supports
• GENERALIZES - Broader version of
• SPECIALIZES - More specific version of

Similarity

• SIMILAR_TO - Resembles or is like
• VARIANT_OF - Variation or version of
• RELATED_TO - General association
• ANALOGY_TO - Comparable in structure
• OPPOSITE_OF - Inverse or contrary to

Workflow

• FOLLOWS - Comes after in sequence
• DEPENDS_ON - Requires for operation
• ENABLES - Makes possible
• BLOCKS - Prevents progress
• PARALLEL_TO - Concurrent with

Evaluation

• EFFECTIVE_FOR - Works well for a purpose
• INEFFECTIVE_FOR - Does not work for a purpose
• PREFERRED_OVER - Better choice than
• DEPRECATED_BY - Replaced by newer approach
• VALIDATED_BY - Confirmed by evidence

get_related_memories

Find memories connected to a specific memory.

get_related_memories(
  memory_id: string,
  relationship_types?: string[],  # Filter by relationship type
  max_depth?: int                 # Traversal depth (default 1)
)

Management Tools

update_memory

update_memory(
  memory_id: string,
  title?: string,
  content?: string,
  tags?: string[],
  importance?: float
)

delete_memory

delete_memory(memory_id: string)

get_recent_activity

Get summary of recent memory activity.

get_recent_activity(
  days?: int,          # Look back period (default 7)
  project?: string     # Filter by project
)

Memory Types