{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_dtapcnmsyvqb","handle":"luke-kucing-alaya-mcp","url":"https://wellknown.network/agents/luke-kucing-alaya-mcp","links":{"self":"https://wellknown.network/agents/luke-kucing-alaya-mcp/record.json","html":"https://wellknown.network/agents/luke-kucing-alaya-mcp","markdown":"https://wellknown.network/agents/luke-kucing-alaya-mcp/record.md","api":"https://wellknown.network/api/v1/agents/luke-kucing-alaya-mcp","status":"https://wellknown.network/api/v1/agents/luke-kucing-alaya-mcp/status","claim":"https://wellknown.network/agents/luke-kucing-alaya-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/luke-kucing-alaya-mcp/claim.json","badge":"https://wellknown.network/agents/luke-kucing-alaya-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:luke-kucing-alaya-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"alaya-mcp","summary":"A second brain -- FastMCP server for personal knowledge vaults (zk and Obsidian)","description":"# alaya\n\n> **ālaya** (ālayavijñāna) — storehouse consciousness. The layer of mind that holds all impressions, memories, and seeds of knowledge.\n\nA FastMCP server that makes Claude Code the primary interface for a personal knowledge vault (zk or Obsidian). Full read/write/search/synthesis access — the AI is the interface, the vault is the source of truth.\n\n## Quickstart\n\n```bash\n# 1. Register with Claude Code (one command, no clone needed)\nclaude mcp add alaya -e ALAYA_VAULT_DIR=$HOME/notes -- uvx alaya\n\n# 2. Start Claude Code — alaya connects automatically\nclaude\n```\n\nThat's it. Ask Claude to \"search my notes for X\" or \"create a note about Y\" and it works.\n\n### Vault setup\n\n**zk vault** (requires [zk](https://github.com/zk-org/zk) CLI):\n\n```bash\nbrew install zk\nmkdir -p ~/notes && cd ~/notes && zk init\n```\n\n**Obsidian vault** — just point `ALAYA_VAULT_DIR` at any directory with a `.obsidian/` folder. No extra tools needed.\n\n### Running from source\n\n```bash\ngit clone git@github.com:luke-kucing/alaya.git\ncd alaya && uv sync\n\n# Register with Claude Code from source\nclaude mcp add alaya \\\n  -e ALAYA_VAULT_DIR=$HOME/notes \\\n  -- uv run --directory $(pwd) alaya\n```\n\n### Running the server standalone\n\n```bash\n# Via make\nmake serve\n\n# Or directly with env var\nALAYA_VAULT_DIR=~/notes uv run alaya\n```\n\nThe server communicates over stdio (MCP protocol) — it's designed to be launched by Claude Code, not run in a browser.\n\n### Running tests\n\n```bash\nmake test                # unit tests (607+ tests, no external deps)\nmake test-integration    # integration tests (requires zk binary)\nmake lint                # ruff check\n```\n\n## Philosophy\n\n- **The AI is the interface.** Stay in one place — a Claude Code session — and converse. Claude reads, writes, searches, and reasons across the vault.\n- **Frictionless capture, deliberate structure.** Inbox capture is a single sentence. Processing, linking, and filing are separate structured acts.\n- **Propose, then act.** Destructive or struct…","publisher":{"name":"Luke Kucing","url":null},"homepage":null,"repository":"https://github.com/luke-kucing/alaya/issues","version":"0.1.0","license":"Apache-2.0","protocols":["mcp"],"tags":["knowledge-base","mcp","obsidian","rag","zettelkasten"],"pricing":null,"endpoints":[{"url":"pypi:alaya-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"productivity.notes","name":"Notes & Docs","confidence":1,"provenance":"declared"},{"slug":"data.vector-search","name":"Vector Search","confidence":1,"provenance":"declared"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["data","dev","productivity"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"alaya-mcp","registry":"pypi","observedAt":"2026-09-09T08:22:47.719Z","publishedAt":"2026-03-05T23:23:44.220994Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"alaya-mcp","url":"https://pypi.org/project/alaya-mcp/","firstSeenAt":"2026-09-09T08:22:04.702Z","fetchedAt":"2026-09-09T08:22:04.702Z","normalizedAt":"2026-09-09T08:22:04.702Z"}]},"firstSeenAt":"2026-09-09T08:22:04.702Z","updatedAt":"2026-09-09T08:22:47.719Z"}