MCP Resource Reference

MCP resources are read-only data that agents can access without calling a tool. Remem exposes 3.

memory://stats

System statistics snapshot — the same data returned by GET /api/v1/stats.

Use case: Let an agent report on memory system health, or check before a heavy traversal.

Sample response:

{
  "total_memories": 1247,
  "short_term_memories": 43,
  "long_term_memories": 1204,
  "total_connections": 8431,
  "avg_importance": 0.62
}

---

memory://collections/recent

Recently created/accessed memories, ordered by recency.

Use case: Give an agent immediate context about what was recently remembered in this session.

Sample response:

[
  {
    "id": "mem_01j...",
    "content": "User asked about deployment options for their ML model.",
    "memory_type": "short_term",
    "metadata": {
      "created_at": "2026-07-01T14:32:00Z",
      "accessed_at": "2026-07-01T14:32:00Z",
      "importance": 0.5,
      "tags": ["task"]
    }
  }
]

---

memory://collections/important

High-importance memories.

Use case: Give an agent a quick summary of the highest-signal things it knows, without running a search.

Sample response:

[
  {
    "id": "mem_01j...",
    "content": "User's team uses Rust for all backend services.",
    "memory_type": "long_term",
    "metadata": {
      "created_at": "2026-06-15T09:00:00Z",
      "accessed_at": "2026-07-01T14:32:00Z",
      "importance": 0.95,
      "tags": ["preferences", "architecture"]
    }
  }
]

Each item is a Memory object, the same shape returned by the REST API.