io.github.olijboyd/tomevault

Official7 tools

TomeVault

Search, fetch (with provenance), scan, and convert AI instruction files for agents.

Search, fetch, scan, and convert AI instruction files with provenance tracking.

Captured live from the server via tools/list.

search_tomes

Search TomeVault for agent context files (tomes, configs, skills) by a task description. Filter by format, kind, and quality grade. Returns ranked matches with owner/repo, grade, and available formats — not file contents.

Parameters (5)

querystringrequired
Free-text task or topic to match.
formatstring
Target tool format, e.g. claude_md, agents_md, cursor_mdc.
kindstring
tome = full project config + skills; config = one config file; skill = one skill.
gradestring
Screen by graded quality tier.
limitinteger

get_tome

Fetch one tome's content in a specific agent format (default claude_md). Every response carries the provenance verdict — quality grade, security scan grade, decay risk, and the content hash it is bound to.

Parameters (4)

ownerstringrequired
GitHub owner or org.
repostringrequired
GitHub repository name.
skill_pathstring
Fetch a specific skill within the repo (the skill_path from a search_tomes result). Omit for the repo's primary unit.
formatstring
Output format, e.g. claude_md, agents_md, skill_md.

get_provenance

Return the signed attestation record alone for a tome — quality grade, security scan grade and flags, decay risk, source registry, the content hash it is bound to, and the signing key id for offline verification.

Parameters (3)

ownerstringrequired
GitHub owner or org.
repostringrequired
GitHub repository name.
skill_pathstring
Address a specific skill within the repo, e.g. skills/foo.

scan_content

Scan submitted instruction-file text for safety, clarity, and loadability and return a verdict with findings. Use before loading a third-party file. The submitted text is scanned and discarded — never stored.

Parameters (2)

textstringrequired
Raw instruction-file text to scan.
namestring
Optional display name, e.g. CLAUDE.md.

convert_content

Convert pasted instruction-file text into another tool's format (claude_md, agents_md, cursor_mdc, gemini_md, copilot_instructions, windsurf_rules, skill_md). The same instructions, ready for any tool.

Parameters (4)

contentstringrequired
The raw instruction-file text to convert.
to_formatstringrequired
The target tool format.
namestring
Optional title for the converted file's heading/frontmatter.
descriptionstring
Optional one-line description for the converted file.

list_vault_items

List the items in your TomeVault that this token can read. Requires a vault access token with the items:read scope. Encrypted (private) items are never listed.

Parameters (1)

limitinteger

get_vault_item

Fetch one of your TomeVault items by id, with its content. Requires a vault access token with the items:read scope. Encrypted items are not retrievable and return not found, indistinguishable from a missing id.

Parameters (1)

idstringrequired
The vault item id, from list_vault_items.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "tomevault": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.tomevault.io/"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.