whimsicality-mcp
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WHIMSICALITY_KERNEL_BIN | No | Path to the Rust kernel binary. | |
| WHIMSICALITY_STORAGE_DIR | No | Root directory for all stored data. | ~/.whimsicality/kernel-storage |
| WHIMSICALITY_HOT_BUDGET_MB | No | Hot tier RAM budget in MB (kernel only). | 256 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| whim_context_setA | Store text in a named context slot. Use for persistent memory that survives across agent sessions. |
| whim_context_getB | Retrieve text from a named context slot. |
| whim_context_listB | List all context slot keys. |
| whim_context_deleteB | Delete a context slot. |
| whim_rag_searchB | Search indexed documents by keyword overlap. Returns relevant chunks ranked by word-boundary match score. |
| whim_rag_indexB | Index a document for keyword search retrieval. |
| whim_facts_saveB | Save a named fact. Facts are key-value pairs that persist across sessions. |
| whim_facts_getC | Retrieve a named fact. |
| whim_facts_listC | List all saved fact names. |
| whim_plan_saveA | Save a plan document. The plan persists across sessions and can be retrieved later by another agent. |
| whim_plan_getC | Retrieve a saved plan. |
| whim_snippet_saveB | Save a reusable code snippet. |
| whim_snippet_searchB | Search saved snippets by keyword overlap. |
| whim_compactA | Truncate conversation history to fit a token budget. Keeps first and last messages intact, truncates the middle. This is truncation, not summarization. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 14 tools
Most tools have distinct purposes: facts, context slots, RAG search, plans, snippets, and compaction each serve different needs. However, facts and context both act as persistent key-value stores, which could cause some confusion, though the descriptions clarify context as memory and facts as factual data.
The naming follows a consistent pattern of 'whim_<resource>_<action>' for most tools (e.g., whim_facts_get, whim_context_set, whim_rag_search). Minor exceptions include whim_compact, which lacks a resource category, and slight verb placement variations, but overall the pattern is predictable.
14 tools is a reasonable count for a multi-purpose memory and utility server. Each tool covers a distinct functional area, though some areas like facts and context could potentially be merged, but the count is within the well-scoped range and does not feel excessive.
The server covers core operations for facts, context, and RAG, but has notable gaps: no delete for facts, plans, or snippets; no list for plans or snippets; and no way to retrieve a snippet by name (only search). These missing operations may force agents to work around or leave orphaned data.