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

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.

v1.0.0 — n8n MCP GitHub Action

n8n MCP GitHub Action

Run n8n MCP tools directly in your CI/CD pipelines.

What it does

• Lint — detect errors and anti-patterns in workflow JSON on every PR
• Explain — post human-readable diagnoses of failed executions as PR comments
• Generate — produce workflow JSON from a plain-English description
• Scaffold — generate a custom node stub from a description

Quick start

```yaml

• uses: ratamaha-git/n8n-mcp@v1.0.0
  with:
  command: lint
  workflow-json: ${{ steps.export.outputs.workflow }}
  ```

See ACTION.md for full input/output reference and GITHUB-ACTION-SETUP.md for Marketplace publication steps.

v0.3.0 - explain_execution, REST tools, references split

What's new in v0.3.0

New tools

• n8n_explain_execution - paste execution JSON, get per-node findings: zero-item nodes, unresolved expressions, error messages with hints. The core debugging tool.
• n8n_list_workflows - list workflows from a live n8n instance (requires N8N_API_URL + N8N_API_KEY)
• n8n_get_workflow - fetch a specific workflow by ID
• n8n_create_workflow - create a workflow on a live instance
• n8n_activate_workflow - activate/deactivate a workflow
• n8n_get_executions - pull recent executions for a workflow

Improvements

• references/ split: skill context broken into focused sub-files so it doesn't bloat the agent prompt
• Gemini CLI extension wrapper added (gemini-extension.json, GEMINI.md)
• README sharpened for awesome-list quotability
• MCP Registry server.json description trimmed to 100-char limit
• Compatibility host list expanded to 10 popular MCP hosts

Previous releases

v0.2.1

• MCP Registry compliance: added mcpName field, server.json

v0.2.0

• AI agent template with correct LangChain cluster topology
• Lint rules: agent missing language model, IF v1 schema, spreadsheetFile deprecation, webhookId

v0.1.1

• Fixed bin path (dropped leading ./)

v0.1.0

• Initial release: n8n_generate_workflow, n8n_lint_workflow, n8n_get_node_info

Community

• SECURITY.md - vulnerability reporting policy
• CONTRIBUTING.md - dev setup and PR process

Built by AutomateLab