Skip to main content
Version: 0.1.0

MCP and Agent Integration

Memzoi ships a minimal stdio MCP server for safe agent access. Agents can search, build context, propose memory, and run prechecks, but they cannot approve or apply proposals through MCP.

Generate MCP config​

memzoi mcp config --project-root .

Example output:

{
"mcpServers": {
"memzoi": {
"command": "memzoi-mcp",
"args": ["--project-root", "/absolute/path/to/repo"],
"env": {}
}
}
}

memzoi mcp config resolves --project-root to an absolute path so the MCP client can start the server from any working directory.

Safe MCP tools​

The server exposes:

ToolPurpose
search_memorySearch active memory records by text with optional scope, type, path, and limit filters.
build_context_packBuild a prompt-ready context pack for a task.
propose_memoryCreate a pending memory proposal.
precheck_pathCheck a path against warnings, risks, and failed attempts.
precheck_actionCheck a planned action, optionally scoped to a path.
precheck_commandCheck a planned shell command, optionally scoped to a path.

The server does not expose lifecycle mutation tools such as approve, apply, supersede, tombstone, or export. Those stay CLI-side so durable memory writes remain reviewable.

Agent instruction prompt​

Print a one-shot prompt that teaches an agent how to use Memzoi:

memzoi integrate prompt

The prompt tells agents to:

  • Run memzoi context --task "<task>" before non-trivial work.
  • Add --path <relative/path> when editing specific files.
  • Run memzoi precheck before risky actions.
  • Propose durable repo knowledge with memzoi propose.
  • Avoid secrets, raw chat logs, temporary task progress, and private user facts.

Install instruction block​

Create or update a marked Memzoi block in an instruction file:

memzoi integrate instructions --file AGENTS.md

Use --json for scriptable output:

memzoi integrate instructions --file AGENTS.md --json

The command replaces content between:

<!-- memzoi:start -->
<!-- memzoi:end -->

If the markers are missing, it appends a new block. This makes future instruction updates deterministic and reviewable.