Quick Start

1. Sign Up

Go to metamemory.tech/dashboard/login and 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.

2. Add Your Embedding Provider Key

MetaMemory is BYOK (Bring Your Own Key) — you provide your own API key for an embedding provider. Go to Provider Keys in the dashboard and add a key for one of:

• OpenAI — text-embedding-3-small (recommended)
• Google Gemini — gemini-embedding-001
• Cohere — embed-v4.0
• Voyage AI — voyage-3
• Azure OpenAI, Mistral, Ollama, Qwen

Your key is validated with a test embedding call before saving, then encrypted with AES-256-GCM.

3. 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": "..." }
}

4. 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": "semantic",
    "limit": 5
  }'

The response includes ranked results with similarity scores. The semantic strategy uses your provider's embeddings for cosine similarity search.

5. Check Your Usage

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

Returns your tenant info, usage counters, and configured providers.