{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_w7jgcm57234v","handle":"filesystemwatcher-mcp","url":"https://wellknown.network/agents/filesystemwatcher-mcp","links":{"self":"https://wellknown.network/agents/filesystemwatcher-mcp/record.json","html":"https://wellknown.network/agents/filesystemwatcher-mcp","markdown":"https://wellknown.network/agents/filesystemwatcher-mcp/record.md","api":"https://wellknown.network/api/v1/agents/filesystemwatcher-mcp","status":"https://wellknown.network/api/v1/agents/filesystemwatcher-mcp/status","claim":"https://wellknown.network/agents/filesystemwatcher-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/filesystemwatcher-mcp/claim.json","badge":"https://wellknown.network/agents/filesystemwatcher-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/filesystemwatcher-mcp/history","tools":"https://wellknown.network/api/v1/agents/filesystemwatcher-mcp/tools"},"ard":{"identifier":"urn:air::server:filesystemwatcher-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"filesystemwatcher-mcp","summary":"An event-driven file system watcher for AI agents via the Model Context Protocol (MCP).","description":"# Filesystem Watcher MCP\n\n[![PyPI](https://img.shields.io/pypi/v/filesystemwatcher-mcp.svg)](https://pypi.org/project/filesystemwatcher-mcp)\n[![PyPI Downloads](https://img.shields.io/pypi/dm/filesystemwatcher-mcp.svg?label=PyPI%20downloads)](https://pypistats.org/packages/filesystemwatcher-mcp)\n[![License: Apache 2.0](https://img.shields.io/badge/license-Apache%202.0-green.svg)](LICENSE)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n\n`filesystemwatcher-mcp` lets your AI coding agent (Gemini, Claude, Cursor, Copilot, etc.)\nwatch directories for live file-system changes. It acts as a\n[Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server, giving your\nagent event-driven access to file creations, modifications, deletions, and moves —\nwithout busy-polling.\n\n## Key features\n\n- **Event-driven file watching**: Uses [Watchdog](https://github.com/gorakhargosh/watchdog) for cross-platform native OS events (`inotify`, `FSEvents`, `ReadDirectoryChangesW`).\n- **Safe by design**: Blocks watching system-critical paths on Windows, macOS, and Linux. Strict path guardrails are enforced server-side.\n- **Flexible filtering**: Filter events by file extension, glob pattern, or event type (`created`, `modified`, `deleted`, `moved`).\n- **Debounced events**: Rapid successive events on the same file are coalesced over a 500 ms window — no duplicate noise.\n- **Consume-once semantics**: `poll_events` drains the queue, making it easy to integrate into agent loops.\n- **Explicit error surfacing**: All failure modes (permission denied, OS backend crash, watch limit) return structured `{\"success\": false, \"error\": \"...\"}` responses rather than crashing silently.\n\n## Requirements\n\n- [Python](https://www.python.org/) 3.10 or newer.\n- [uv](https://docs.astral.sh/uv/) (recommended) or `pip`.\n\n## Getting started\n\nAdd the following config to your MCP client:\n\n```json\n{\n  \"mcpServers\": {\n    \"filesystemwatcher\": {\n      \"command\": …","publisher":{"name":"Kamal Raj Sekar","url":null},"homepage":"https://github.com/trycatchkamal/filesystemwatcher-mcp","repository":"https://github.com/trycatchkamal/filesystemwatcher-mcp/issues","version":"0.1.5","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:filesystemwatcher-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.filesystem","name":"Filesystem","confidence":0.882,"provenance":"derived"},{"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":"filesystemwatcher-mcp","registry":"pypi","observedAt":"2026-11-09T05:24:33.695Z","publishedAt":"2026-03-07T15:39:36.212130Z","latestVersion":"0.1.5"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"filesystemwatcher-mcp","url":"https://pypi.org/project/filesystemwatcher-mcp/","firstSeenAt":"2026-09-09T15:22:52.926Z","fetchedAt":"2026-11-09T05:22:58.492Z","normalizedAt":"2026-11-09T05:22:58.492Z"}]},"firstSeenAt":"2026-09-09T15:22:52.926Z","updatedAt":"2026-11-09T05:24:33.695Z"}