MCP Tools

The Memory MCP server exposes a single memory tool with six actions. The tool is designed for AI agents — it accepts an action and params object.

Setup

Add to your .mcp.json:

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["@buildd/memory"],
      "env": {
        "MEMORY_API_URL": "https://memory.buildd.dev",
        "MEMORY_API_KEY": "mem_your_key_here"
      }
    }
  }
}

Actions

context

Load all team memories formatted as markdown. Call this at the start of every session.

Params:

Example:

{ "action": "context", "params": { "project": "my-app" } }

Returns: Formatted markdown with all relevant memories, or "(No memories yet)".

search

Search memories with filters. Returns compact index results (no full content).

Params:

Example:

{ "action": "search", "params": { "query": "database", "type": "gotcha" } }

Returns: List of matching memories with titles, types, and IDs. Use get to fetch full content.

save

Save a new memory.

Params:

Example:

{
  "action": "save",
  "params": {
    "type": "gotcha",
    "title": "Don't use db.transaction() with Neon HTTP",
    "content": "The neon-http driver doesn't support interactive transactions. Use atomic UPDATE...WHERE with .returning() instead.",
    "project": "buildd",
    "tags": ["database", "neon"]
  }
}

Returns: Confirmation with the saved memory's title and ID.

get

Fetch full content for a single memory.

Params:

Example:

{ "action": "get", "params": { "id": "mem_abc123" } }

Returns: Full memory content including title, type, content, tags, files, and metadata.

update

Update an existing memory.

Params:

Example:

{
  "action": "update",
  "params": {
    "id": "mem_abc123",
    "content": "Updated content with more detail."
  }
}

Returns: Confirmation with the updated memory's title.

delete

Delete a memory.

Params:

Example:

{ "action": "delete", "params": { "id": "mem_abc123" } }

Returns: Confirmation of deletion.