{
  "markdown": "<!-- mcp-name: io.github.onetrueclaude-creator/vault-health-mcp -->\n\n# vault-health-mcp\n\n**MCP server for Obsidian vault structural health checks.**\n\nFind broken wikilinks, orphaned notes, and missing frontmatter — then auto-repair them. Works with any Obsidian vault, no plugins required.\n\n## Install\n\n```bash\npip install vault-health-mcp\n```\n\n## Usage\n\n### Claude Code\n```bash\nclaude mcp add vault-health -- vault-health-mcp --vault ~/my-vault\n```\n\n### Claude Desktop\n```json\n{\n  \"mcpServers\": {\n    \"vault-health\": {\n      \"command\": \"uvx\",\n      \"args\": [\"vault-health-mcp\", \"--vault\", \"/path/to/vault\"]\n    }\n  }\n}\n```\n\n## MCP Tools\n\n| Tool | Tier | Description |\n|------|------|-------------|\n| `configure_vault` | Free | Point the server at a vault at runtime |\n| `check_vault_health` | Free | Full structural scan: broken links, orphans, missing frontmatter |\n| `find_orphans` | Free | List all structurally disconnected leaf notes |\n| `find_broken_links` | Free | List all wikilinks pointing to non-existent files |\n| `vault_statistics` | Free | File count, link count, orphan %, frontmatter coverage |\n| `repair_vault` | **Pro** | Auto-fix safe issues (add-only, never deletes) |\n\n## How auto-repair works (Pro)\n\n`repair_vault` only makes **additive** changes:\n- Broken `[[links]]` → replaced with plain text (the link text is preserved)\n- Missing frontmatter → adds a default YAML block with title and type\n\nIt never deletes files, removes content, or modifies existing frontmatter values.\n\n## Pro tier\n\nThe free tier detects every category of vault rot. The Pro tier unlocks `repair_vault` — one call to fix the safe categories automatically.\n\nLicense activation — any one of these works:\n\n```bash\n# 1. Environment variable\nexport VAULT_HEALTH_LICENSE=\"eyJhbGc...\"\n\n# 2. CLI flag\nvault-health-mcp --license-key \"eyJhbGc...\" --vault ~/my-vault\n\n# 3. Config file\necho \"eyJhbGc...\" > ~/.vault-health-mcp/license.jwt\n```\n\nLicenses are verified fully offline — no phone-home, no activation server. Get a license: **[coming soon — Dodo Payments storefront in verification]**.\n\n## Requirements\n\n- Python 3.10+\n- An Obsidian vault (any size)\n\n## License\n\nMIT\n",
  "bytes": 2163,
  "sha": "9e552aac46f86977e9f99e7f0aa3e61b5b373caf3a1435e046f52ffa57c72ae6",
  "repo_slug": "onetrueclaude-creator/vault-health-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_onetrueclaude_creator_vault_he_4e7444e2/readme"
}