MCP Tools Reference

All 68 MCP Tools

Complete reference for every ekkOS memory tool available via MCP.

Total Tools

Required

Core Memory(8 tools)

Search, save, and track solutions across all memory layers

Tool	Description	Parameters
`ekkOS_Search`Required	Search all memory layers for patterns, solutions, and past context	`querysources?limit?`
`ekkOS_ExpandPattern`	Get full details of a pattern from compact search results	`id`
`ekkOS_Capture`	Record an event or interaction to memory	`userIdsessionIdsourcetypecontent`
`ekkOS_Forge`Required	Save a learned solution as a reusable pattern	`titleproblemsolutiontags?`
`ekkOS_Track`	Record that specific patterns were applied in your work	`retrieval_token?memory_ids?`
`ekkOS_Outcome`	Report whether a pattern application succeeded or failed	`successretrieval_id?`
`ekkOS_Stats`	Get statistics about your memory usage across all layers	`scope?`
`ekkOS_RecordSkip`	Report when retrieved patterns were not relevant to improve future retrieval	`pattern_idsquery_textskip_reason?`

Access past sessions, project context, and file relationships

Tool	Description	Parameters
`ekkOS_Context`	Get relevant context for your current task	`taskmaxPatterns?maxEpisodes?`
`ekkOS_Codebase`	Search your project's indexed codebase	`querylimit?file_types?`
`ekkOS_Recall`	Remember past conversations by time range	`days_ago?session_id?semantic_query?`
`ekkOS_PreserveContext`	Preserve working memory for continuity across sessions	`session_iduser_id`
`ekkOS_RestoreContext`	Restore previously preserved context	`session_id?restoration_token?`
`ekkOS_ProjectMemory`	Get project-specific memory and history	`project_pathsemantic_query?`
`ekkOS_FileDependencies`	Trace file import/export relationships in your project	`file_pathdepth?direction?`
`ekkOS_IndexDependencies`	Index the dependency graph for a project	`project_path?incremental?`

Set persistent MUST / NEVER / PREFER / AVOID rules for your AI

Tool	Description	Parameters
`ekkOS_Directive`Required	Create persistent rules (MUST/NEVER/PREFER/AVOID)	`typerulescope?priority?`
`ekkOS_UpdateDirective`	Modify an existing directive	`idtype?rule?priority?`
`ekkOS_DeleteDirective`	Remove a directive permanently	`idreason?`
`ekkOS_UniversalDirectives`	Get system-wide rules that apply to all users	No parameters

Create, manage, and template structured task plans

Tool	Description	Parameters
`ekkOS_Plan`	Create a structured plan with trackable steps	`titlestepscontext?`
`ekkOS_Plans`	List your active and completed plans	`status?limit?`
`ekkOS_PlanStatus`	Update a plan's status (draft, in_progress, completed)	`plan_idstatus`
`ekkOS_PlanStep`	Mark a plan step as complete or incomplete	`plan_idstep_indexcompleted`
`ekkOS_Generate`	AI-generate a plan from context and existing patterns	`contextpatterns?`
`ekkOS_SaveTemplate`	Save a plan as a reusable template	`plan_idcategory?`
`ekkOS_Templates`	Browse available plan templates	`category?limit?`
`ekkOS_FromTemplate`	Create a new plan from a saved template	`template_idcontext?`

Securely store and manage API keys and credentials (AES-256-GCM encrypted)

Tool	Description	Parameters
`ekkOS_StoreSecret`	Securely store API keys, tokens, and credentials	`servicevaluetype?description?`
`ekkOS_GetSecret`	Retrieve a stored credential	`servicetype?masked?`
`ekkOS_ListSecrets`	List all stored secrets (metadata only, no values)	No parameters
`ekkOS_DeleteSecret`	Permanently delete a stored secret	`secretId`
`ekkOS_RotateSecret`	Update a secret with a new value	`servicenewValue`

Index and query database schemas for accurate field names

Tool	Description	Parameters
`ekkOS_IndexSchema`	Index database or TypeScript schemas for accuracy	`project_pathfiles?`
`ekkOS_GetSchema`	Look up correct field names for a table or type	`table_nameproject_path?`

Track objectives, measure progress, and choose strategies

Tool	Description	Parameters
`ekkOS_Goal`	Set and track persistent objectives with progress metrics	`actiondescription?goal_id?progress?`
`ekkOS_Strategy`	Get context-aware strategy recommendations for tasks	`task_typecomplexity?safety_level?`
`ekkOS_Delta`	Measure your improvement score over time	`period_hours?context?`
`ekkOS_MetaState`	System self-assessment and capability overview	`include_goals?include_constraints?`

Record errors, track gotchas, and prevent repeat mistakes

Tool	Description	Parameters
`ekkOS_TrackError`	Record errors to build prevention patterns	`error_typedescriptionfile_path?correction?`
`ekkOS_FileGotcha`	Get or create known gotchas for specific files	`actionfile_path?gotcha?`
`ekkOS_ErrorAnalytics`	Analyze error patterns across your projects	`period_days?group_by?`
`ekkOS_Consolidate`	Run active forgetting: quarantine failing patterns, merge duplicates, prune stale data, promote winners	`mode`
`ekkOS_DecayPatterns`	Review pattern confidence changes over time	`period_days?min_confidence?dry_run?`
`ekkOS_ReinforcePat`	Boost confidence of a proven pattern	`pattern_idboost_factor?`

Zero-data-loss handshake protocol for context window management

Tool	Description	Parameters
`ekkOS_EvictPrepare`	Prepare eviction — identify evictable blocks and get confirmation token	`session_idtarget_reduction?`
`ekkOS_EvictConfirm`	Confirm and execute eviction with the preparation token	`eviction_tokenconfirmed_block_ids`
`ekkOS_EvictStatus`	Check current eviction status and recoverable blocks for a session	`session_id`

Export, import, health checks, and conflict validation

Tool	Description	Parameters
`ekkOS_Summary`Required	Get a human-readable summary of recent ekkOS activity	`time_window_seconds?session_id?`
`ekkOS_Conflict`Required	Check if a proposed action conflicts with your rules	`proposed_actionscope?`
`ekkOS_Reflect`	Analyze a response for quality and improvement opportunities	`responseuser_query?`
`ekkOS_Detect`Required	Auto-detect which patterns were used in a response	`responseretrieval_id`
`ekkOS_Export`	Export your patterns, directives, and plans as JSON	`format?include_patterns?`
`ekkOS_Import`	Import memory data from a backup file	`datamerge_strategy?`
`ekkOS_Why`	Explain why a pattern or decision was made	`pattern_id?retrieval_id?`
`ekkOS_Health`	Check system health and connectivity status	`include_stats?`
`ekkOS_IndexFile`	Index a specific file for codebase search	`file_pathproject_path`
`ekkOS_IndexProject`	Index an entire project for codebase search	`project_pathproject_id?`

Link patterns together and create workflow sequences

Tool	Description	Parameters
`ekkOS_Link`	Create relationships between patterns (supersedes, extends, conflicts)	`from_pattern_idto_pattern_idrelationship_type`
`ekkOS_Playbook`	Create ordered sequences of patterns as reusable workflows	`actionname?pattern_ids?`

ekkOS learns automatically from your corrections and successes

Tool	Description	Parameters
`ekkOS_Learn`	Trigger auto-learning from recent corrections and successes	`session_id?time_window_hours?`
`ekkOS_ReviewLearning`	Review and approve/reject auto-learned pattern candidates	`actioncandidate_id?reason?`

Initialize projects, bulk import data, sync and snapshot

Tool	Description	Parameters
`ekkOS_ProjectInit`	Initialize ekkOS for a new project	`project_pathproject_name?`
`ekkOS_Ingest`	Bulk import data into memory layers	`source_typedata`
`ekkOS_Snapshot`	Create a point-in-time snapshot of memory state	`name?description?`
`ekkOS_Sync`	Synchronize local and cloud memory	`direction?force?`