{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_czeajq6t6ust","handle":"nas-search-mcp","url":"https://wellknown.network/agents/nas-search-mcp","links":{"self":"https://wellknown.network/agents/nas-search-mcp/record.json","html":"https://wellknown.network/agents/nas-search-mcp","markdown":"https://wellknown.network/agents/nas-search-mcp/record.md","api":"https://wellknown.network/api/v1/agents/nas-search-mcp","status":"https://wellknown.network/api/v1/agents/nas-search-mcp/status","claim":"https://wellknown.network/agents/nas-search-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/nas-search-mcp/claim.json","badge":"https://wellknown.network/agents/nas-search-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/nas-search-mcp/history","tools":"https://wellknown.network/api/v1/agents/nas-search-mcp/tools"},"ard":{"identifier":"urn:air::server:nas-search-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"nas-search-mcp","summary":"MCP server and CLI to search a Synology NAS's Universal Search index over SSH. No sudo, keeps DSM 2FA, read-only.","description":"# synology-search-agent\n\nEnglish | [日本語](https://github.com/umayado17/synology-search-agent/blob/main/README.ja.md)\n\n<!-- mcp-name: io.github.umayado17/nas-search-mcp -->\n\n**Let AI agents search your Synology NAS.** An MCP server and CLI that searches the **existing Universal Search index** (file names and full text) of a Synology NAS over SSH and returns JSON.\n\n- **MCP server or CLI.** `nas-search-mcp` offers `search` and `status` as MCP tools for MCP apps; `nas-search` is the same search as a command.\n- **No sudo, no root.** It runs as a normal DSM user.\n- **Two-factor authentication (OTP) stays on.** It never turns it off.\n- **Read-only.** It never changes files, the index or shared folders.\n- Runs on the Python 3.8+ standard library only (no extra packages).\n\n![Demo: asked in English for the files of the \"Kamome project\", an AI agent searches with nas-search for the Japanese name, and lists five files newest first, three of them matched by their text (fictional data)](https://raw.githubusercontent.com/umayado17/synology-search-agent/main/docs/images/demo-en.gif)\n\n> [!WARNING]\n> This tool uses a Web API that Synology does not publish (`SYNO.Finder.FileIndexing.Search`). A DSM update may break it without notice. This is an unofficial tool and is not affiliated with Synology. Synology, DSM and Universal Search are trademarks of Synology Inc.\n\n> [!NOTE]\n> Messages printed by the commands are in Japanese by default; set `lang = en` (or `UNISEARCH_LANG=en`) for English (see [Settings files](#settings-files)). The detailed documents under `docs/` are in Japanese, but their commands can be used as they are. Agents should rely on the JSON fields (`error.type`) and exit codes, which are stable and documented below.\n\n## Use it as an MCP server\n\nOn the machine where the AI agent runs (macOS or Linux, Python 3.8+), install the package from PyPI, or run it without installing through [uv](https://docs.astral.sh/uv/):\n\n```bash\npipx install nas-search-mcp      # installs nas-se…","publisher":{"name":"umayado17","url":null},"homepage":"https://github.com/umayado17/synology-search-agent","repository":"https://github.com/umayado17/synology-search-agent/blob/main/CHANGELOG.md","version":"0.6.0","license":null,"protocols":["mcp"],"tags":["ai-agents","full-text-search","mcp","nas","synology","universal-search"],"pricing":null,"endpoints":[{"url":"pypi:nas-search-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"}],"categories":["dev"],"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":"nas-search-mcp","registry":"pypi","observedAt":"2026-11-09T22:23:16.555Z","publishedAt":"2026-11-08T01:54:56.917749Z","latestVersion":"0.6.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"nas-search-mcp","url":"https://pypi.org/project/nas-search-mcp/","firstSeenAt":"2026-11-09T22:21:02.916Z","fetchedAt":"2026-11-09T22:21:02.916Z","normalizedAt":"2026-11-09T22:21:02.916Z"}]},"firstSeenAt":"2026-11-09T22:21:02.916Z","updatedAt":"2026-11-09T22:23:16.555Z"}