Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
/plugin marketplace add pvliesdonk/markdown-vault-mcpnpx agentmods add plugins/pvliesdonk/markdown-vault-mcp/plugingit clone --depth 1 https://github.com/pvliesdonk/markdown-vault-mcpGrade A, and why
markdown-vault-mcp scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 127 lines — stays where its author put it; the contents beside it link to each section on GitHub.
{
"name": "markdown-vault-mcp",
"description": "Generic markdown vault MCP with hybrid search",
"version": "4.0.0",
"author": {
"name": "Peter van Liesdonk"
},
"homepage": "https://pvliesdonk.github.io/markdown-vault-mcp/",
"repository": "https://github.com/pvliesdonk/markdown-vault-mcp",
"license": "MIT",
"keywords": [
"markdown",
"vault",
"obsidian",
"search",
"mcp"
],
"userConfig": {
"source_dir": {
"type": "directory",
"title": "Vault directory",
"description": "Path to the markdown vault directory. Required — the server refuses to start without it. Symbolic links inside the vault are followed on Python 3.13+.",
"required": true
},
"read_only": {
"type": "boolean",
"title": "Read-only mode",
"description": "Set to true to hide the write tools (write, edit, append, delete, rename, move_folder, fetch, git_sync, the okf_* tools, create_upload_link) and serve a search-only vault. git_sync also needs managed git mode; create_upload_link needs an HTTP transport.",
"required": false,
"default": false
},
"exclude_patterns": {
"type": "string",
"title": "Exclude patterns",
"description": "Comma-separated glob patterns excluded from scanning, e.g. .obsidian/**,.trash/**.",
"required": false,
"default": ".obsidian/**,.trash/**,.git/**"
},
"embedding_provider": {
"type": "string",
"title": "Embedding provider",
"description": "Semantic-search backend: fastembed, ollama, openai, or voyage. Leave empty to disable embeddings.",
"required": false
},
"ollama_host": {
"type": "string",
"title": "Ollama host",
"description": "Ollama server URL for the ollama embedding provider. Bare (not MARKDOWN_VAULT_MCP_-prefixed), matching the Ollama ecosystem convention.",
"required": false,
"default": "http://localhost:11434"
},
"ollama_model": {
"type": "stringWhat this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2d ago First seen · 127 lines scan A d6aa41b75df8
markdown-vault-mcp is a plugin published in the GitHub repository pvliesdonk/markdown-vault-mcp (31 stars, last pushed 2d ago), licensed MIT. Its token cost is not measured: this kind of file is read by the harness, not the model. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other plugins, from other repositories
arscontexta
Conversational derivation engine — generate agent-native memory architecture from natural conversation. 15 kernel primitives, 26 commands, 17 feature blocks, 3 presets.
vellum
Connect Claude to your self-hosted vellum markdown vault: read, write, search, tags, tasks and backlinks.
telawiki marketplace
tela — the markdown-native team wiki your agents can read and write.
tela
Connect Claude Code to your tela wiki: semantic research with citations over your team's docs, plus authoring into rich pages, spreadsheets with real formulas, and presentable decks.
project-brain
Every Claude Code session, in every project, captured into one plain-Markdown brain you own. Index-first recall, automatic redaction, LLM-distilled session notes.
exomem
Governed long-term memory over a markdown vault: raw sources stay immutable, conclusions are compiled with provenance, and nothing is deleted - it is superseded. Requires EXOMEMVAULTPATH to point at your vault; run exomem setup if you do not have one yet.