MCP Tools Overview
All available MCP tools at a glance.
HUSK exposes the following tools via the MCP endpoint. Each tool has a cost annotation so your AI client can make informed decisions about when to call them.
Tools
| Tool | Description | Cost |
|---|---|---|
search | Semantic similarity search across memories | Embedding + DB read |
remember | Store a new memory with dedup checking | Embedding + vector search + DB write |
forget | Delete a memory by ID | DB write + vector delete |
list_memories | List all memories with optional filters | DB read only |
list_projects | List known projects (distinct git remotes) | DB read only |
session_context | Compact index of recent sessions | DB read only |
get_session_detail | Full session details with observations | DB read only |
get_observation | Single observation with full content | DB read only |
get_uncompressed_observations | Uncompressed observations for client-side compression | DB read only |
compress_observations | Mark observations compressed + store summary | Embedding + DB write |
link | Create a typed edge between two memories | DB write only |
unlink | Remove an edge by ID | DB write only |
related | Find direct neighbors of a memory | DB read only |
traverse | Walk the graph via BFS | Multiple DB reads |
Prompts
| Prompt | Description |
|---|---|
meditate | Guided memory cleanup — finds duplicates, contradictions, stale entries |
compress_session | Client-side observation compression — summarize and store |
All "DB read only" tools are cheap and fast. Tools that involve embedding calls go through Ollama, which adds latency depending on your hardware.