Skip to main content

Quick Start

Get up and running with Memsolus in minutes. Choose the integration method that fits your stack.

Prerequisites

Using the SDK​

Install the SDK

npm install @memsolus/sdk

Initialize the client

import { Memsolus } from '@memsolus/sdk';

const client = new Memsolus({
  apiKey: process.env.MEMSOLUS_API_KEY,
});

Store a memory

const memory = await client.memories.add({
  content: 'The user prefers TypeScript over JavaScript for all new projects.',
  userId: 'user_123',
  priority: 'HIGH',
});

console.log(memory.id); // mem_abc123

Search memories

const results = await client.memories.search({
  query: 'programming language preferences',
  userId: 'user_123',
  mode: 'hybrid',
});

results.data.forEach((memory) => {
  console.log(memory.content, memory.score);
});

Get compiled knowledge

After Memsolus processes your memories, retrieve the compiled knowledge profile:

const knowledge = await client.knowledge.get({
  userId: 'user_123',
  merged: true,
});

console.log(knowledge.content);
// => Structured markdown with all knowledge about user_123

Using the REST API​

Create a memory:

curl -X POST https://api.memsolus.com/v1/memories \
  -H "X-Api-Key: msk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "content": "The user prefers TypeScript over JavaScript for all new projects.",
    "user_id": "user_123",
    "priority": "HIGH"
  }'

Search memories:

curl "https://api.memsolus.com/v1/memories/search?query=language+preferences&user_id=user_123&mode=hybrid" \
  -H "X-Api-Key: msk_live_..."

Get compiled knowledge:

curl "https://api.memsolus.com/v1/knowledge?user_id=user_123&merged=true" \
  -H "X-Api-Key: msk_live_..."

Using the MCP Server​

Add Memsolus to your Claude Desktop configuration:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "memsolus": {
      "command": "npx",
      "args": ["-y", "@memsolus/mcp"],
      "env": {
        "MEMSOLUS_API_KEY": "msk_live_..."
      }
    }
  }
}

Restart Claude Desktop, then try:

"Remember that I prefer TypeScript over JavaScript."

"What are my coding preferences?"

Claude will use Memsolus automatically to store and retrieve context.

What's Next​