MCP Tools Reference

All 36 Public MCP Tools

Complete reference for publicly available ekkOS tools. Internal system tools are intentionally excluded.

36
Total Tools
4
Required
6
Categories
Public
Tool Scope

Core Memory(11 tools)

Search memory, retrieve context, and record reusable solutions

ToolDescription
ekkOS_SearchRequired
Search all memory layers for patterns, solutions, and past context
ekkOS_GraphQuery
Query the knowledge graph with natural language questions
ekkOS_Context
Get relevant context for a current task
ekkOS_Recall
Recall prior conversations by time window or semantic query
ekkOS_Codebase
Search codebase embeddings for relevant code patterns and files
ekkOS_FileDeps
Get dependency graph for a specific file
ekkOS_ForgeRequired
Save a learned solution as a reusable pattern
ekkOS_AutoForge
Auto-forge a structured pattern from freeform context
ekkOS_Track
Record that specific patterns were applied in your work
ekkOS_Outcome
Report whether a pattern application succeeded or failed
ekkOS_Stats
Get statistics about your memory usage across all layers

Plans & Improvement(9 tools)

Plan work, track goals, and measure progress over time

ToolDescription
ekkOS_Plan
Create a structured plan with trackable steps
ekkOS_Plans
List your active and completed plans
ekkOS_PlanStatus
Update a plan's status (draft, in_progress, completed)
ekkOS_PlanStep
Mark a plan step as complete or incomplete
ekkOS_Generate
AI-generate a plan from context and existing patterns
ekkOS_Goal
Manage persistent goals that survive across sessions
ekkOS_Strategy
Select an optimal strategy for a given context
ekkOS_Delta
Compute improvement score over a time period
ekkOS_Advisor
Get actionable recommendations from PROMETHEUS analysis

Secrets Vault(5 tools)

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

ToolDescription
ekkOS_StoreSecret
Securely store API keys, tokens, and credentials
ekkOS_GetSecret
Retrieve a stored credential
ekkOS_ListSecrets
List all stored secrets (metadata only, no values)
ekkOS_DeleteSecret
Permanently delete a stored secret
ekkOS_RotateSecret
Update a secret with a new value

Directives & Safety(3 tools)

Resolve applicable directives and pre-check risky actions

ToolDescription
ekkOS_ApplicableDirectives
Resolve scoped directives for project and agent context
ekkOS_UniversalDirectives
Retrieve global critical directives
ekkOS_ConflictRequired
Check if an action conflicts with directives or patterns

Analytics & System(5 tools)

Health, summaries, introspection, and memory portability

ToolDescription
ekkOS_SummaryRequired
Get a human-readable summary of recent ekkOS activity
ekkOS_Health
Check ekkOS system health and connectivity
ekkOS_MetaState
Get complete system state and introspection summary
ekkOS_Export
Export your patterns, directives, and plans as JSON
ekkOS_Import
Import memory data from a backup file

AI Assets & Media(3 tools)

Generate images and save searchable YouTube transcripts

ToolDescription
ekkOS_Imagine
Generate images from prompt or reference image
ekkOS_YouTube
Fetch and save full transcripts from YouTube videos
ekkOS_YouTubeList
List or search saved YouTube transcripts

Common Workflow Tools

Tools your AI most often uses for day-to-day memory workflows:

ekkOS_Search

Search all memory layers for patterns, solutions, and past context

ekkOS_Forge

Save a learned solution as a reusable pattern

ekkOS_Conflict

Check if an action conflicts with directives or patterns

ekkOS_Summary

Get a human-readable summary of recent ekkOS activity

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
"What rules apply in this project?"ekkOS_ApplicableDirectives
"Store my API key for..."ekkOS_StoreSecret
"Create a plan for..."ekkOS_Plan
"What did we discuss yesterday?"ekkOS_Recall

Get Started