MCP server for verbatim notes and teaching-on-request, without code generation.
npm install @tac0de/threadkeeper-mcpThreadkeeper is a local MCP server that preserves user reasoning by storing only verbatim, user-approved notes and teaching on request. It is intentionally slow and restrictive: it asks questions, reflects user language, and avoids unrequested summarization, suggestions, or judgment.
- Stores user-approved text exactly as given (append-only).
- Returns stored notes without rewriting or summarizing.
- Echoes user-provided questions verbatim for reflective prompts.
- Explains code or outlines architecture when explicitly asked.
- Suggests changes only when explicitly requested.
- Generate code or fill in logic.
- Summarize, rephrase, or clean up user text unless explicitly requested.
- Judge decisions, rank options, or compare against external standards.
Add a server entry to your MCP client config (for example, .mcp.json):
``json`
{
"mcpServers": {
"threadkeeper": {
"command": "npx",
"args": ["-y", "@tac0de/threadkeeper-mcp"]
}
}
}
- notes.store: Store a verbatim note. Requires approved: true. Optional file, timestamp, and kind.notes.list
- : List all notes in insertion order.notes.list_kind
- : List notes with an exact kind match.notes.get
- : Retrieve a note by id.notes.find
- : Exact substring match over note text (case-sensitive).teach.request
- : Store a user-approved teaching request verbatim.teach.note
- : Store a user-approved teaching note verbatim.questions.ask
- : Return the provided question verbatim.teach.ask
- : Return the provided teaching question verbatim.
- teach.scope: Ask for scope and desired depth before teaching.
Notes are stored locally as append-only JSON Lines in:
``
~/.threadkeeper/notes.jsonl
Entries may include an optional kind field (for example, teach.request).
Override the path with THREADKEEPER_STORE_PATH.
The server exposes the agent contract in AGENTS.md and uses it as MCP server instructions, including teaching on request.
- Node.js >= 18
- Uses @modelcontextprotocol/sdk` for the MCP server runtime.