Tools Reference

The MemMachine Model Context Protocol (MCP) tools provide a dedicated, simplified interface for Large Language Models (LLMs) to interact with the memory system. These endpoints are designed to be concise and perform the core functions of memory management: adding new context, searching for existing context, and deleting memories. These tools work with both Episodic Memory (short-term conversation history) and Semantic Memory (long-term user profile and facts).

​

1. add_memory

​

Summary

Store important new information about the user or conversation into memory.

​

Description

Use this automatically whenever the user shares new facts, preferences, plans, emotions, or other details that could be useful for future context. Crucially, include the full conversation context in the content field — not just a snippet. This tool writes to both short-term (episodic) and long-term (profile) memory, so that future interactions can recall relevant background knowledge even across different sessions.

​

Parameters

​

Responses

​

2. search_memory

​

Summary

Retrieve relevant context, memories, or profile information for a user.

​

Description

Use this whenever context is missing or unclear, or when you need to recall what has been previously discussed, even if it was from an earlier conversation or session. This searches both Profile Memory (long-term user traits and facts) and Episodic Memory (past conversations and experiences) for the most relevant results.

​

Parameters

​

Responses

​

3. delete_memory

​

Summary

Delete specific memories from the user’s memory store.

​

Description

Use this to remove outdated, incorrect, or sensitive information that should no longer be retained. Specify the unique IDs of the memories to delete from episodic or semantic memory stores. Note: Episodic memories and semantic memories are deleted separately as they have different ID spaces. You can obtain memory IDs from the search_memory results.

​

Parameters

​

Responses