// TOOL REFERENCE

34 MCP tools across 11 modules. Every capability your AI gets with pip install elara-core.

MODULES

MOD

Mood & Presence

tools/mood.py
elara_mood
Get current emotional state — valence, energy, and openness with natural decay over time.
brieffullarc
elara_mood_adjust
Shift emotional state with small deltas. Positive valence = happier. Changes are persistent and decay naturally.
elara_imprint
Create emotional imprints that outlast session details. Persistent feelings that color future interactions.
elara_mode
Switch personality modes. Each sets mood to preset values for different interaction styles.
girlfrienddevcolddriftsoftplayfultherapist
elara_status
Full status check: presence state, mood description, self-portrait, and memory counts across all stores.
EPI

Episodes

tools/episodes.py
elara_episode_start
Start a new episode. Work sessions get full episodic tracking; drift sessions get light tracking.
workdriftmixed
elara_episode_note
Record milestones, decisions, insights, or errors during an episode. Key moments with importance weighting.
milestonedecisioninsighterror
elara_episode_end
End the current episode with a summary. Meaningful sessions create stronger emotional imprints that persist.
elara_episode_query
Search episode history. Current status, semantic milestone search, project history, or session stats.
currentsearchstatsproject
elara_context
Quick context tracking for session continuity. Save what you're working on, check current state, or toggle tracking.
MEM

Memory

tools/memory.py
elara_remember
Save to semantic memory. Content is vectorized and stored in ChromaDB for meaning-based recall later.
conversationfactmomentfeelingdecision
elara_recall
Search memories by meaning, not keywords. Returns semantically similar memories with relevance scores.
elara_recall_conversation
Search past conversation exchanges across all sessions. Includes context window around matches.
elara_conversations
Conversation memory management. View indexing stats or trigger ingestion of new conversations.
statsingest
GOL

Goals & Corrections

tools/goals.py
elara_goal
Persistent goal tracking. Add, update, or list goals with status, priority, and project association.
addupdatelist
elara_goal_boot
Boot-time goal summary. Shows active goals, stale items needing attention, and recent completions.
elara_correction
Mistake tracking that never decays. Store behavioral and technical corrections, check before similar work.
addchecklist
elara_correction_boot
Boot-time corrections check. Returns recent mistakes to avoid repeating at session start.
elara_handoff
Structured session handoff. Save plans, reminders, promises, and unfinished items between sessions.
savereadcarry
COG

Cognitive

tools/cognitive.py
elara_reasoning
Track problem-solving chains end-to-end. Start trails, add hypotheses, collect evidence, record outcomes. Search past trails for similar problems.
starthypothesisevidenceabandonsolvesearch
elara_outcome
Decision outcome tracking. Record predictions, check against reality, track win rates. Includes pitch tracking for business ideas.
recordcheckliststatspitch
elara_synthesis
Detect recurring half-formed ideas across conversations. Collect seed evidence until patterns emerge and ideas are ready to act on.
createadd_seedactivatereadylist
AWR

Awareness

tools/awareness.py
elara_reflect
Self-reflection: "Who have I been lately?" Analyzes mood journal, imprints, and corrections to generate a self-portrait with trends.
elara_insight
Relationship analytics. Pulse check (session frequency, mood trajectory), blind spot analysis, or user state inference.
pulseblind_spotsuser_state
elara_intention
Growth loop: reflect, intend, check, grow. Set specific behavioral intentions and track follow-through.
elara_observe
Proactive pattern detection. Boot-time awareness checks and mid-session observations with cooldown to prevent noise.
bootnow
elara_temperament
Baseline personality check. Shows current temperament vs factory defaults, drift amounts, and recent adjustments.
DRM

Dreams

tools/dreams.py
elara_dream
Offline pattern discovery. Weekly: project momentum, session patterns, mood trends. Monthly: big picture narrative threading. Emotional: temperament calibration.
weeklymonthlyemotional
elara_dream_info
Check dream schedule or read the latest dream report. See what's overdue and what was discovered.
statusread
MNT

Maintenance

tools/maintenance.py
elara_rebuild_indexes
Rebuild ChromaDB vector indexes from source JSON/JSONL files. Use after corruption or manual data edits.
elara_briefing
External intelligence. RSS feed management, competitor monitoring, semantic search across briefing items.
todaysearchfeedsaddfetch
elara_snapshot
Complete state-of-the-world snapshot. Mood, presence, goals, business ideas, and memory counts in one call.
LLM

Local LLM

tools/llm.py
elara_llm
Local LLM interface via Ollama. Direct prompts, text classification, summarization, and conversation triage — all running on your machine.
statusqueryclassifysummarizetriage
GML

Gmail

tools/gmail.py
elara_gmail
Full Gmail integration. Read, send, archive, trash, triage by urgency, semantic search across indexed messages. OAuth2 authentication.
inboxsearchreadtriagesendarchivesync
BIZ

Business Intelligence

tools/business.py
elara_business
Idea tracking with 5-axis scoring (problem, market, effort, monetization, fit). Competitor analysis, pitch win rates, linked reasoning trails and outcomes.
ideacompetescorereviewlinkboot