{"id":"spences10-mcp-n8n-builder","name":"mcp-n8n-builder","homepage":null,"repo_url":"https://github.com/spences10/mcp-n8n-builder","category":"automation","subcategories":[],"tags":["mcp","n8n","workflow-automation","ai-tools","api-integration","automation"],"what_it_does":"An MCP server that provides tools for programmatic creation, retrieval, updating, and deletion of n8n workflows, plus workflow activation/deactivation and listing/getting execution details. It validates node types against the target n8n instance and supports configurable output verbosity to reduce token usage.","use_cases":["Letting AI agents build and modify n8n workflows via MCP tools","Validating node types before creating/updating workflows to prevent n8n errors","Automating workflow lifecycle management (CRUD + activate/deactivate)","Inspecting workflow execution history and retrieving execution details"],"not_for":["Direct user-driven workflow editing UIs","Environments where model/agent cannot safely hold and use n8n credentials","Highly regulated deployments requiring documented compliance guarantees from this package"],"best_when":"You want an MCP-compatible agent to manage n8n workflows programmatically and you can supply N8N_HOST/N8N_API_KEY securely.","avoid_when":"You need strong, documented retry/idempotency semantics for destructive operations, or you cannot control the token/response size when fetching large workflows.","alternatives":["Use n8n REST API directly from your own backend/service (no MCP layer)","Create a custom MCP server wrapper around n8n’s REST API","Use official/community n8n automation SDKs (if available for your use case) rather than MCP"],"af_score":69.0,"security_score":50.5,"reliability_score":26.2,"package_type":"mcp_server","discovery_source":["github"],"priority":"high","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-03-30T13:49:50.096583+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["n8n API key via N8N_API_KEY environment variable (passed through to REST API calls)"],"oauth":false,"scopes":false,"notes":"Auth is described as N8N_API_KEY; no finer-grained scope/granularity is documented in the provided README."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information provided; as an npm package, cost would depend on your n8n usage and any LLM/agent token costs."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":69.0,"security_score":50.5,"reliability_score":26.2,"mcp_server_quality":80.0,"documentation_accuracy":75.0,"error_message_quality":null,"error_message_notes":"Score reflects stated intent ('Detailed error messages', Zod validation) but lacks example payloads and structured error taxonomy.","auth_complexity":75.0,"rate_limit_clarity":20.0,"tls_enforcement":70.0,"auth_strength":55.0,"scope_granularity":20.0,"dependency_hygiene":45.0,"secret_handling":60.0,"security_notes":"The README indicates use of N8N_HOST and N8N_API_KEY, but does not specify whether HTTPS-only is enforced, how errors log sensitive data (if at all), or whether scopes/least-privilege are supported. Dependency list is minimal in the manifest and does not provide vulnerability posture.","uptime_documented":0.0,"version_stability":45.0,"breaking_changes_history":30.0,"error_recovery":30.0,"idempotency_support":"false","idempotency_notes":"No explicit idempotency guarantees documented; destructive actions like delete_workflow are described as permanent.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Token usage can be high for large n8n workflow JSON; use OUTPUT_VERBOSITY=concise and consider per-tool verbosity overrides.","update_workflow requires the entire workflow structure (not a patch); agents must supply complete, validated payloads.","delete_workflow is permanent and cannot be undone—agents should be careful with confirmation/guardrails outside this package."]}}