Zdravo is a memory substrate that any AI agent can read from and write to via MCP. This guide provides copy-paste-ready integration instructions.
# 1. Install the MCP server
npx @zdravoai/mcp-server --api-key YOUR_API_KEY
# 2. Configure your agent (Claude Desktop, Cursor, etc.)
{
"mcpServers": {
"zdravo": {
"command": "npx",
"args": ["@zdravoai/mcp-server", "--api-key", "YOUR_KEY"]
}
}
}
Get your API key from Dashboard → Settings → API Keys
Search your memory vault using semantic vector search + keyword matching.
{
"query": "architecture decisions for Q3",
"limit": 5,
"memory_type": "semantic"
}
Save a new memory to your vault. Auto-tags, embeds, and indexes.
{
"content": "Meeting decided to use PostgreSQL for the new service",
"title": "Database Decision - June 2026",
"tags": ["architecture", "database", "decision"]
}
Recall relevant memories for a given context. Surfaces related knowledge automatically.
{
"context": "Working on authentication refactor",
"limit": 3
}
Automatically surface relevant memories based on current file context or URL.
{
"file_path": "src/auth/middleware.ts",
"imports": ["express", "jsonwebtoken"]
}
claude_desktop_config.json:{
"mcpServers": {
"zdravo": {
"command": "npx",
"args": ["@zdravoai/mcp-server", "--api-key", "sk_zdravo_..."]
}
}
}
npx @zdravoai/mcp-server --api-key sk_zdravo_...
The MCP server exposes the following endpoints via SSE (Server-Sent Events):
Ensure the API key is valid and starts with sk_zdravo_. Check that the MCP server process is running.
Memories are user-scoped. Ensure you're using the correct API key for your account. Run GET /api/mcp/health to verify connection.
The MCP server enforces 100 requests per minute. If you hit the limit, wait 60 seconds and retry. Enterprise plans have higher limits.