About io.github.ignatenkofi/memshelf-mcp
io.github.ignatenkofi/memshelf-mcp is an MCP server published by ignatenkofi in the Blockchain category: working memory for AI agents: digest-indexed episodes on a git shelf, recalled a section at a time.
Recent commit activity is the strongest signal that reported issues will get attention.
Install
uvx memshelf-mcppip install memshelf-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (22)
adviseWhat your context is made of and what you could put down — proposals only
Parameters not published.
doctorDiagnose: episode schema, digest contract at rest, secret shapes, index bloat
Parameters not published.
forkCLI only — bootstrap a fresh session from INDEX + selected episodes or sections (#18)
Parameters not published.
graphCLI only — who mentions whom: cross-episode id references as JSON or Mermaid (#18)
Parameters not published.
importRetro-shelve a whole exported dialog without pulling it through context
Parameters not published.
indexReturn the shelf INDEX — the small recall entry point
Parameters not published.
initCreate (or top up) a memory shelf: docshelf layout, fixed categories
Parameters not published.
lint_digestValidate a digest against the contract without touching the shelf
Parameters not published.
mirrorCLI only — INDEX (± episodes) as one self-contained HTML page for phone-side reading (#18)
Parameters not published.
prune-splitsCLI only — remove H2 split directories git never got (migration for #109)
Parameters not published.
Show all 22 tools
purgeDrop episodes past `retain_until`, then reindex — dry run by default
Parameters not published.
rebuildRegenerate every derived file from the episodes
Parameters not published.
recallFetch an episode by id, or a single `## Section` of it
Parameters not published.
resolveSettle multi-writer conflicts: regenerate derived, union the recall log
Parameters not published.
retroCLI only — one quarter of the shelf as a Markdown retrospective (#18)
Parameters not published.
rollupArchive a period behind one digest-of-digests
Parameters not published.
searchGrep the shelf; returns matching episodes
Parameters not published.
search-benchCLI only — hit@1 / hit@k / MRR of grep vs hybrid on a `query<TAB>expected-id` file (#17)
Parameters not published.
semanticCLI only — `build` / `status` / `drop` the embedding sidecar that turns `search` hybrid; lives outside the shelf, needs `pip install 'memshelf-mcp[semantic]'` (#17)
Parameters not published.
shelveOffload one closed topic as a durable, indexed episode; `--amend` rewrites in place
Parameters not published.
statsThe shelf's token economy: standing cost vs shelved mass, claimed vs realized
Parameters not published.
tagsCLI only — episodes grouped by frontmatter tag (#18)
Parameters not published.
Ask AI
Ask AI about io.github.ignatenkofi/memshelf-mcp
Powered by Claude · Grounded in docs
Security checks
6 checks have not been run yet.