@younndai/lyt-mcp
The MCP server — your markdown vaults and meshes as Model Context Protocol tools, local and typed.
Part of the Lyt (Link Your Think™) toolchain — federated markdown vaults you own, made legible to AI.
Website · Repository · Apache 2.0 · Trademark Policy · Contributing
[](https://www.npmjs.com/package/@younndai/lyt-mcp) [](./LICENSE) [](https://github.com/YounndAI/lyt#status) > ⚠️ **Public alpha — under active testing.** Lyt works and we use it daily, but surfaces change between releases and docs are still growing. The normal install follows `latest`; `@alpha` is the opt-in preview channel. Your vaults are plain markdown in plain git repos — your data is never locked in, and Lyt never phones home. ## What is this? `@younndai/lyt-mcp` is a [Model Context Protocol](https://modelcontextprotocol.io) server that exposes the [Lyt](https://github.com/YounndAI/lyt) vault and mesh operation set as **typed MCP tools**. Any MCP-compatible client — Claude Desktop, Claude Code, Codex, or your own agent runtime — can search, read, and operate your markdown vaults **locally**, over stdio, with no separate CLI subprocess per call and no cloud middleman. Your knowledge never leaves your machine; the agent comes to the data. This is Lyt's **AI-first** contract made protocol-native: the same governed operations available as `lyt vault ...` / `lyt mesh ...` on the command line are surfaced as MCP tools with [Zod](https://zod.dev)-validated schemas, so agents get accurate parameter validation and structured errors instead of scraping CLI text. One operation set, three transports — CLI for you, MCP for your agents, harness skills for agent runtimes without MCP. You usually do not install this package directly — install [`@younndai/lyt`](https://www.npmjs.com/package/@younndai/lyt) and run `lyt mcp start`. ## Install (standalone) ```bash npm install -g @younndai/lyt-mcp lyt-mcp mcp start # starts an MCP server over stdio ``` ## Wiring into an MCP client ```jsonc // claude_desktop_config.json (illustrative) { "mcpServers": { "lyt": { "command": "lyt-mcp", "args": ["mcp", "start"], }, }, } ``` Or, from inside Claude Code: `claude mcp add lyt --command lyt-mcp -- mcp start`. ## What it exposes A stable MCP tool set covering the vault + mesh + registry operations, including: - **`search`** — tiered-cascade search (arcs → lanes → FTS5 → edges) across your pod, a mesh, or a vault. Accepts an optional **agent query-expansion** array (up to 20 domain/synonym terms folded into the direct-text channel), independent `limit` and `meaningLimit` allowances, and a bounded `fields` frontmatter allow-list. The receipt reports `lexicalLimit`, `meaningLimit`, and `maxResults`; keeps the compatibility-ranked `results` array; and separates `groups.directTextMatches` from metadata-only `groups.meaningCandidates`. Every row carries additive `foundBy` provenance. Meaning candidates have a standing similarity-not-confirmed-match caveat and must be assessed by the consuming agent. - **`vault.list` / `vault.info` / `vault.verify` / `vault.reconnect`** — enumerate and inspect vaults, check writability, heal a moved vault. - **`vault.access` / `vault.invites`** (read) and **`vault.share` / `vault.unshare` / `vault.invites.accept` / `vault.abandon`** (handler-gated writes) — vault sharing over GitHub collaborator ACLs. - **`capture`** — write a Figment under the 8-field frontmatter contract. - **`sync`** — push a vault's GitHub metadata (dry-run by default). - **`primer`** — generate an agent-priming digest for a vault / mesh / federation. - **`mesh.source.*`** — manage where Lyt looks for vaults to clone. Tool schemas use [Zod](https://zod.dev), so MCP clients validate inputs before they ever touch your vaults. The operation surface grows as new verbs land in [`@younndai/lyt-vault`](https://www.npmjs.com/package/@younndai/lyt-vault) and [`@younndai/lyt-mesh`](https://www.npmjs.com/package/@younndai/lyt-mesh). **Semantic search and MCP.** The `search` tool inherits your pod's semantic-search setting, so an agent gets the same dense-embedding fusion you do at the CLI — *if the embedding model is already downloaded*. Because the MCP transport is non-interactive, the server **never** triggers the one-time local model download itself: with no cached model it degrades silently to lexical search. To enable semantic search for agents, run `lyt reindex` once on an interactive terminal and accept the download. Agent writes obey the same permission semantics as human writes: a vault that is read-only for you is read-only for your agent. Mutating share/invite/abandon tools are **handler-gated** and, because MCP has no interactive approval seam, fail closed over this transport — the equivalent `lyt vault ...` CLI verbs (with `--yes`) are the path for those operations today. ## Programmatic use ```ts import { buildMcpSubcommand } from "@younndai/lyt-mcp"; ``` This factory is what the [`@younndai/lyt`](https://www.npmjs.com/package/@younndai/lyt) meta package composes into the unified `lyt` binary's `mcp` subcommand. ## The Lyt toolchain | Package | Role | | --- | --- | | [`@younndai/lyt`](https://github.com/YounndAI/lyt/tree/main/packages/lyt) | The unified `lyt` CLI (meta package) | | [`@younndai/lyt-vault`](https://github.com/YounndAI/lyt/tree/main/packages/lyt-vault) | The vault primitive | | [`@younndai/lyt-mesh`](https://github.com/YounndAI/lyt/tree/main/packages/lyt-mesh) | The mesh layer — multi-vault operations | | [`@younndai/lyt-skills`](https://github.com/YounndAI/lyt/tree/main/packages/lyt-skills) | Agent-harness skills (Claude Code, Codex, agents) | | [`@younndai/lyt-mcp`](https://github.com/YounndAI/lyt/tree/main/packages/lyt-mcp) | **This package** — the MCP server | | [`@younndai/lyt-runner`](https://github.com/YounndAI/lyt/tree/main/packages/lyt-runner) | The YON automation runner | | [`@younndai/lyt-llm`](https://github.com/YounndAI/lyt/tree/main/packages/lyt-llm) | The LLM gateway | --- ## About YounndAI **YounndAI™ — You and AI, unified.** (pronounced *"yoon-dye"*) A philosophy of intelligence: building with intention, so humans and machines think together without losing what makes either whole. ## License & Attribution Apache-2.0. © 2026 MARLINK TRADING SRL (YounndAI). See [`LICENSE`](./LICENSE) and [`NOTICE`](./NOTICE). "LYT", "Lyt", and "YounndAI" are trademarks of MARLINK TRADING SRL — see [`TRADEMARK.md`](https://github.com/YounndAI/lyt/blob/main/TRADEMARK.md). Created by [Alexandru Mareș](https://allemaar.com). Website: [linkyourthink.com](https://linkyourthink.com)Structure before scale. Harmony above all.
--- | | | | ------------- | ------------------------------------------------------- | | **Project** | [Lyt — Link Your Think](https://linkyourthink.com) | | **Author** | [Alexandru Mareș](https://allemaar.com) | | **Company** | [MARLINK TRADING SRL](https://younndai.com) · YounndAI™ | | **License** | [Apache 2.0](./LICENSE) — © 2026 MARLINK TRADING SRL | | **Trademark** | [YounndAI™ Trademark Guidelines](https://github.com/YounndAI/lyt/blob/main/TRADEMARK.md) |