Agent Tools

Synta MCP provides 21 specialized tools to help your AI agent understand, search, validate, and build N8N workflows with full support for both core and community nodes. These tools include self-healing capabilities that automatically test, detect errors, and fix issues.

Getting Started with Agent Tools

Follow these typical workflows to get the most out of Synta MCP:

Search & Discover Nodes

Ask your coding agent: “Use node search to find how to send messages in Slack” or “Search for nodes that handle HTTP requests”

search_nodes({query: "slack", includeExamples: true})

The includeExamples flag returns real-world configurations from production workflows.

Build Your First Workflow

Ask: “Create a workflow that triggers on a webhook, transforms the data with a Code node, and sends a Slack notification”Your AI will:

Search for the required nodes (Webhook, Code, Slack)
Get node details with get_node
Find similar templates with search_templates
Create the workflow with n8n_create_workflow

Validate & Auto-Fix

Ask: “Validate my workflow and fix any issues”

n8n_validate_workflow({id: "workflow-id"})
n8n_autofix_workflow({id: "workflow-id", applyFixes: true})

Autofix handles common issues like expression format, typeVersion corrections, and webhook paths.

Test with Self-Healing

Ask: “Test my workflow and fix any errors automatically”

n8n_trigger_execution({id: "workflow-id"})

Self-Healing Capabilities:

Automatically detects trigger type (Manual, Chat, Webhook)
Executes the workflow and analyzes results
Identifies root causes of failures
Modifies configurations to fix detected issues

Requires N8N login credentials for full self-healing. See Installation for setup.

Debug & Trace Executions

Ask: “Why did my workflow fail? Trace the execution chain.”

n8n_executions({action: "get", id: "exec-id", mode: "error"})
n8n_executions({action: "correlate", executionId: "exec-id"})

Correlation traces execution chains across multiple workflows using webhook path matching and timing analysis.

Tool Categories

Node Discovery (2)

search_nodes - Full-text search across nodesget_node - Complete node information with multiple modes

Templates (3)

search_templates - Search 10,000+ templatesget_template - Get workflow JSON by IDn8n_deploy_template - Deploy from n8n.io

Workflow Management (8)

n8n_create_workflow - Create workflowsn8n_update_partial_workflow - Diff-based updates with typeVersion supportn8n_list_workflows - List all workflows…and 5 more workflow tools

Execution & Testing (3)

n8n_trigger_execution - Self-healing testingn8n_test_workflow - External testingn8n_executions - Execution management

Workflow Analysis (3)

n8n_search_workflow - AST-based searchn8n_workflow_versions - Version controln8n_autofix_workflow - Auto-fix errors

Credentials & Tags (2)

n8n_manage_credentials - Manage credentialsn8n_manage_tags - Organize with tags

Complete Tool Reference

Node Discovery & Configuration (2 tools)

search_nodes

tool

Full-text search across all N8N nodes by name, description, or category with optional real-world examples from production workflows.

Show parameters

query

string

required

Search terms. Use quotes for exact phrase.

limit

number

default:"20"

Max results (default 20)

mode

string

default:"OR"

OR=any word, AND=all words, FUZZY=typo-tolerant

source

string

default:"all"

Filter: all, core, community, verified

includeExamples

boolean

default:"false"

Include top 2 real-world configuration examples

get_node

tool

Get node information with progressive detail levels and multiple modes.

Show parameters

nodeType

string

required

Full node type: “nodes-base.httpRequest” or “nodes-langchain.agent”

detail

string

default:"standard"

minimal (~200 tokens), standard (1-2K, recommended), full (3-8K)

mode

string

default:"info"

info, docs, search_properties, raw, versions, compare, breaking, migrations

includeTypeInfo

boolean

default:"false"

Include type structure metadata

includeExamples

boolean

default:"false"

Include real-world configuration examples

Template Tools (3 tools)

search_templates

tool

Search through 10,000+ workflow templates with multiple search modes.

Show parameters

searchMode

string

default:"keyword"

keyword, by_nodes, by_task, by_metadata

query

string

For keyword mode: search text

fields

string[]

For keyword mode: fields to include (id, name, description, author, nodes, views, created, url, metadata)

nodeTypes

string[]

For by_nodes mode: array of node types

task

string

For by_task mode: ai_automation, data_sync, webhook_processing, email_automation, slack_integration, data_transformation, file_processing, scheduling, api_integration, database_operations

complexity

string

For by_metadata: simple, medium, complex

targetAudience

string

For by_metadata: developers, marketers, analysts

requiredService

string

For by_metadata: filter by required service (e.g., “openai”, “slack”)

tags

string[]

Filter by tags (exact match)

searchTerm

string

Filter workflows by name using search within the current page

searchMode

string

default:"fuzzy"

fuzzy=typo-tolerant matching (default), fulltext=prefix/token matching

limit

number

default:"100"

Number of workflows (1-100)

cursor

string

Pagination cursor from previous response

projectId

string

Filter by project ID (enterprise feature)

excludePinnedData

boolean

default:"true"

Exclude pinned data from response

n8n_update_partial_workflow

tool

Update workflows incrementally with diff operations. Supports 15 operation types including typeVersion updates with automatic validation.

Show parameters

string

required

Workflow ID to update

operations

object[]

required

Array of diff operations: addNode, removeNode, updateNode, moveNode, enable/disableNode, addConnection, removeConnection, rewireConnection, cleanStaleConnections, replaceConnections, updateSettings, updateName, add/removeTag

continueOnError

boolean

default:"false"

Best-effort mode: apply valid operations even if some fail

validateOnly

boolean

default:"false"

Only validate operations without applying

n8n_update_full_workflow

tool

Replace an entire workflow with new configuration. For incremental updates, use n8n_update_partial_workflow instead.

Show parameters

string

required

Workflow ID to update

name

string

New workflow name

nodes

object[]

Complete array of workflow nodes

connections

object

Complete connections object

n8n_delete_workflow

tool

Permanently delete a workflow. This action cannot be undone.

Show parameters

string

required

Workflow ID to delete

n8n_validate_workflow

tool

Validate workflow configuration, connections, and expressions.

Show parameters

string

required

Workflow ID to validate

options

object

Show properties

validateNodes

boolean

default:"true"

Validate node configurations

validateConnections

boolean

default:"true"

Validate workflow connections

validateExpressions

boolean

default:"true"

Validate n8n expressions

profile

string

default:"runtime"

minimal, runtime, ai-friendly, strict

visual_capture

tool

Render a visual screenshot of a workflow and return base64 encoded image.

Show parameters

string

required

Workflow ID to render

Workflow Analysis & Utilities (3 tools)

n8n_search_workflow

tool

Search within a workflow using AST-based queries with fuzzy matching.

Show parameters

string

required

Workflow ID to search within

search_type

string

default:"nodes"

nodes, connections, flow_patterns, parameters, comprehensive

query

object

required

Search query object with criteria based on search_type

return_context

boolean

default:"true"

Include position and connection context for matches

n8n_workflow_versions

tool

Manage workflow version history, rollback, and cleanup. Creates backup before rollback.

Show parameters

mode

string

required

list, get, rollback, delete, prune, truncate

workflowId

string

Workflow ID (required for list, rollback, delete, prune)

versionId

number

Version ID (required for get and single version delete, optional for rollback)

limit

number

default:"10"

Max versions to return in list mode

validateBefore

boolean

default:"true"

Validate workflow structure before rollback

deleteAll

boolean

default:"false"

Delete all versions for workflow (delete mode only)

maxVersions

number

default:"10"

Keep N most recent versions (prune mode)

confirmTruncate

boolean

default:"false"

REQUIRED: Must be true to truncate all versions (truncate mode only)

n8n_autofix_workflow

tool

Automatically fix common validation errors. Preview fixes before applying.

Show parameters

string

required

Workflow ID to fix

applyFixes

boolean

default:"false"

Apply fixes (default: preview mode)

fixTypes

string[]

Types: expression-format, typeversion-correction, error-output-config, node-type-correction, webhook-missing-path, typeversion-upgrade, version-migration

confidenceThreshold

string

default:"medium"

high, medium, low

Workflow Execution & Testing (3 tools)

n8n_trigger_execution

tool

The most powerful tool in Synta MCP. Triggers workflows and enables true AI self-healing by automatically testing, detecting errors, analyzing root causes, and modifying configurations to fix issues.Requires: N8N_LOGIN_EMAIL and N8N_LOGIN_PASSWORD

Show parameters

string

required

Workflow ID to execute

triggerNode

string

Specific trigger node name (auto-detects if not specified)

chatMessage

string

default:"Hello world"

Message for Chat Trigger nodes

formData

object

Form field values for Form Trigger nodes (e.g., field-0: value, field-1: 2003-05-21)

webhookData

object

Custom JSON payload for webhook triggers

pinData

array

Custom pinData for trigger output (auto-generates if not provided)

timeout

number

default:"60"

Max seconds to wait for completion

includeData

boolean

default:"true"

Include execution output data

includeErrorStack

boolean

default:"false"

Include full error stack trace in error details

Show self-healing capabilities

Auto-detection: Identifies Manual, Chat, Webhook, and Form triggers automatically
Error analysis: AI analyzes execution results to identify root causes
Self-correction: Modifies workflow configurations to fix detected issues
Full debugging: Complete execution data including all node outputs
Webhook handling: Automatically polls and calls webhook URLs when needed
Mock data generation: Auto-generates appropriate test data for IMAP, Schedule, Cron triggers

n8n_test_workflow

tool

External workflow testing without login credentials. Test workflows with webhook, form, or chat triggers. Workflow must be active.

Show parameters

workflowId

string

required

Workflow ID to execute

triggerType

string

webhook, form, chat (auto-detected if not specified)

httpMethod

string

GET, POST, PUT, DELETE (default: auto-detected from webhook config)

data

object

Input data/payload for webhook or form fields

webhookPath

string

Override the webhook path

message

string

Message for chat triggers

sessionId

string

Session ID for chat conversation continuity

headers

object

Custom HTTP headers

timeout

number

default:"120000"

Timeout in milliseconds

waitForResponse

boolean

default:"true"

Wait for workflow completion

n8n_executions

tool

Comprehensive execution management with advanced correlation to trace execution chains.

Show parameters

action

string

required

get, list, delete, retry, correlate

string

Execution ID (for get, delete, retry)

mode

string

default:"summary"

For get: preview, summary, filtered, full, error

includeInputData

boolean

default:"false"

For get: include input data in addition to output

itemsLimit

number

For get with mode=filtered: items per node (0=structure, 2=default, -1=unlimited)

nodeNames

string[]

For get with mode=filtered: filter to specific nodes by name

includeStackTrace

boolean

default:"false"

For get with mode=error: include full stack trace

includeExecutionPath

boolean

default:"true"

For get with mode=error: include execution path leading to error

errorItemsLimit

number

default:"2"

For get with mode=error: sample items from upstream node (max: 100)

fetchWorkflow

boolean

default:"true"

For get with mode=error: fetch workflow for accurate upstream detection

workflowId

string

For list: filter by workflow

status

string

For list: success, error, waiting

limit

number

default:"100"

For list: number of executions (1-100)

cursor

string

For list: pagination cursor from previous response

projectId

string

For list: filter by project ID (enterprise feature)

includeData

boolean

default:"false"

For list: include execution data

loadWorkflow

boolean

default:"true"

For retry: whether to load the workflow definition

executionId

string

For correlate: starting execution ID

timeWindowMs

number

default:"30000"

For correlate: time window in milliseconds

Show correlation features

Webhook path matching: Find executions triggered by HTTP calls
User context matching: Correlate by user_id, chat_id, correlation_id
Timing analysis: Find executions within configurable time window
Sub-workflow detection: Identify executeWorkflowTrigger patterns

Credentials & Tags (2 tools)

n8n_manage_credentials

tool

Unified tool for managing n8n credentials with three modes.

Show parameters

mode

string

required

create, delete, get_schema

name

string

Credential name (for create)

type

string

Credential type e.g., “httpBasicAuth”, “gmailOAuth2Api” (for create)

data

object

Credential data with type-specific fields (for create)

string

Credential ID (for delete)

credentialTypeName

string

Credential type name (for get_schema)

n8n_manage_tags

tool

Unified tool for managing workflow tags with six modes.

Show parameters

mode

string

required

create, list, get, update, delete, assign

name

string

Tag name (for create, update). Max 100 chars.

tagId

string

Tag ID (for get, update, delete)

workflowId

string

Workflow ID (for assign)

tagIds

string[]

Tag IDs to assign (for assign). Empty array removes all tags.

Next Steps

Best Practices

Learn tips and tricks for building better workflows with AI

Configure Agent Rules

Set up IDE-specific rules for optimal workflow building

Production Safety: Always test workflows in a development environment before deploying to production. Never edit production workflows directly without backups.

Getting Started

Features

Rules

Best Practices

Privacy

Getting Started with Agent Tools

Tool Categories

Node Discovery (2)

Templates (3)

Workflow Management (8)

Execution & Testing (3)

Workflow Analysis (3)

Credentials & Tags (2)

Complete Tool Reference

Next Steps

Best Practices

Configure Agent Rules

Getting Started

Features

Rules

Best Practices

Privacy

​Getting Started with Agent Tools

​Tool Categories

Node Discovery (2)

Templates (3)

Workflow Management (8)

Execution & Testing (3)

Workflow Analysis (3)

Credentials & Tags (2)

​Complete Tool Reference

​Next Steps

Best Practices

Configure Agent Rules

Getting Started with Agent Tools

Tool Categories

Complete Tool Reference

Next Steps