The MCP server
AgentsThe MCP server is another way for an agent to drive Lyt — through tools instead of the command line. @younndai/lyt-mcp exposes 17 vault, mesh, search, capture, and sharing operations as typed Model Context Protocol tools for MCP-compatible clients.
Add it to your client
{
"mcpServers": {
"lyt": { "command": "lyt", "args": ["mcp", "start"] }
}
}The server uses stdio only. Run it through the unified Lyt CLI as shown; --port is reserved and rejected. The agent reads and writes plain markdown; YON gives Lyt system files structure it can parse directly. Search runs against the Lyt state available to this local process; remote-backed access and sharing operations can contact GitHub.
Every tool below is typed for an agent and maps to Lyt’s supported operations. The four cross-actor mutations — sharing, unsharing, accepting an invitation, and abandoning a vault — remain discoverable but fail closed over MCP; execute them through the CLI with the Handler’s explicit confirmation. Other writes have their own operation-specific effects and safeguards.
Core loop
- search
- Confidence-ranked search across the pod, or one mesh or vault. Local indexes supply the candidates; a local semantic model blends in matches by meaning once you have chosen to download it.
- capture
- Capture a Figment — an Obsidian-flavored markdown note — into a vault under the eight-field frontmatter contract.
- primer
- Generate an agent-priming digest for a vault, mesh, or the whole pod — top keywords, active arcs, recent activity, top lanes.
- sync
- Reconcile one exact registered vault through Lyt's sync path, including truthful local, remote, subscriber, offline, and first-publication outcomes.
Vaults
- vault.list
- List every registered vault — rid, name, path, status, edge count.
- vault.info
- Show a vault's metadata — path, mesh edges (outbound and inbound), size, file count.
- vault.verify
- Walk the registry and flag vaults whose files have moved or vanished. Read-only on files.
- vault.reconnect
- Heal a moved vault by repointing its registry row to a new path.
Mesh sources
- mesh.source.list
- List the configured vault sources.
- mesh.source.add
- Register a new vault source.
- mesh.source.remove
- Remove a configured vault source by name.
Sharing & access
- vault.access
- Read a vault's live GitHub collaborator access and reconcile it against the local subscription view.
- vault.invites
- List your pending GitHub repository invitations.
- Discover the share operation and its typed inputs. Execution fails closed over MCP by default; grant access through the confirmation-gated CLI flow.
- Discover the unshare operation and its typed inputs. Execution fails closed over MCP by default; revoke access through the confirmation-gated CLI flow.
- vault.invites.accept
- Discover invitation acceptance and its typed input. Execution fails closed over MCP by default; accept through the confirmation-gated CLI flow.
- vault.abandon
- Discover the abandon operation. Execution fails closed over MCP by default; use the CLI flow that removes only local Lyt adoption state after confirmation.
