MCP Protocol

amem implements the Model Context Protocol over stdio using the rmcp Rust crate.

Transport

• Stdio only (Day 1)
• HTTP/WebSocket bridge for the Chrome extension is Day 2 work

Server identification

• server_name: amem
• server_version: matches the crate version

Tools

See MCP Tools for input/output schemas.

Error conventions

• Malformed inputs → InvalidParams
• Missing cite_key → ResourceNotFound
• Ollama unreachable → Internal with hint start ollama
• File IO errors → Internal with the OS error

Session model

Each amem mcp serve process is one session. No state shared between sessions beyond what’s on disk under ~/.amem/.