Skip to main content

MCP Integration Guide

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.

Quick Start

# 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

Available Tools

Tool

memory.search

Search your memory vault using semantic vector search + keyword matching.

{

"query": "architecture decisions for Q3",

"limit": 5,

"memory_type": "semantic"

}

Tool

memory.create

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"]

}

Tool

memory.recall

Recall relevant memories for a given context. Surfaces related knowledge automatically.

{

"context": "Working on authentication refactor",

"limit": 3

}

Tool

auto_inject

Automatically surface relevant memories based on current file context or URL.

{

"file_path": "src/auth/middleware.ts",

"imports": ["express", "jsonwebtoken"]

}

Claude Desktop Setup

  1. Install Claude Desktop from claude.ai/download
  2. Open Claude Desktop → Settings → Developer → Edit Config
  3. Add the Zdravo MCP server configuration to your claude_desktop_config.json:

    {

    "mcpServers": {

    "zdravo": {

    "command": "npx",

    "args": ["@zdravoai/mcp-server", "--api-key", "sk_zdravo_..."]

    }

    }

    }

  4. Restart Claude Desktop
  5. In a new chat, Claude will automatically have access to memory.search, memory.create, and memory.recall

Cursor Setup

  1. Open Cursor → Settings → MCP Servers
  2. Click "Add MCP Server" and paste:

    npx @zdravoai/mcp-server --api-key sk_zdravo_...

  3. Enable the server and verify connection status shows "Connected"
  4. In any chat, Cursor can now search and save memories automatically

API Reference

The MCP server exposes the following endpoints via SSE (Server-Sent Events):

GET /sse — SSE connection endpoint
POST /messages — Tool invocation endpoint
GET /api/mcp/health — Server health check

Troubleshooting

Connection refused

Ensure the API key is valid and starts with sk_zdravo_. Check that the MCP server process is running.

No memories found

Memories are user-scoped. Ensure you're using the correct API key for your account. Run GET /api/mcp/health to verify connection.

Rate limiting

The MCP server enforces 100 requests per minute. If you hit the limit, wait 60 seconds and retry. Enterprise plans have higher limits.