Skip to main content
Glama
ifmelate

n8n-workflow-builder-mcp

by ifmelate

n8n Workflow Builder MCP

Сервер протокола контекста модели (MCP) для создания и изменения рабочих процессов n8n. Создавайте рабочие процессы n8n с помощью ИИ — работает с Claude Code, VS Code, Cursor и любым клиентом, поддерживающим MCP.

ДЕМОНСТРАЦИОННОЕ ВИДЕО:

Смотреть видео

Правила Cursor

  • Файл с правилами находится в rules/n8n-mcp-server-rules.mdc

Related MCP server: mcp-n8n-builder

Основные возможности

  • Управление рабочими процессами: Программное создание, обновление и выполнение рабочих процессов n8n (выполнение пока не реализовано)

  • Обнаружение узлов: Изучение доступных узлов n8n и их возможностей

  • Управление соединениями: Создание связей между узлами рабочего процесса

  • Интеграция с ИИ: Специальные инструменты для подключения компонентов ИИ в рабочих процессах

  • Интерфейс, удобный для ИИ: Разработан специально для взаимодействия с ИИ-агентами

  • Управление версиями N8N: Автоматическое определение версии и обработка совместимости — поддерживает 184+ версии n8n (1.86.0 – 2.6.2) с динамической фильтрацией узлов и сопоставлением с «ближайшей младшей версией» для обеспечения обратной совместимости

Предварительные требования

  • Node.js (v18 или выше)

  • npm (для команды npx)

  • Клиент, поддерживающий MCP (Claude Code, VS Code, Cursor и т.д.)

Установка и настройка

Получение API-ключа n8n

  1. Откройте ваш экземпляр n8n в браузере

  2. Перейдите в Settings > API Keys

  3. Нажмите Create API Key

  4. Скопируйте созданный ключ и используйте его в своей конфигурации

Claude Code (рекомендуется)

Добавьте MCP-сервер с помощью CLI Claude Code:

claude mcp add n8n-workflow-builder -- npx -y n8n-workflow-builder-mcp

Затем установите переменные окружения:

claude mcp add n8n-workflow-builder \
  -e N8N_API_URL=http://localhost:5678 \
  -e N8N_API_KEY=your-n8n-api-key-here \
  -- npx -y n8n-workflow-builder-mcp

N8N_VERSION является необязательным — сервер автоматически определяет его через API.

VS Code / Cursor

Добавьте в ваш файл конфигурации MCP (.vscode/mcp.json для VS Code, .cursor/mcp.json для Cursor):

{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": ["-y", "n8n-workflow-builder-mcp"],
      "env": {
        "N8N_API_URL": "http://localhost:5678",
        "N8N_API_KEY": "your-n8n-api-key-here"
      }
    }
  }
}

Перезапустите IDE, чтобы изменения вступили в силу.

Установка для разработки

Для разработки или локального тестирования клонируйте и соберите проект из исходного кода:

git clone https://github.com/ifmelate/n8n-workflow-builder-mcp.git
cd n8n-workflow-builder-mcp
npm install
npm run build

Затем укажите вашему MCP-клиенту путь к собранной точке входа:

# Claude Code
claude mcp add n8n-workflow-builder -- node /absolute/path/to/n8n-workflow-builder-mcp/dist/index.js

# VS Code / Cursor — use the same JSON config above with "command": "node" and "args": ["/absolute/path/to/dist/index.js"]

Для разработки с автоматической пересборкой:

npm run dev

Доступные инструменты MCP

Сервер предоставляет следующие инструменты для работы с рабочими процессами n8n:

Основное управление рабочими процессами

Название инструмента

Описание

Ключевые параметры

create_workflow

Создать новый рабочий процесс n8n

workflow_name, workspace_dir

list_workflows

Список рабочих процессов в рабочей директории

limit (опционально), cursor (опционально)

get_workflow_details

Получить подробную информацию о конкретном рабочем процессе

workflow_name, workflow_path (опционально)

validate_workflow

Проверить файл рабочего процесса на соответствие схемам узлов и связность

workflow_name, workflow_path (опционально)

Управление узлами

Название инструмента

Описание

Ключевые параметры

add_node

Добавить новый узел в рабочий процесс

workflow_name, node_type, position (опционально), parameters (опционально), node_name (опционально), typeVersion (опционально), webhookId (опционально), workflow_path (опционально), connect_from (опционально), connect_to (опционально)

edit_node

Редактировать существующий узел в рабочем процессе

workflow_name, node_id, node_type (опционально), node_name (опционально), position (опционально), parameters (опционально), typeVersion (опционально), webhookId (опционально), workflow_path (опционально), connect_from (опционально), connect_to (опционально)

delete_node

Удалить узел из рабочего процесса

workflow_name, node_id, workflow_path (опционально)

list_available_nodes

Список доступных типов узлов с опциональной фильтрацией. Поддерживает синонимы в стиле тегов и логику OR/AND для нескольких токенов

search_term (опционально), n8n_version (опционально), limit (опционально), cursor (опционально), tags (опционально, по умолчанию: true), token_logic (опционально: 'or' по умолчанию, или 'and')

Управление соединениями

Название инструмента

Описание

Ключевые параметры

add_connection

Создать соединение между двумя узлами

workflow_name, source_node_id, source_node_output_name, target_node_id, target_node_input_name, target_node_input_index (опционально), workflow_path (опционально)

add_ai_connections

Подключить ИИ-модель, инструменты и память к агенту

workflow_name, agent_node_id, model_node_id (опционально), tool_node_ids (опционально), memory_node_id (опционально), embeddings_node_id (опционально), vector_store_node_id (опционально), vector_insert_node_id (опционально), vector_tool_node_id (опционально), workflow_path (опционально)

connect_main_chain

Построить минимальный основной путь через узлы ИИ-рабочего процесса (Триггер → Модель → Память → Эмбеддинги → Загрузчик документов → Векторное хранилище → Векторный инструмент → Агент)

workflow_name, workflow_path (опционально), dry_run (опционально), idempotency_key (опционально)

Планирование и создание рабочих процессов

Название инструмента

Описание

Ключевые параметры

plan_workflow

Создать неразрушающий план (узлы и соединения) для обновления рабочего процесса. Не записывает файлы

workflow_name, target (узлы, соединения), workspace_dir (опционально)

review_workflow_plan

Применить план в памяти и вернуть ошибки валидации, предупреждения и предложенные исправления. Не записывает файлы

workflow_name, plan, workflow_path (опционально)

apply_workflow_plan

Применить ранее проверенный план к рабочему процессу на диске (атомарная запись)

workflow_name, plan, workflow_path (опционально)

compose_ai_workflow

Создать сложный ИИ-рабочий процесс (агент + модель + память + эмбеддинги + вектор + инструменты + триггер) за один вызов, включая связывание и базовую валидацию

workflow_name, plan, n8n_version (опционально)

Управление параметрами

Название инструмента

Описание

Ключевые параметры

suggest_node_params

Предложить минимальные допустимые параметры для типа узла, используя значения по умолчанию и обязательные поля

node_type, typeVersion (опционально), existing_parameters (опционально)

list_missing_parameters

Список обязательных параметров, отсутствующих для узла, с учетом правил видимости

node_type, typeVersion (опционально), parameters

fix_node_params

Вернуть параметры с примененными значениями по умолчанию для отсутствующих обязательных полей

node_type, typeVersion (опционально), parameters (опционально)

Шаблоны и обнаружение

Название инструмента

Описание

Ключевые параметры

list_template_examples

Список примеров использования узлов, извлеченных из бесплатных шаблонов. Фильтрация по node_type или template_name

node_type (опционально), template_name (опционально), limit (опционально), cursor (опционально)

get_n8n_version_info

Получить текущую версию N8N и возможности

random_string

Поведение валидации

validate_workflow повышает уровень предупреждений до ошибок и дополнительно выдает ошибку, если какой-либо активный узел не подключен (напрямую или через порты ИИ) к основной цепочке, начинающейся с предполагаемого startNode. Используйте connect_from/connect_to или add_ai_connections для исправления связности.

Устранение неполадок

Общие

  1. Проверьте вашу конфигурацию MCP — убедитесь, что JSON валиден и имя сервера совпадает.

  2. Обновите Node.js до последней версии LTS.

  3. Очистите кэш npm, если npx выдает ошибку: npm cache clean --force

  4. Попробуйте глобальную установку в качестве запасного варианта: npm install -g n8n-workflow-builder-mcp

Claude Code

  • Выполните claude mcp list, чтобы убедиться, что сервер зарегистрирован.

  • Проверьте логи с помощью claude mcp logs n8n-workflow-builder.

VS Code / Cursor

  • Проверьте панель вывода (Output) — выберите "MCP" в выпадающем списке, чтобы увидеть логи сервера.

  • Убедитесь, что сервер включен в Settings > Features > MCP Servers.

  • Перезапустите IDE после внесения изменений в конфигурацию.

Структура проекта

  • /src: Основной исходный код

  • /src/tools: Реализация инструментов MCP

  • /src/models: Модели данных

  • /src/utils: Вспомогательные функции

  • /src/middleware: Аутентификация и промежуточное ПО

  • /config: Файлы конфигурации

  • /tests: Файлы тестов

  • /workflow_nodes: Определения узлов n8n

  • /docs: Дополнительная документация

Вклад в проект

Вклад приветствуется! Пожалуйста, не стесняйтесь отправлять Pull Request.

  1. Сделайте форк репозитория

  2. Создайте ветку для вашей функции (git checkout -b feature/amazing-feature)

  3. Зафиксируйте изменения (git commit -m 'Add some amazing feature')

  4. Отправьте изменения в ветку (git push origin feature/amazing-feature)

  5. Откройте Pull Request

Лицензия

MIT License

Available Tools

10 tools
add_ai_connectionsD
ParametersJSON Schema
NameRequiredDescriptionDefault
agent_node_idYesThe ID of the agent node that will use the model and tools
memory_node_idNoThe ID of the memory node (optional)
model_node_idNoThe ID of the language model node (optional)
tool_node_idsNoArray of tool node IDs to connect to the agent (optional)
workflow_nameYesThe Name of the workflow to add the AI connections to

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

add_connectionD
ParametersJSON Schema
NameRequiredDescriptionDefault
source_node_idYesThe ID of the source node for the connection
source_node_output_nameYesThe name of the output handle on the source node (e.g., 'main')
target_node_idYesThe ID of the target node for the connection
target_node_input_indexNoThe index for the target node's input handle (default: 0)
target_node_input_nameYesThe name of the input handle on the target node (e.g., 'main')
workflow_nameYesThe Name of the workflow to add the connection to

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

add_nodeD
ParametersJSON Schema
NameRequiredDescriptionDefault
node_nameNoThe name for the new node (e.g., 'My Gmail Node')
node_typeYesThe type of node to add (e.g., 'gmail', 'slack', 'openAi'). You can specify with or without the 'n8n-nodes-base.' prefix. The system will handle proper casing (e.g., 'openai' will be converted to 'openAi' if that's the correct casing).
parametersNoThe parameters for the node
positionNoThe position of the node {x,y} - will be converted to [x,y] for N8nWorkflowNode
typeVersionNoThe type version for the node (e.g., 1, 1.1). Defaults to 1 if not specified.
webhookIdNoOptional webhook ID for certain node types like triggers.
workflow_nameYesThe Name of the workflow to add the node to
workflow_pathNoOptional direct path to the workflow file (absolute or relative to current working directory). If not provided, uses standard workflow_data directory approach.

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

create_workflowD
ParametersJSON Schema
NameRequiredDescriptionDefault
workflow_nameYesThe name for the new workflow
workspace_dirYesAbsolute path to the project root directory where workflow_data will be stored

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

delete_nodeD
ParametersJSON Schema
NameRequiredDescriptionDefault
node_idYesThe ID of the node to delete
workflow_nameYesThe Name of the workflow containing the node
workflow_pathNoOptional direct path to the workflow file (absolute or relative to current working directory). If not provided, uses standard workflow_data directory approach.

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

edit_nodeD
ParametersJSON Schema
NameRequiredDescriptionDefault
node_idYesThe ID of the node to edit
node_nameNoThe new name for the node
node_typeNoThe new type for the node (e.g., 'gmail', 'slack', 'openAi'). You can specify with or without the 'n8n-nodes-base.' prefix. The system will handle proper casing (e.g., 'openai' will be converted to 'openAi' if that's the correct casing).
parametersNoThe new parameters
positionNoThe new position {x,y} - will be converted to [x,y]
typeVersionNoThe new type version for the node
webhookIdNoOptional new webhook ID for the node.
workflow_nameYesThe Name of the workflow containing the node
workflow_pathNoOptional workflow path to the workflow file

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_n8n_version_infoD
ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

get_workflow_detailsD
ParametersJSON Schema
NameRequiredDescriptionDefault
workflow_nameYesThe Name of the workflow to get details for
workflow_pathNoOptional direct path to the workflow file (absolute or relative to current working directory). If not provided, uses standard workflow_data directory approach.

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_available_nodesD
ParametersJSON Schema
NameRequiredDescriptionDefault
n8n_versionNoFilter nodes by N8N version compatibility. If not provided, uses current configured N8N version.
search_termNoAn optional search term to filter nodes by their name, type, or description.

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

list_workflowsD
ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

D1/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Tool has no description.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness1/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Tool has no description.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness1/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Tool has no description.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters1/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Tool has no description.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose1/5

Does the description clearly state what the tool does and how it differs from similar tools?

Tool has no description.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Tool has no description.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 10 tool updatesv1.0.0
    • First observedadd_ai_connections
    • First observedadd_connection
    • First observedadd_node
    • First observedcreate_workflow
    • First observeddelete_node
    • First observededit_node
    • First observedget_n8n_version_info
    • First observedget_workflow_details
    • First observedlist_available_nodes
    • First observedlist_workflows

TDQS

C2/5.0

Scored across 10 tools

Disambiguation4/5

Most tools have distinct purposes targeting different aspects of n8n workflow management (e.g., create_workflow vs. list_workflows, add_node vs. edit_node vs. delete_node). However, add_ai_connections and add_connection could potentially be confused without descriptions, as their relationship is unclear—they might overlap in handling connections.

Naming Consistency5/5

All tool names follow a consistent verb_noun pattern with snake_case throughout (e.g., add_connection, create_workflow, get_workflow_details). There are no deviations in naming conventions, making the set predictable and readable.

Tool Count5/5

With 10 tools, the count is well-scoped for a workflow builder server, covering core operations like creating, listing, and managing workflows and nodes. Each tool appears to earn its place without being excessive or insufficient for the domain.

Completeness3/5

The tools cover basic CRUD operations for workflows and nodes (create, list, get, edit, delete), but there are notable gaps. For example, there's no update_workflow or delete_workflow tool, and the absence of descriptions makes it hard to assess if AI connections and general connections are fully covered, potentially leaving dead ends in workflow management.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    D
    maintenance
    An MCP server enabling secure interaction with n8n workflows, executions, and settings via the Model Context Protocol, designed for integration with Large Language Models (LLMs).
    33
    58 npm
    119
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    🪄 MCP server for programmatic creation and management of n8n workflows. Enables AI assistants to build, modify, and manage workflows without direct user intervention through a comprehensive set of tools and resources for interacting with n8n's REST API.
    10
    50 npm
    86
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for integrating with n8n, enabling workflow automation and management through natural language.
    318 npm
    1
    MIT