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

All 29 MCP Tools

Complete reference for every ekkOS memory tool.

ekkOS provides 29 MCP tools organized into 6 categories. Your AI calls these automatically based on what you ask — no manual invocation needed.

Search & Recall(4 tools)

ekkOS_Search

Find past solutions, conversations, and patterns across all memory layers

Example

"Search my memory for how we handled authentication"

ekkOS_Recall

Remember what you discussed at a specific time

Example

"What did we discuss yesterday?"

ekkOS_Context

Get relevant context for your current task

Example

"Get context for implementing user auth"

ekkOS_Codebase

Find relevant code in your project

Example

"Find code related to authentication"

Learning & Patterns(6 tools)

ekkOS_Forge

Save solutions as reusable patterns

Example

"Remember that we always use Supabase for auth"

ekkOS_Capture

Record an event or context to memory

Example

Called automatically by integrations

ekkOS_Track

Record that specific patterns were applied

Example

Called when patterns are used during a task

ekkOS_Outcome

Report whether a pattern application succeeded or failed

Example

"That pattern worked" or "That approach failed"

ekkOS_Detect

Automatically detect which patterns were used in a response

Example

Called automatically by hooks after task completion

ekkOS_Directive

Set rules your AI follows (MUST/NEVER/PREFER/AVOID)

Example

"Always use TypeScript strict mode"

Validation(2 tools)

ekkOS_Conflict

Check if an action conflicts with your rules or patterns

Example

"Check if deleting these files violates any rules"

ekkOS_Reflect

Analyze a response for improvement opportunities

Example

Called for continuous improvement suggestions

Plans & Tasks(8 tools)

ekkOS_Plan

Create a structured plan with steps

Example

"Create a plan for implementing OAuth"

ekkOS_Plans

List your active and completed plans

Example

"Show my current plans"

ekkOS_PlanStatus

Update plan status (draft, in_progress, completed)

Example

"Mark this plan as completed"

ekkOS_PlanStep

Mark a step as complete or incomplete

Example

"Mark step 2 as done"

ekkOS_Generate

Generate a plan using AI based on context

Example

"Generate a plan for refactoring auth"

ekkOS_SaveTemplate

Save a plan as a reusable template

Example

"Save this plan as a template"

ekkOS_Templates

List available plan templates

Example

"Show available templates"

ekkOS_FromTemplate

Create a new plan from a template

Example

"Use the API template for this endpoint"

Secrets(5 tools)

ekkOS_StoreSecret

Securely store API keys and credentials (encrypted)

Example

"Store my OpenAI API key"

ekkOS_GetSecret

Retrieve a stored credential

Example

"Get my GitHub token"

ekkOS_ListSecrets

List stored secrets (metadata only, no values)

Example

"What API keys do I have saved?"

ekkOS_DeleteSecret

Permanently delete a stored secret

Example

"Delete my old Stripe key"

ekkOS_RotateSecret

Update a secret with a new value

Example

"Update my AWS access key"

Analytics & Portability(4 tools)

ekkOS_Stats

Get statistics about your memory usage

Example

"How many patterns do I have?"

ekkOS_Summary

Get a summary of recent ekkOS activity

Example

"What has ekkOS done this session?"

ekkOS_Export

Export all patterns, directives, and plans as JSON

Example

"Export all my patterns"

ekkOS_Import

Import memory data from a backup

Example

"Import my backup"

How to Use

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

"Search my memory for..."
"Remember this pattern..."
"What did we discuss about..."
"Always use X" or "Never do Y"
"Store my API key for..."
"Create a plan for..."

Your AI will automatically use the right tools based on what you ask.

Get Started