MCP Tools

Overview

toon-memory provides 11 MCP tools and 3 MCP resources for managing persistent memory:

Tools

Tool	Description
memory_remember	Save a decision, pattern, bug, or knowledge (with optional TTL and auto-tag inference)
memory_recall	Search memory (use BEFORE reading files, filters expired TTL entries)
memory_forget	Remove an entry by key or id
memory_stats	View memory state (including TTL stats)
memory_summary	Save/retrieve file summaries
memory_archive	Archive old entries (>30 days) and expired TTL entries
memory_diff	Show changes since a date (24h, 7d, or exact date)
memory_suggest	Find related entries for a given context
memory_encrypt	Enable AES-256-GCM encryption
memory_decrypt	Disable encryption

MCP Resources

Memory is also exposed as MCP resources for direct context reading:

Resource	URI	Description
Memory Entries	toon://memory/entries	Full memory dump
Memory Stats	toon://memory/stats	Category counts and TTL info
Memory Summaries	toon://memory/summaries	File summaries

Resources let agents read memory as context without tool invocations — useful for system prompts or session startup.

Examples

Remember a decision

memory_remember({
  category: "decision",
  key: "use-zod",
  content: "Use Zod for validation",
  file: "src/types.ts",
  tags: "validation;types"
})
// 🧠 Guardado: decision/use-zod (a1b2c3d4)
// 🔗 Entradas relacionadas:
//   [pattern] zod-schemas — Shared Zod schemas for API validation

Remember with TTL

memory_remember({
  category: "knowledge",
  key: "sprint-deadline",
  content: "Sprint ends July 18, feature freeze is July 16",
  ttl: "7d"
})
// 🧠 Guardado: knowledge/sprint-deadline (x1y2z3w4)
// ⏰ TTL: 2026-07-19

Use ttl for temporary context like deadlines or sprint info. Supports relative (7d, 30d) or exact dates (2026-12-31). Expired entries are auto-filtered from search.

Auto-inferred tags

memory_remember({
  category: "bug",
  key: "redis-connection-timeout",
  content: "Redis connection timeout in production, increased pool size"
  // tags left empty — auto-inferred from content
})
// 🧠 Guardado: bug/redis-connection-timeout (a1b2c3d4)
// 🏷️ Tags inferidos: redis

When tags is empty, the system infers them from content using a vocabulary of 20+ categories: redis, auth, api, db, security, test, deploy, config, performance, refactor, error, logging, types, async, state, ui, storage, email, payment, webhook.

Search memory

memory_recall({ query: "redis" })
// [bug] redis-pool-fix (i9j0k1l2)
//   Added max_connections=20
//   File: redis.ts | Tags: redis;fix | Date: 2026-07-10

Search with date filter

memory_recall({
  query: "redis",
  from_date: "2026-07-01",
  to_date: "2026-07-31"
})

Show changes since last session

memory_diff({ since: "24h" })
// 📋 Cambios desde 2026-07-11:
//
// ➕ Nuevas (2):
//   [decision] use-zod (a1b2c3d4)
//     Use Zod for validation
//   [bug] redis-timeout (e5f6g7h8)
//     Redis connection timeout fix

Supports since as relative (24h, 7d) or exact date. Filter by type: all, created, or updated.

Find related entries

memory_suggest({ context: "redis cache configuration" })
// 🔍 Sugerencias para "redis cache configuration":
//
// [decision] redis-cache-config (a1b2c3d4)
//   Redis cache layer for session storage
//   File: src/cache.ts | Tags: redis;cache | Date: 2026-07-10

Archive old entries

memory_archive()
// 📦 Archivadas 5 entradas antiguas
// 📋 Quedan 42 entradas activas

Enable encryption

memory_encrypt()
// 🔐 Encriptación habilitada
// ⚠️ Guarda esta clave (no se puede recuperar):
// a1b2c3d4...

Categories

Entries are organized by category:

Category	Use Case
decision	Design decisions (“Why X over Y?”)
pattern	Project patterns (“Uses Zod for validation”)
bug	Bug fixes (“Redis pool exhaustion”)
knowledge	General knowledge (“Broker uses RESP”)