Docs that ship code.

01Quickstart

This walks you from zero to a working recall in about five minutes. You'll need a free AgentPrizm account (sign up — the Hobby tier is free forever, see pricing) and any HTTP client — curl is fine.

1. Get your API key

Create a key in the dashboard under API keys. Keys are prefixed ap_. Set it in your environment:

export AGENTPRIZM_API_KEY=ap_xxxxxxxxxxxxxxxxxx

2. Ingest your first memory

Call the REST API directly — no SDK or local install required.

curl https://agentprizm.com/api/v1/agent/memories \
  -H "Authorization: Bearer $AGENTPRIZM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "Procurement freezes Dec 15 → Jan 5. Renewal owner: Priya.",
    "type": "fact",
    "containers": ["acme-co"],
    "source": "call-2026-01-12"
  }'

3. Recall it

curl https://agentprizm.com/api/v1/agent/recall \
  -H "Authorization: Bearer $AGENTPRIZM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "when can we close?",
    "containers": ["acme-co"],
    "limit": 5
  }'

4. Or connect over MCP — zero install

Point any MCP-capable agent (Claude Code, Cursor, Claude Desktop) at our remote MCP endpoint. No subprocess, no package to publish — just URL and key.

{
  "mcpServers": {
    "agentprizm-memory": {
      "type": "http",
      "url": "https://agentprizm.com/api/mcp",
      "headers": { "Authorization": "Bearer ap_..." }
    }
  }
}

02Core concepts

Memories

A memory is a single atomic item — one of six types: fact, lesson, directive, preference, contact, or bookmark. Each memory carries a type, source, confidence, optional tags, and an optional validity window, and belongs to one or more containers.

Containers

Containers partition memory across environments and tenants. sales-agent-prod and sales-agent-staging are isolated; recalls in one cannot see memories in the other.

Hybrid recall

Recall blends semantic (vector similarity) and keyword matching, then layers in fact-validity windows (recency + valid_from / valid_until) and contradiction handling (newer facts shadow older ones). You can pin or down-weight memories with validity and confidence filters.

Validity windows

Memories can carry validFrom / validUntil. Recalls outside the window return the memory with reduced confidence and a stale flag. The agent decides whether to use it or re-verify.

03API & tooling

The HTTP API and the remote MCP endpoint are live today — both work from any language or agent with zero local install. The REST API covers the full surface; the MCP endpoint exposes the same tools to any MCP-capable agent.

04Migration guide

Coming from Mem0, Zep, Letta, or your own Postgres + pgvector setup? You can move your data over today by reading from your current store and replaying records into the POST /api/v1/agent/memories endpoint — one memory per row, with type, containers, source, and validity windows mapped across.

# For each record in your existing store, POST it to AgentPrizm:
curl https://agentprizm.com/api/v1/agent/memories \
  -H "Authorization: Bearer $AGENTPRIZM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "content": "...", "type": "fact", "containers": ["prod"], "source": "mem0" }'

Want a hand with a large or one-shot migration? Talk to us — we'll help you map your schema and batch the import. Dedicated importer tooling is on the roadmap.

05Common patterns

Conversation summarization

Run an LLM summary at end of session, then ingest the key takeaways as type: "lesson" or type: "fact" with source: "conversation". Recall on the same container + topic in the next session — confidence-ranked memories surface first. (The /conversations endpoint can extract these for you.)

Preference learning

Capture preferences as type: "preference" with no validity window. Contradictions resolve newest-wins, so a newer preference shadows an older one automatically.

Tool-call grounding

Before any high-stakes tool call, recall the container's recent state and inject the top memories into the system prompt. The agent stops asking questions it has already asked.