sill-ensoul
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ENSOUL_KB | No | Path to the knowledge base root. Defaults to the platform-specific location (e.g. ~/.local/share/ensoul/knowledge on Linux). | |
| ENSOUL_MCP_HOST | No | Host interface to bind the HTTP server. | 0.0.0.0 |
| ENSOUL_MCP_PORT | No | Port to bind the HTTP server. | 8930 |
| ENSOUL_MCP_TOKEN | Yes | Bearer token required to authenticate requests. The server refuses to start without this token. |
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 | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_agentsA | List every agent that owns an OKF knowledge bundle. |
| create_agentA | Create a new agent bundle (directory + AGENT.md persona + index.md +
log.md). Use when starting a new role that doesn't exist yet.
|
| delete_agentA | Delete an agent's entire bundle (all concepts + persona + log). IRREVERSIBLE — confirm with the user before calling. Refuses paths that escape the agents dir. Use when an agent is retired or created by mistake. |
| agent_indexA | Open an agent's wiki: persona preview, index.md text, and all concepts. Call this when waking an agent in a new project, before working. Switch agents by calling this with a different agent_id. |
| wiki_searchA | Full-text search within one agent's wiki. |
| wiki_readB | Read one concept (frontmatter + body). concept_id uses '/' (e.g. 'projects/x'). |
| wiki_write_conceptC | Create or update a concept file in an agent's wiki. 'type' is required (OKF). extra_json: optional JSON object string for custom frontmatter fields. |
| wiki_append_logB | Append one update entry to the agent's log.md (today's date group). |
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 8 tools
Each tool targets a distinct action (create/list/delete agent, read/search/write wiki, append log), and descriptions clarify the one potentially confusing pair (agent_index vs wiki_read). The name agent_index could be misread as an agent list, but its description removes that ambiguity.
Most wiki operations use a wiki_<verb> pattern, while agent lifecycle operations use <verb>_agent; this mixed ordering is readable but not uniform. agent_index is a noun-noun exception, and wiki_read vs wiki_write_concept is asymmetric. All names are snake_case and semantically clear.
Eight tools is a well-scoped set for managing agent bundles and their knowledge wikis. Each tool covers a distinct need without redundancy, and the count is within the ideal range.
Core workflows are covered: create/list/delete agents, open/search/read concepts, write concepts, and append log entries. There is no direct way to update an agent's persona/index or delete an individual concept, but these are minor gaps that can be worked around via concept writes or log entries.