> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sovseal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# sovseal MCP Setup Guide

> Step-by-step guide to installing and configuring @sovseal/mcp-server for any Model Context Protocol compliant AI client.

The **sovseal MCP Server** (`@sovseal/mcp-server`) provides a standardized Model Context Protocol interface. It allows any MCP-compliant AI client — including Claude Code, Cursor, Windsurf, Claude Desktop, and custom agent harnesses — to read and write persistent, zero-knowledge memories.

## Step-by-Step Installation

### Option A: Standard Stdio Server (Recommended)

Add `@sovseal/mcp-server` to your AI client's MCP configuration file (e.g. `claude_desktop_config.json`, `.cursor/mcp.json`, or `mcp.json`):

```json theme={null}
{
  "mcpServers": {
    "sovseal": {
      "command": "npx",
      "args": ["-y", "@sovseal/mcp-server@latest"]
    }
  }
}
```

### Option B: Pre-Configured Project Token

If using an existing project key or hosted sync:

```json theme={null}
{
  "mcpServers": {
    "sovseal": {
      "command": "npx",
      "args": ["-y", "@sovseal/mcp-server@latest"],
      "env": {
        "SOVSEAL_API_KEY": "sov_proj_00000000-0000-4000-8000-000000000000"
      }
    }
  }
}
```

## Available MCP Tools

Once installed, your AI client automatically gains access to the following persistent memory tools:

| MCP Tool           | Description                                                                                            |
| :----------------- | :----------------------------------------------------------------------------------------------------- |
| `sovseal_store`    | Store a new memory item (fact, context, preference, or snippet) with automatic client-side encryption. |
| `sovseal_recall`   | Query relevant memories using 0-RTT local vector search.                                               |
| `sovseal_snapshot` | Inspect active memory keys, metadata counts, and local vault health.                                   |

## Verification

To verify that your MCP server is running cleanly:

```bash theme={null}
npx @sovseal/mcp-server --version
```

Output:

```text theme={null}
@sovseal/mcp-server v1.240.0 (stdio)
Local vault status: initialized (0 RTT)
Encryption boundary: client-side AES-256-GCM
```