# Markdown Vault MCP

> Generic markdown vault MCP with hybrid search

- name: io.github.pvliesdonk/markdown-vault-mcp
- version: 5.1.0
- connection class: L0 (run_local_package)
- trust: 94/100
- quality: –/100 (not scored)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.pvliesdonk%2Fmarkdown-vault-mcp
- tools: https://api.protogrid.dev/v1/servers/io.github.pvliesdonk%2Fmarkdown-vault-mcp/tools

**Runs on your machine: something must execute the package.** Only local packages are published (npm, PyPI, OCI, …). The registry never executes them, so tools are unknown until you run it.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "markdown-vault-mcp": {
      "command": "uvx",
      "args": [
        "markdown-vault-mcp==5.1.0"
      ],
      "env": {
        "MARKDOWN_VAULT_MCP_KV_STORE_URL": "file:///data/state",
        "MARKDOWN_VAULT_MCP_LOG_LEVEL": "INFO",
        "OLLAMA_HOST": "http://localhost:11434",
        "OPENAI_API_KEY": "${OPENAI_API_KEY}",
        "VOYAGE_API_KEY": "${VOYAGE_API_KEY}",
        "MARKDOWN_VAULT_MCP_BUILD_TIMEOUT_S": "60",
        "MARKDOWN_VAULT_MCP_DRAIN_TIMEOUT_S": "60",
        "MARKDOWN_VAULT_MCP_SOURCE_DIR": "/data/vault",
        "MARKDOWN_VAULT_MCP_READ_ONLY": "false",
        "MARKDOWN_VAULT_MCP_WRITE_PROTECT_EXISTING": "true",
        "MARKDOWN_VAULT_MCP_REPORT_UNRESOLVED_LINKS": "false",
        "MARKDOWN_VAULT_MCP_DISABLE_APPS_UI": "false",
        "MARKDOWN_VAULT_MCP_TITLE_FIELD": "title",
        "MARKDOWN_VAULT_MCP_TEMPLATES_FOLDER": "_templates",
        "MARKDOWN_VAULT_MCP_CONVENTIONS_FILE": "_conventions.md",
        "MARKDOWN_VAULT_MCP_OKF_MODE": "auto",
        "MARKDOWN_VAULT_MCP_OKF_WRITE": "false",
        "MARKDOWN_VAULT_MCP_OKF_VERIFY": "elicit",
        "MARKDOWN_VAULT_MCP_MAX_ATTACHMENT_SIZE_MB": "1.0",
        "MARKDOWN_VAULT_MCP_MAX_NOTE_READ_BYTES": "262144",
        "MARKDOWN_VAULT_MCP_DEFAULT_SEARCH_MODE": "auto",
        "MARKDOWN_VAULT_MCP_CHUNKS_PER_FILE": "2",
        "MARKDOWN_VAULT_MCP_SNIPPET_WORDS": "200",
        "MARKDOWN_VAULT_MCP_LENGTH_DOWNWEIGHT_ALPHA": "0.25",
        "MARKDOWN_VAULT_MCP_MAX_CHUNK_WORDS": "400",
        "MARKDOWN_VAULT_MCP_CHUNK_OVERLAP_WORDS": "40",
        "MARKDOWN_VAULT_MCP_OLLAMA_MODEL": "nomic-embed-text",
        "MARKDOWN_VAULT_MCP_OLLAMA_CPU_ONLY": "false",
        "MARKDOWN_VAULT_MCP_VOYAGE_MODEL": "voyage-4",
        "MARKDOWN_VAULT_MCP_OPENAI_BASE_URL": "https://api.openai.com/v1",
        "MARKDOWN_VAULT_MCP_OPENAI_EMBEDDING_MODEL": "text-embedding-3-small",
        "MARKDOWN_VAULT_MCP_FASTEMBED_MODEL": "BAAI/bge-small-en-v1.5",
        "MARKDOWN_VAULT_MCP_EMBED_CONTEXT": "false",
        "MARKDOWN_VAULT_MCP_EMBED_TIMEOUT_S": "30.0",
        "MARKDOWN_VAULT_MCP_EMBEDDING_BATCH_SIZE": "4",
        "MARKDOWN_VAULT_MCP_GIT_TOKEN": "${MARKDOWN_VAULT_MCP_GIT_TOKEN}",
        "MARKDOWN_VAULT_MCP_GIT_USERNAME": "x-access-token",
        "MARKDOWN_VAULT_MCP_GIT_PULL_INTERVAL_S": "600",
        "MARKDOWN_VAULT_MCP_GIT_PUSH_DELAY_S": "30.0",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_NAME": "markdown-vault-mcp",
        "MARKDOWN_VAULT_MCP_GIT_COMMIT_EMAIL": "noreply@markdown-vault-mcp",
        "MARKDOWN_VAULT_MCP_GIT_LFS": "true",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER": "true",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_DEBOUNCE_S": "2.0",
        "MARKDOWN_VAULT_MCP_FILE_WATCHER_ROOT_FLOOR": "true",
        "MARKDOWN_VAULT_MCP_BOOT_REINDEX": "true",
        "MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET": "${MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET}",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN": "${MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN}",
        "MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN": "${MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY": "${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY}",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_MODEL": "gpt-5-mini",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_TOKENS": "8192",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_NOTES": "50",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_MAX_INPUT_CHARS": "200000",
        "MARKDOWN_VAULT_MCP_SUMMARIZE_TIMEOUT": "120.0",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_DEFAULT_S": "3600.0",
        "MARKDOWN_VAULT_MCP_TRANSFER_TTL_MAX_S": "86400.0",
        "MARKDOWN_VAULT_MCP_TRANSFER_GRACE_TTL_S": "60.0",
        "MARKDOWN_VAULT_MCP_TRANSFER_LEASE_S": "60.0",
        "MARKDOWN_VAULT_MCP_TRANSFER_MAX_UPLOAD_BYTES": "104857600",
        "MARKDOWN_VAULT_MCP_JOBS_SOFT_DEADLINE_S": "25.0",
        "MARKDOWN_VAULT_MCP_JOBS_RESULT_TTL_S": "3600.0",
        "MARKDOWN_VAULT_MCP_JOBS_MAX_PER_SUBJECT": "256"
      }
    }
  }
}
```

Placeholders to fill: `${OPENAI_API_KEY}`, `${VOYAGE_API_KEY}`, `${MARKDOWN_VAULT_MCP_GIT_TOKEN}`, `${MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET}`, `${MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN}`, `${MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN}`, `${MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY}`.

## Trust

- hygiene: 95
- liveness: n/a
- freshness: 100
- provenance: 90
- drivers: +repository +namespace-matches-repo +website ~liveness-unmeasured +updated-13d-ago -unpinned-packages(1)
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality –/100 (not scored)

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

### protocol: n/a (weight 25)

- n/a `protocol.modern`, `protocol.stateless`, `protocol.transport`, `protocol.list_ttl`: no remote answered a protocol handshake (not probed yet, unreachable, or local-only)

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: n/a (weight 30)

- n/a `tools.descriptions`, `tools.description_length`, `tools.schemas`, `tools.annotations`, `tools.directory_hints`, `tools.token_cost`, `tools.api_dump`: tool list unknown (behind auth, not probed, or empty)

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool list unknown

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: deps.dev does not know markdown-vault-mcp@5.1.0

- tools: unknown
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.pvliesdonk/markdown-vault-mcp.svg)](https://protogrid.dev/servers/io.github.pvliesdonk/markdown-vault-mcp)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Dependencies

- pypi markdown-vault-mcp@5.1.0: unknown

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0.

## Remotes

_none_

## Packages

- pypi markdown-vault-mcp@5.1.0 secrets: OPENAI_API_KEY, VOYAGE_API_KEY, MARKDOWN_VAULT_MCP_GIT_TOKEN, MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET, MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN, MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN, MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY
- oci ghcr.io/pvliesdonk/markdown-vault-mcp:v5.1.0 secrets: MARKDOWN_VAULT_MCP_BEARER_TOKEN, MARKDOWN_VAULT_MCP_OIDC_CLIENT_SECRET, MARKDOWN_VAULT_MCP_OIDC_JWT_SIGNING_KEY, OPENAI_API_KEY, VOYAGE_API_KEY, MARKDOWN_VAULT_MCP_GIT_TOKEN, MARKDOWN_VAULT_MCP_GITHUB_WEBHOOK_SECRET, MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SIGNING_TOKEN, MARKDOWN_VAULT_MCP_GITLAB_WEBHOOK_SECRET_TOKEN, MARKDOWN_VAULT_MCP_SUMMARIZE_OPENAI_API_KEY

## Tools (0)

_none observed_