Automatic Claude Code -> Obsidian second brain: zero-config session capture, hybrid search, autonomous recall, daily/lessons/preferences.
SuperBrain exposes 2 tools with complete input schemas and descriptions. Both tools have clear, action-oriented names (superbrain_search, superbrain_children) and non-trivial descriptions (100+ chars). However, output schemas are not documented in the source code, LLMs cannot predict what fields to expect from responses. Parameter descriptions are present but minimal (10-30 chars), lacking guidance on format, constraints, or dependencies. No error handling guidance visible. No tool annotations (readOnlyHint, destructiveHint, idempotentHint). The tools appear well-intentioned but lack the depth needed for confident LLM integration.
List the daily-state entries (open threads, projects) of the child sessions a given parent session dispatched on a date (defaults to today).
Search the user's SuperBrain Obsidian vault (past decisions, projects, people, gotchas). Optional scope: project (slug), type (note type e.g. decision/capture/lesson), since (ISO date, only newer notes), role (agent_role).
Output schemas not documented. LLMs cannot predict response structure (fields, types, nesting). Forces agents to guess or fail on unexpected formats.
Parameter descriptions are minimal (10-30 chars). 'Filter by project slug (optional)' lacks format guidance. Should specify: slug format (lowercase, hyphens?), examples, or constraints.
No error handling guidance. If search returns 0 results, or if parentSessionId is invalid, what should the LLM do? No recovery hints provided.
No tool annotations. Both tools are read-only (marked in Risk field), but readOnlyHint is not set in the MCP schema. LLMs cannot infer safety/idempotency.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
superbrain_search 'k' parameter lacks bounds. Unbounded numeric parameters invite LLMs to pass absurd values (k=999999). Should specify min/max (e.g., 1-100).