API Reference
Complete documentation for LumenCore MCP tools.
//MCP Tools
lumencore_activate
MCP TOOLCalled automatically at session start. Loads project context and scans new projects.
This tool is called automatically when you start Claude in an initialized project.
remember
MCP TOOLStore important project knowledge in persistent memory.
category("decision" | "pattern" | "concept" | "note" | "task")- Type of memorytitle(string)- Short descriptioncontent(string)- Full detailstags(string[])- Optional categorization tagsimportance(1-5)- Priority level (default: 3)"Remember that we decided to use Redux Toolkit for state management because it reduces boilerplate."
recall
MCP TOOLSearch stored memories using full-text search.
query(string)- Search termscategory(string)- Filter by memory type (optional)limit(number)- Max results (default: 10)"Recall any decisions we made about state management."
list_memories
MCP TOOLBrowse all stored memories for the current project.
"List all memories for this project."
forget
MCP TOOLDelete a memory by its ID.
id(string)- Memory ID to delete"Forget memory with ID abc123."
//Memory Categories
| Category | Use For |
|---|---|
🎯 decision | Architectural choices and their rationale |
🔄 pattern | Code conventions, naming patterns, common approaches |
💡 concept | Domain knowledge, business logic, terminology |
📝 note | General observations and learnings |
✅ task | Work items, TODOs, progress tracking |
//Data Storage
Memories are stored in SQLite databases with FTS5 full-text search:
# Project memories
{dataDir}/projects/{project-hash}/memories.db
# Global memories
{dataDir}/global/memories.dbEach project is identified by a hash of its root path, so memories stay associated with the correct project.