Memory MCP Server

The thin memory MCP server (ainative-zerodb-memory-mcp) provides 10 tools optimized for agent memory and structured reasoning 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)

---

Plan Artifact Tools

Plan artifacts are structured, versioned documents — PRDs, plans, task lists, reasoning traces — stored persistently in ZeroDB with full diff history on every update. Added in v1.2.0.

zerodb_plan_create

Create a new plan artifact.

Parameters:

Name	Type	Required	Description
title	string	yes	Plan title
content	string	yes	Plan body (markdown supported)
tags	array	no	String tags for filtering
metadata	object	no	Arbitrary key-value metadata

Returns: { id, title, content, created_at, version }

Example:

{
  "title": "Q3 API Refactor Plan",
  "content": "## Goals\n- Migrate to async handlers\n- Add rate limiting",
  "tags": ["backend", "q3"]
}

---

zerodb_plan_get

Retrieve the latest version of a plan artifact by ID.

Parameters:

Name	Type	Required	Description
artifact_id	string	yes	Plan artifact ID

Returns: Latest version of the plan with full content and metadata.

---

zerodb_plan_update

Update a plan artifact. Every update creates a new version entry — full diff history is preserved.

Parameters:

Name	Type	Required	Description
artifact_id	string	yes	Plan artifact ID
content	string	yes	New plan content
title	string	no	Updated title
tags	array	no	Updated tags

Returns: Updated plan with new updated_at and version.

---

zerodb_plan_history

Get the full version history of a plan artifact, ordered newest first.

Parameters:

Name	Type	Required	Description
artifact_id	string	yes	Plan artifact ID

Returns: Array of all versions with timestamps and content diffs.

---

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
Plan artifacts (versioned docs)	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 and structured plans. Use the full server when you need the complete ZeroDB data layer.

Related

• Sequential Thinking MCP — persistent reasoning chains built on plan artifacts
• ZeroMemory Overview — cognitive memory architecture