BETAekkOS is currently in beta. Please report all bugs to support@ekkos.dev
ekkOS_docs
MCP Tools Reference

All 35 MCP Tools

Complete reference for every ekkOS memory tool available via MCP.

35
Total Tools
6
Required
8
Categories
11
Memory Layers

Core Memory(7 tools)

Essential tools for searching, learning, and capturing memory

ToolDescription
ekkOS_SearchRequired
Search all memory layers for patterns, solutions, and context
ekkOS_ForgeRequired
Create a new pattern from a learned solution
ekkOS_DirectiveRequired
Create user rules (MUST/NEVER/PREFER/AVOID)
ekkOS_Context
Get relevant context for a task
ekkOS_Capture
Capture a memory event
ekkOS_Codebase
Search project codebase embeddings
ekkOS_Recall
Recall past conversations by time

Pattern Tracking(4 tools)

Track pattern usage and measure effectiveness

ToolDescription
ekkOS_Track
Track when a pattern is applied
ekkOS_Outcome
Record success/failure of applied patterns
ekkOS_DetectRequired
Auto-detect which patterns were used
ekkOS_Reflect
Analyze a response for improvements

Utility(3 tools)

Statistics, summaries, and conflict checking

ToolDescription
ekkOS_Stats
Get statistics for all memory layers
ekkOS_SummaryRequired
Get human-readable activity summary
ekkOS_ConflictRequired
Check if action conflicts with directives

Plan Management(8 tools)

Create and manage structured plans for complex tasks

ToolDescription
ekkOS_Plan
Create a new structured plan
ekkOS_Plans
List agent plans for the current user
ekkOS_PlanStatus
Update plan status
ekkOS_PlanStep
Mark a plan step complete/incomplete
ekkOS_Generate
Generate a plan using AI
ekkOS_SaveTemplate
Save a plan as reusable template
ekkOS_Templates
List available plan templates
ekkOS_FromTemplate
Create plan from template

Secrets Management(5 tools)

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

ToolDescription
ekkOS_StoreSecret
Securely store sensitive data
ekkOS_GetSecret
Retrieve a stored secret
ekkOS_ListSecrets
List all stored secrets (metadata only)
ekkOS_DeleteSecret
Permanently delete a secret
ekkOS_RotateSecret
Update a secret with new value

Schema Awareness(2 tools)

Index and query database schemas for field name accuracy

ToolDescription
ekkOS_IndexSchema
Index database/type schemas
ekkOS_GetSchema
Get schema for a table/type

Portability(4 tools)

Export, import, and sync your memory data

ToolDescription
ekkOS_Export
Export memory data as JSON backup
ekkOS_Import
Import memory from backup
ekkOS_Snapshot
Create point-in-time snapshot
ekkOS_Sync
Synchronize with cloud

Project Setup(2 tools)

Initialize and configure ekkOS for your project

ToolDescription
ekkOS_ProjectInit
Initialize ekkOS for a project
ekkOS_Ingest
Bulk ingest data into memory

Required Tools

These tools should be called proactively as part of the ekkOS workflow:

ekkOS_Search

Search all memory layers for patterns, solutions, and context

ekkOS_Forge

Create a new pattern from a learned solution

ekkOS_Directive

Create user rules (MUST/NEVER/PREFER/AVOID)

ekkOS_Detect

Auto-detect which patterns were used

ekkOS_Summary

Get human-readable activity summary

ekkOS_Conflict

Check if action conflicts with directives

How to Use

You don't need to call these tools directly. Just ask your AI naturally:

"Search my memory for..."ekkOS_Search
"Remember this pattern..."ekkOS_Forge
"Always use X" / "Never do Y"ekkOS_Directive
"Store my API key for..."ekkOS_StoreSecret
"Create a plan for..."ekkOS_Plan
"What did we discuss yesterday?"ekkOS_Recall

Get Started