Skip to content

v0.5.0 - 3 new tools, 10 lint rules, runtime policy, hosting templates

Latest
Latest

Choose a tag to compare

View all tags
@ratamaha-git ratamaha-git released this 21 May 18:36
· 10 commits to main since this release
v0.5.0
412c132

What's new

3 new tools

  • workflow.diff - Semantic diff between two workflows. Reports nodes added/removed/modified (with field-level deltas: type, typeVersion, parameters, credentials, disabled, position), connection topology changes, and settings drift. Ignores noise (small position deltas, createdAt/updatedAt). Pair with workflow.get to compare deployed vs local.
  • execution.replay - Build a self-contained replay workflow that exercises a single node from a larger workflow. The replay workflow is Manual Trigger -> Replay Seed (Code) -> target node. Optional inputItems or an execution payload pins what the target sees. Useful for iterating on one stubborn node without re-running the whole pipeline.
  • execution.timeline - Render an n8n execution as a per-node timeline: start offset, duration, items in/out, error flag. Complements execution.explain.

10 new lint rules

workflow.lint now catches:

  • Rate-sensitive node without retryOnFail/continueOnFail
  • Credential drift (credential name doesn't match node type)
  • Expression staleness ($('NodeName') referencing missing nodes)
  • Code node sandbox violations (require/process/fetch/eval)
  • Webhook test path in an active workflow
  • manualTrigger wired in an active workflow
  • Schedule trigger using triggerAtHour without settings.timezone (DST risk)
  • Disabled-but-wired node
  • Empty Set node
  • HTTP method/body mismatch (GET with body, POST without body)

Runtime policy

Constrain the server without forking. Set these env vars:

  • N8N_MCP_READ_ONLY=1 - Disables workflow.create, workflow.activate, node.scaffold.
  • N8N_MCP_DISABLED_TOOLS=workflow.create,workflow.activate - Skip specific tools entirely.
  • N8N_MCP_ALLOWED_WORKFLOW_IDS=abc,def - REST tools refuse to touch workflows outside the list.
  • N8N_MCP_ALLOWED_TAGS=prod,staging - workflow.list filters to workflows carrying at least one tag.

Distribution

  • DXT - dxt/manifest.json for Claude Desktop one-click install.
  • Docker - Dockerfile + .dockerignore.
  • Render / Railway / Fly - render.yaml, railway.toml, fly.toml.

Upgrade

npm install -g @automatelab/n8n-mcp@0.5.0

No breaking changes. All v0.4 tools work identically; the new ones are additive.

Assets 2
Loading