Skip to main content

MCP Tools

Agent Brain exposes a compact set of MCP tools for storing, retrieving, governing, and sharing memory.

| Tool | Purpose | | ----------------------- | ----------------------------------------------------------------------- | | brain_remember | Store a memory with type, importance, tags, and project context | | brain_recall | Retrieve relevant memories for a query | | brain_search | Search memories with pagination and filters | | brain_forget | Archive a memory so it no longer appears in default recall | | brain_status | Report service status, memory count, cache status, and connected agents | | brain_share | Share a memory with other agents or contexts | | brain_cache_check | Check whether a similar cached response already exists | | brain_project_context | Fetch project-specific context and active agent information |

Memory types

Common memory types include:

  • decision
  • error
  • pattern
  • entity
  • preference
  • context
  • fact

Use the most specific type that matches the information. Decisions and error resolutions usually deserve higher importance than generic facts.

Good memories

Good memories are specific, durable, and actionable:

Use PostgreSQL for canonical memory rows. Qdrant only stores vector indexes and must be hydrated from PostgreSQL before returning results.

Weak memories are vague or temporary:

We talked about the database today.