Docs / MCP · Versioned contract

Connect through stdio.

The public documentation targets ax0s-memory 0.5.0; the CLI parser, MCP stdio startup, and recall serialization paths are implemented and test-covered.

Paste valid JSON into the MCP client configuration.

The client process must resolve python to the environment where Ax0s memory is installed. The optional idle setting below matches the implemented source example.

MCP config JSON
{
  "mcpServers": {
    "ax0s-memory": {
      "command": "python",
      "args": ["-m", "ax0s_memory", "mcp-serve"],
      "env": {
        "AX0S_EMBEDDER_IDLE_S": "60"
      }
    }
  }
}
Implemented and test-covered

The stdio module entry point is implemented and test-covered. This statement is not a current startup-health or compatibility receipt.

Four documented tools inside a larger registered surface.

The current source snapshot registers 34 MCP tools; four are documented as the public core subset.

ToolPurposeReturn boundary
brain_rememberWrite one record into a project slug.Minimal write confirmation fields; full records surface through recall.
brain_recallHybrid, vector, or full-text recall.The recall JSON contract.
brain_searchFull-text shorthand.The same recall JSON shape.
brain_sessionStart, end, or inspect session collections.Action-specific collection fields.

A static registration count is not a startup, invocation, health, compatibility, or customer-availability receipt. Review the package contract before relying on a tool outside this core subset.

Open the checked 2026-07-14 source-count artifact.

Follow the documented sequence.

Read the quickstart and recorded round-trip boundary, compare the CLI surface, or inspect record provenance fields.