An event-driven file system watcher for AI agents via the Model Context Protocol (MCP).
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"filesystemwatcher-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Filesystem Watcher MCP [](https://pypi.org/project/filesystemwatcher-mcp) [](https://pypistats.org/packages/filesystemwatcher-mcp) [](LICENSE) [](https://www.python.org/downloads/) `filesystemwatcher-mcp` lets your AI coding agent (Gemini, Claude, Cursor, Copilot, etc.) watch directories for live file-system changes. It acts as a [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server, giving your agent event-driven access to file creations, modifications, deletions, and moves — without busy-polling. ## Key features - **Event-driven file watching**: Uses [Watchdog](https://github.com/gorakhargosh/watchdog) for cross-platform native OS events (`inotify`, `FSEvents`, `ReadDirectoryChangesW`). - **Safe by design**: Blocks watching system-critical paths on Windows, macOS, and Linux. Strict path guardrails are enforced server-side. - **Flexible filtering**: Filter events by file extension, glob pattern, or event type (`created`, `modified`, `deleted`, `moved`). - **Debounced events**: Rapid successive events on the same file are coalesced over a 500 ms window — no duplicate noise. - **Consume-once semantics**: `poll_events` drains the queue, making it easy to integrate into agent loops. - **Explicit error surfacing**: All failure modes (permission denied, OS backend crash, watch limit) return structured `{"success": false, "error": "..."}` responses rather than crashing silently. ## Requirements - [Python](https://www.python.org/) 3.10 or newer. - [uv](https://docs.astral.sh/uv/) (recommended) or `pip`. ## Getting started Add the following config to your MCP client: ```json { "mcpServers": { "filesystemwatcher": { "command": …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.