Memory MCP Server

The thin memory MCP server (ainative-zerodb-memory-mcp) provides 6 tools optimized for agent memory workflows. 92% smaller than the full server.

npm i ainative-zerodb-memory-mcp

Tools Reference

zerodb_store_memory

Store a memory with content and metadata. Auto-generates embeddings.

Parameters:

Name	Type	Required	Description
content	string	yes	Memory text to store
metadata	object	no	Arbitrary metadata (user_id, source, tags)
importance	number	no	0.0-1.0, default 0.5

Example:

{
  "content": "User prefers dark mode and uses Python",
  "metadata": {"user_id": "u_123", "source": "chat"},
  "importance": 0.8
}

---

zerodb_search_memory

Search memories by keyword or metadata filters.

Parameters:

Name	Type	Required	Description
query	string	yes	Search query
limit	number	no	Max results (default 10)
metadata_filter	object	no	Filter by metadata fields

---

zerodb_semantic_search

Semantic similarity search — finds memories by meaning, not keywords.

Parameters:

Name	Type	Required	Description
query	string	yes	Natural language query
limit	number	no	Max results (default 10)
min_score	number	no	Minimum similarity threshold (0.0-1.0)

---

zerodb_get_context

Get the current session context window — recent memories and key facts for the active session.

Parameters:

Name	Type	Required	Description
session_id	string	no	Session identifier
limit	number	no	Max context items (default 20)

---

zerodb_embed_text

Generate embeddings for text without storing. Useful for pre-processing or comparison.

Parameters:

Name	Type	Required	Description
text	string	yes	Text to embed

Returns: 768-dimensional vector (BAAI/bge-base-en-v1.5).

---

zerodb_clear_session

Clear all session-scoped memories. Does not affect persistent memories.

Parameters:

Name	Type	Required	Description
session_id	string	no	Session to clear (defaults to current)

Configuration

{
  "mcpServers": {
    "zerodb-memory": {
      "command": "npx",
      "args": ["-y", "ainative-zerodb-memory-mcp"],
      "env": {
        "ZERODB_API_KEY": "your-api-key",
        "ZERODB_PROJECT_ID": "your-project-id"
      }
    }
  }
}

When to Use This vs Full Server

Use Case	Memory Server	Full Server
Agent memory (store/recall)	Yes	Yes
Vector search	No	Yes
File storage	No	Yes
NoSQL tables	No	Yes
PostgreSQL	No	Yes
Bundle size	~50KB	~500KB

Use the memory server when your agent only needs memory. Use the full server when you need the complete ZeroDB data layer.