Which integrations are available for this server?

Provides orchestration tools for [n8n](/mcp/servers/integrations/n8n) workflows, including smart upsert (create/update), execution diagnostics, workflow state management, community node installation, and automated workflow fixes.

n8n Architect MCP Server

Production-grade MCP server for n8n workflow orchestration.

Features

Smart Upsert: Create or update workflows by name
Deep Diagnostics: Analyze failed executions with detailed error extraction
Package Management: Install community nodes via npm
Auto-Fix: Composite tool to diagnose and patch failing workflows

Quick Start

Windows

start_server.bat

Manual Setup

# Create virtual environment python -m venv venv # Activate (Windows) venv\Scripts\activate # Install dependencies pip install -r requirements.txt # Run server python run.py

Configuration

Create a .env file:

N8N_API_KEY=your_api_key_here N8N_BASE_URL=http://localhost:5678/api/v1 N8N_EDITOR_URL=http://localhost:5678 N8N_DATA_DIR=~/.n8n API_HOST=0.0.0.0 API_PORT=8000 DEBUG=false

Available Tools

Tool	Description
`list_all_workflows`	List workflows with optional tag filter
`deploy_workflow`	Smart Upsert: create or update by name
`read_workflow_structure`	Get full workflow JSON
`diagnose_execution`	Deep dive into failed execution
`auto_fix_workflow`	Diagnose + patch in one call
`install_community_node`	Install npm packages
`toggle_workflow_state`	Activate/deactivate workflows
`delete_workflow`	Remove workflows

API Endpoints

GET /health - Server health check
GET /info - Server configuration

Architecture

app/ ├── core/ │ ├── config.py # Pydantic Settings │ ├── client.py # HTTP Client + error handling │ └── logging.py # Structured logging ├── models/ │ └── schemas.py # Data contracts ├── services/ │ ├── architect.py # Deploy/Read/Clone │ ├── debugger.py # Diagnostics │ ├── manager.py # List/Toggle/Delete │ └── packages.py # npm management └── main.py # FastAPI + FastMCP gateway