Documentation Index
Fetch the complete documentation index at: https://docs.orinadus.com/llms.txt
Use this file to discover all available pages before exploring further.
Protocol
urchin mcp speaks JSON-RPC 2.0 over stdin/stdout. Tool calls arrive as tools/call requests and return text content blocks. Errors return isError: true in the response content.
Tools
| Tool | Required args | Optional args | Purpose |
|---|---|---|---|
urchin_status | — | — | Journal health, event count, paths, identity |
urchin_ingest | content, workspace | source, kind, title, tags, session | Write an event to the journal |
urchin_recent_activity | — | hours, limit, source | Recent events, newest first |
urchin_search | query | hours, limit | Case-insensitive substring search |
urchin_project_context | project | hours, limit | Events matching a project name or tag |
urchin_workspace_context | path | hours, limit | Events scoped to a workspace path (prefix-matched) |
urchin_remember | content | tags, workspace | Quick-capture note without required workspace |
urchin_ephemeral | action | — | Toggle burn mode — suppress all writes |
urchin_agent_reflect | goal | hours, limit | ReAct reflection: load context, synthesise, write Agent event |
urchin_semantic_search | query | hours, limit | Token-cosine similarity search (or vector if URCHIN_EMBEDDER_URL set) |
Query output format
All query tools (urchin_recent_activity, urchin_search, urchin_project_context, urchin_workspace_context) return events as one line per result:
[timestamp] source — content (truncated to ~120 chars)
Error handling
Tool errors return:| Error | Cause |
|---|---|
"content must not be empty" | urchin_ingest called with blank content |
"workspace must not be empty" | urchin_ingest called with blank workspace |
"query must not be empty" | urchin_search called with blank query |
"unknown tool: <name>" | Tool name not recognised |
"(ephemeral mode: event suppressed)" | Not an error — ingest/remember called while ephemeral |
When ephemeral mode is active,
urchin_ingest and urchin_remember return a success response (not isError) with text "(ephemeral mode: event suppressed)". The call succeeds from the caller’s perspective; the event is simply not written.Defaults summary
| Arg | Tool | Default |
|---|---|---|
hours | urchin_recent_activity | 24 |
limit | urchin_recent_activity | 20 |
hours | urchin_search | 168 (1 week) |
limit | urchin_search | 20 |
hours | urchin_project_context | 168 (1 week) |
limit | urchin_project_context | 30 |
hours | urchin_workspace_context | 168 (1 week) |
limit | urchin_workspace_context | 40 |
hours | urchin_agent_reflect | 24 |
limit | urchin_agent_reflect | 30 |
hours | urchin_semantic_search | 168 (1 week) |
limit | urchin_semantic_search | 10 |
kind | urchin_ingest | conversation |
source | urchin_ingest | mcp |