Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@ragmark search my vault for 'project roadmap' and show the top 5 results"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Local-first retrieval over markdown / [[wikilink]] vaults — hybrid (vector + lexical)
chunk search, note-level similarity, wikilink-aware context expansion, and a first-party
MCP surface. Embeddings run locally (fastembed); the
package makes no network egress at query time. Sibling of
graphmark, which it consumes for deterministic
graph reads.
Status: seeded, pre-release. The public interfaces, security gate, correctness harness, and release machinery are in place; the engine behavior lands slice by slice against them.
MCP tool | CLI | |
|
| hybrid chunk hits with |
|
| bare note text |
|
| wikilink BFS; structure always complete, budget limits content only |
|
| git-log-backed "what moved lately" |
— |
| index maintenance is CLI-only, deliberately |
Every surface routes through the same fail-closed machine-context gate; an unmarked vault reveals shared notes only.
Related MCP server: memory-mcp
claude mcp add --transport stdio vault -- ragmark mcp --vault ~/path/to/vaultThe registration name vault keeps existing mcp__vault__* tool names stable. The vault
root always comes from --vault or $RAGMARK_VAULT — never inferred.
No parity oracle — the package improves on its predecessor in the same motion as absorbing
it. Instead: a hand-curated, executor-untouchable golden-query set asserted as recall@k
with the embedding model pinned, plus permanent safety invariants — no silent embedding
truncation (the predecessor silently dropped 27.8% of corpus characters), chunk↔vector
conservation, and context-gating tests that CI re-runs with the filter defanged and
requires to FAIL (scripts/teeth_check.py). Quality is measured, leaks are impossible to
test around, and a green gate means something.
Decision provenance: the-vault#136 (blueprint map) and the-vault#145 (build epic).
This server cannot be deployed
Serve a folder of Markdown notes as an MCP server: hybrid search, reading, and sourced answers.
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Token-efficient MCP memory for Markdown vaults. Tiered search, GraphRAG, AI memories.
Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.
