MCP reference

remember, recall and forget, with examples and safe updates.

Server and authentication

The server uses Streamable HTTP at /mcp. It supports OAuth sign-in and Bearer API keys. Clients only see operations allowed by their scopes; permissions are also checked when an operation runs.

https://agenticmemory.app/mcp

remember

Creates a memory or replaces its entire Markdown content. It does not automatically append text. expectedVersion: 0 requires that the memory does not already exist. Replace the example slugs with your own.

{
  "space": "my-project",
  "memory": "architecture",
  "title": "Architecture",
  "content": "# Architecture\n\nThis project uses PostgreSQL.",
  "expectedVersion": 0
}

recall · exact

Retrieves the complete document and its version using space and memory.

{
  "space": "my-project",
  "memory": "architecture"
}

Update without overwriting changes

First call recall, edit the complete document and call remember with expectedVersion set to the version you just read. If another agent changed it, a conflict is returned: read again before saving. Omitting expectedVersion removes that concurrency protection.

forget

Moves a memory to Trash. Requires memory:forget. This example only acts if the current version is 1; use the actual version returned by recall.

{
  "space": "my-project",
  "memory": "architecture",
  "expectedVersion": 1
}