Skip to content

Give your agent a memory in five lines.

remember() writes. recall() retrieves. Every record comes back typed and source-linked, with audit built in. Bring your own model keys; we run the memory.

MCP-compatible interface

Protocol-native by default.

The memory layer is MCP-compatible end to end. A focused public MCP interface exposes read, write, and retrieval. Advanced orchestration and behavioural enforcement remain internal.

Runtime primitive

Three verbs. One mental model.

Remember creates the record. Recall returns scoped context. Forget removes records while preserving the audit trail.

memory.tstypescript
await octa.remember({
  scope: "acme/launch",
  type: "episodic",
  content: "Beta opens March 20.",
  sources: ["linear:OCT-42"]
});

id

mem_01HZ

source

linear:OCT-42

audit

evt_3921

§ 01API surface

Clean, consistent endpoints.

The same memory primitives across every interface. Pick the surface that matches your runtime. The contract is identical between REST, the Python and JavaScript SDKs, and MCP.

  • Authentication

    Bearer · X-API-Key

    OCTAMEM_API_KEY in the Authorization header.

  • Memory · add

    POST /api/memory/add

    Store content as memory with optional prior context.

  • Memory · search

    POST /api/memory/search

    Query memory in natural language and get the result back.

  • Usage & account

    GET /api/memory/details

    Key validity, plan, memory used, and wallet balance.

  • Python SDK

    pip install octamem

    Typed, async-first. Works with any async runtime.

  • JavaScript SDK

    npm install octamem

    TypeScript-first. Edge-runtime compatible.

§ 02Quick start

Quick start examples.

Remember a record, recall it, inspect the source. Same shape across Python, JavaScript, and the REST API.

add_memory.py · python
from octamem import OctaMem

client = OctaMem(api_key="YOUR_API_KEY")

client.add(
    content="Launch date set for April 15. Beta opens March 20.",
    previous_context="Q1 product planning meeting",
)

§ 03Use cases

Where builders plug it in.

Long-term memory plugs into the shapes teams are already building. Four common patterns OctaMem is shaped for.

  • 01

    Chatbots.

    Long-term memory across sessions and model switches. The chatbot stops repeating itself.

  • 02

    AI Agents.

    Agents retain behavioural context, decisions, and preferences across tasks.

  • 03

    Copilots.

    Developer copilots that remember project structure, conventions, and patterns.

  • 04

    RAG Pipelines.

    Augment retrieval with structured user memory for personalised, traceable results.

§ 04Ready to integrate

Get your API key. Start building.

Builder includes 5,000 MOps a month, 10 GB of memory, and full SDK access for $49 a month. Move to larger workspaces, longer audit retention, or sovereign deployment when you need them. The code stays the same.

Builder · $49/month · 5,000 MOps · 10 GB included.