Quickstart

# Run directly via npx (or npm install -g @sovseal/mcp-server)
npx -y --package=@sovseal/mcp-server sovseal doctor

// Add to your AI client's MCP configuration (Claude, Cursor, Windsurf, Antigravity)
{
  "mcpServers": {
    "sovseal": {
      "command": "npx",
      "args": ["-y", "@sovseal/mcp-server"]
    }
  }
}

npm install @sovseal/sdk

pip install sovseal-sdk

sovseal store "I prefer TypeScript over JavaScript for new projects"

// Your AI client automatically calls store_memory:
{
  "content": "I prefer TypeScript over JavaScript for new projects"
}

import { AgentStateClient } from "@sovseal/sdk";

const client = new AgentStateClient();
const memory = await client.store("I prefer TypeScript over JavaScript for new projects");
console.log("Memory stored ID:", memory.id);

from sovseal import MemoryClient

client = MemoryClient()
memory = client.store("I prefer TypeScript over JavaScript for new projects")
print("Memory stored ID:", memory["id"])

sovseal recall "what programming language do I prefer for new projects?"

// Your AI client automatically calls recall_memory:
{
  "query": "what programming language do I prefer for new projects?",
  "topK": 3
}

const hits = await client.recall("what programming language do I prefer for new projects?", { topK: 3 });
console.log(hits[0].text);

hits = client.recall("what programming language do I prefer for new projects?", top_k=3)
print(hits[0]["text"])