n8n-guard
flow-84/n8n-guard
Read-only health checks for self-hosted n8n: datastore growth, stuck runs, retention, git drift.
- tools
- 6
- auth
- Secret needed
- transport
- STDIO
- env vars
- 9
- last updated
- Nov 12, 2026
Tools
6 toolsPublic tool metadata for what this MCP can expose to an agent.
instance_infoReachability, configured datastore, workflow inventory. Shows which checks are usable.
Reachability, configured datastore, workflow inventory. Shows which checks are usable.
No parameter schema in public metadata yet.
db_healthDatastore size, per-table breakdown, growth rate, projected days until the critical threshold.
Datastore size, per-table breakdown, growth rate, projected days until the critical threshold.
No parameter schema in public metadata yet.
stuck_executionsRuns stuck in `running`, judged against the absolute threshold and each workflow's own median.
Runs stuck in `running`, judged against the absolute threshold and each workflow's own median.
No parameter schema in public metadata yet.
retention_reportExecution count, age span, and what pruning to a retention window would free.
Execution count, age span, and what pruning to a retention window would free.
No parameter schema in public metadata yet.
git_driftLive workflows against the repository exports: missing, deleted, drifted, duplicated.
Live workflows against the repository exports: missing, deleted, drifted, duplicated.
No parameter schema in public metadata yet.
guard_runAll of the above in one resilient sweep. This is the one to schedule.
All of the above in one resilient sweep. This is the one to schedule.
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
N8N_URLBase URL of the n8n instance. Defaults to http://localhost:5678.
N8N_API_KEYsecretn8n Public API key. Required for the execution and workflow checks.
N8N_SQLITE_PATHPath to the n8n database.sqlite file. Required for datastore checks on SQLite.
N8N_POSTGRES_URLsecretPostgres connection string. Takes precedence over N8N_SQLITE_PATH.
N8N_GIT_REPO_PATHCheckout holding exported workflow JSON. Required for the git drift check.
N8N_GUARD_STUCK_MINUTESMinutes a run may stay in `running` before it counts as stuck. Defaults to 15.
N8N_GUARD_DB_WARN_BYTESDatastore warning threshold in bytes. Defaults to 1073741824 (1 GB).
N8N_GUARD_DB_CRITICAL_BYTESDatastore critical threshold in bytes. Defaults to 4294967296 (4 GB).
N8N_GUARD_TIMEOUT_MSPer-request API timeout in milliseconds. Defaults to 15000.
Readme
n8n-guard
An MCP server for the operational layer underneath the n8n Public API.
Most n8n MCP servers on the registry wrap the same public endpoints: list workflows, list executions, create, activate, delete. That is useful for building workflows. It is close to useless for keeping a self-hosted instance alive, because the things that actually take an instance down are not in that API at all.
n8n-guard answers the four questions the API cannot:
Details
- Repository
- github.com/flow-84/n8n-guard
- Website
- github.com/flow-84/n8n-guard#readme
- Categories
- Developer Tools, Automation & Workflows
- Package
n8n-guard- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active
