Getting Started

Quick Start

Last updated: March 2026

1. Sign Up

Go to metamemory.tech/dashboard/loginand enter your email. You'll receive a magic link — click it to sign in. No password needed.

After sign-in, you'll land on the dashboard with your API key. Next, connect an embedding provider key (OpenAI, Gemini, Cohere, Voyage, and more) — MetaMemory is BYOK, so memories are encoded through your own provider account. See the Provider Keys guide for setup.

2. Create Your First Memory

curl -X POST https://api.metamemory.tech/v1/memories \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "User prefers dark mode and concise TypeScript examples.",
    "userId": "user-123",
    "metadata": { "source": "onboarding" }
  }'

Response:

{
  "data": {
    "id": "a1b2c3d4-...",
    "content": "User prefers dark mode and concise TypeScript examples.",
    "tenantId": "your-tenant-id",
    "userId": "user-123",
    "createdAt": "2026-03-21T..."
  },
  "metadata": { "timestamp": "..." }
}

3. Search Memories

curl -X POST https://api.metamemory.tech/v1/memories/search \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What display theme does the user prefer?",
    "strategy": "auto",
    "limit": 5
  }'

The response includes ranked results with similarity scores. The auto strategy invokes the adaptive learning pipeline — Thompson Sampling picks the best retrieval strategy for your context, falling back to 5-channel fused retrieval when uncertain.

4. Check Your Usage

curl https://api.metamemory.tech/v1/account/usage \
  -H "Authorization: Bearer YOUR_API_KEY"

Returns your tenant info, current usage counters, and tier limits.

Next: Connect via MCP

If you're using Claude Code, ChatGPT Desktop, or another MCP-aware client, the fastest path is the MCP Quick Start — two lines of config and your AI remembers across sessions.

NextMCP Quick Start