MCP server for recovering context from previous Claude Code sessions and managing session summaries and transcripts
Three tools with basic descriptions but critical gaps in schema completeness and parameter documentation. clerk-resume has a single required parameter (cwd) with description; clerk-index-list has no parameters; clerk-index-read has one required parameter (terms) with description. All tools return text output with no documented schema. Descriptions are present (194-250 chars) but lack actionable guidance on when to use each tool relative to others. No error recovery hints, no output structure documentation, no parameter constraints (enums, ranges). Tool names use hyphens (non-standard verb_noun pattern) and lack clarity on composition, unclear how these three tools relate or should be sequenced.
List all available index terms (tags, dates, projects, keywords). Returns term names that can be used with clerk-index-read.
Read the content of one or more index terms. Returns links to matching summaries.
Recover context from previous Claude Code sessions in this project. Use this tool when: - The user forgot to use "claude -c" or "--resume" and wants to continue previous work - The user asks to "resume", "recover context", "what were we doing", or similar - You need background on what was previously done in this project Returns file paths to: 1. Summary files — daily digests of past sessions (read these first for a quick overview) 2. Transcript files — full conversation history from previous sessions (read for detailed context) After receiving the paths, read the summary files first. If more detail is needed, read the relevant transcript files to fully rebuild context.
No output schema documented. All three tools return mcp.NewToolResultText() with unstructured text. LLMs cannot parse results or chain to downstream tools without guessing structure.
Tool names use hyphens (clerk-resume, clerk-index-list) instead of verb_noun convention (e.g. get_session_context, list_index_terms). Hyphenated names are non-standard and harder for LLMs to parse as action verbs.
clerk-index-read parameter 'terms' accepts comma-separated strings with no validation, format constraint, or example. Description says 'e.g. go,mcp,20260418' but does not specify valid term syntax, length limits, or error handling for invalid terms.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 42 | 2026-07-28+ | v2 |
No error recovery guidance. Handlers return mcp.NewToolResultError() with raw error messages (e.g. 'failed to load config'). LLMs receive no hint on whether to retry, ask user, or abandon the operation.
Tool composition unclear. No description explains when to call clerk-resume vs clerk-index-list vs clerk-index-read, or how they relate. Descriptions lack dependency hints (e.g. 'Call clerk-index-list first to see available terms').