mcp-markdown-vault
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PORT | No | HTTP port (SSE mode only) | 3000 |
| OLLAMA_URL | No | Set to enable Ollama embeddings | |
| VAULT_PATH | No | Markdown vault directory | /vault |
| OLLAMA_MODEL | No | Ollama embedding model name | nomic-embed-text |
| OLLAMA_DIMENSIONS | No | Ollama embedding vector dimensions | 768 |
| MCP_TRANSPORT_TYPE | No | Transport mode: 'stdio' (single client) or 'sse' (multi-client HTTP) | stdio |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| vaultC | Manage vault notes: list, read, create, update, delete, stat, create_from_template. Operates on .md files in the markdown vault. |
| editA | Edit notes. Single mode: provide path, operation, content. Batch mode: provide operations array (max 50, sequential, stops on first error). AST ops (append/prepend/replace) target headings or block IDs with fuzzy matching. Freeform ops (line_replace/string_replace) for line range or literal string. frontmatter_set merges YAML. dryRun=true previews as unified diff without writing. |
| viewC | Read and search markdown notes. Vault scope: general markdown notes vault. Actions: search (heading-aware fragment retrieval with TF-IDF + proximity), semantic_search (vector + lexical hybrid for conceptual queries), global_search (cross-vault exact-match grep), outline (file or directory structure tree), read (full file or single section by heading), frontmatter_get (parse YAML frontmatter), bulk_read (read multiple files/headings in one call), backlinks (find all notes linking to a given path). |
| workflowB | Manage agent workflow state: check status, fire transitions, view history, or reset. Based on a Petri net state machine. |
| systemA | System administration: check status, get indexing info, vault structure overview, and manage the server. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| vault-overview | Complete vault context: live stats, overview, and conventions (frontmatter schema, tags, naming). |
| vault-stats | Live vault statistics as JSON. |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/wirux/mcp-markdown-vault'
If you have feedback or need assistance with the MCP directory API, please join our Discord server