# n8n MCP for AI Agents AI Agent Connect

> n8n (AI Workflow Automation) lets you manage your automation instance through your AI client. You can audit active workflows, track execution logs, and monitor credentials without leaving your workspace. It turns your node-based automation into something you can query and debug using natural language.

## Overview
- **Category:** ship-it
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_mmENGkHLWAgMfdYFfx8KGuMQBUozJALLFSQbAfsp/ai-agent-connect
- **Tags:** workflow-automation, no-code, api-integration, execution-logs, node-based, business-process-automation

## Description

n8n (AI Workflow Automation) lets you manage your automation instance through your AI client. Managing complex node-based workflows usually means digging through a dense dashboard to find why a specific step failed. You have to click through multiple pages, copy-paste JSON blocks, and hunt for the right execution ID just to see what happened. This Connector changes that by letting your AI agent handle the heavy lifting. You can ask your agent to pull up the logic of a specific workflow or grab the exact output from a node that's causing issues. It pulls the data directly into your chat, so you can focus on fixing the problem instead of hunting for it. You'll find it's a lot faster to audit your credentials or check who has access to your instance when you can just ask a question. It's one of the practical ways the Vinkius catalog helps you bridge the gap between your automation stack and your daily dev work. Instead of manual navigation, you get instant visibility into your automation workspace. You can see how your data flows, identify where things break, and manage your team's access in one place. It makes your automation infrastructure feel like a searchable database rather than a maze of nodes.

## Tools

### list_workflow_tags
See all the organizational tags used in your workspace. This helps you sort through complex automation logic.

### get_workflow_details
Get the full details for a specific workflow. This lets you see the logic and configuration of a single automation.

### list_instance_users
See who has access to your n8n instance. It helps you manage team permissions quickly.

### list_workflows
Get a complete list of all your automation workflows. This lets you see what's currently running in your workspace.

### list_stored_credentials
View the metadata for your saved credentials. You can verify system types and IDs without seeing secure tokens.

### list_workflow_executions
See a history of recent workflow runs. This is the first step in finding where an automation failed.

### get_execution_details
Pull the full trace logs for a specific execution. Use this to see the exact error message at a specific node.

## Prompt Examples

**Prompt:** 
```
Show me the last 3 failed runs in n8n.
```

**Response:** 
```
I've found 3 failed executions. The most recent one was in the 'Lead-Gen' workflow. It failed at the 'Send Email' node with a 'Connection Timeout' error. Would you like to see the full trace logs for this run?
```

**Prompt:** 
```
What credentials do we have for our CRM?
```

**Response:** 
```
I found 2 credentials associated with your CRM: 
- **Salesforce-Production**
- **HubSpot-Staging**

Both are currently active. Do you want me to check the workflows using these?
```

**Prompt:** 
```
List all workflows that are currently active.
```

**Response:** 
```
Here are your active workflows:

| Workflow Name | ID |
| :--- | :--- |
| **Shopify Sync** | 12 |
| **Slack Alerts** | 45 |
| **Daily Cleanup** | 78 |

Would you like to see the details for any of these?
```

## Capabilities

### Pull workflow logic
Get the JSON structure of your automation nodes directly in your chat.

### Debug execution errors
Retrieve trace logs for specific failed runs to see exactly where things broke.

### Audit credentials
See which accounts are connected without exposing any private keys or tokens.

### Manage team access
List users and roles across your n8n instance to verify permissions.

### Organize workflows
View and manage category tags to sort through complex automation projects.

### Inspect data flows
Get graph representations of specific workflows to understand data transformations.

## Use Cases

### Debugging a production failure
An automation fails in production. You ask the agent to find the last 5 failed executions and pull the trace logs for the most recent one to find the error.

### Auditing security
An IT manager needs to verify which Slack accounts are connected. They ask the agent to list all credentials associated with Slack.

### Mapping logic
A developer needs to see the exact JSON output of a specific node. They ask the agent to pull the details for a specific workflow ID.

### Workspace cleanup
An engineer wants to see which workflows are tagged as Production. They ask the agent to list all tags and active workflows.

## Benefits

- Faster Debugging: Use get_execution_details to see exactly where a node failed without hunting through the n8n dashboard.
- Better Visibility: Use list_workflows to see every automation in your workspace instantly from your AI client.
- Secure Auditing: Use list_stored_credentials to verify your connected systems and IDs without exposing sensitive keys.
- Easier Organization: Use list_workflow_tags to sort and find complex logic based on your own custom categories.
- Team Management: Use list_instance_users to quickly check who has access to your automation infrastructure.
- Logic Inspection: Use get_workflow_details to see the full JSON structure of your automation nodes in your chat window.

## How It Works

The bottom line is you get a natural language interface for your entire n8n automation workspace.

1. Connect your n8n Base URL and API Key to the Connector.
2. Open your AI client like Claude or Cursor.
3. Ask your agent to list workflows or debug specific execution IDs.

## Frequently Asked Questions

**Can I use n8n MCP to fix my broken workflows?**
Yes, it helps you find the exact reason a workflow failed by pulling trace logs and node outputs. You can then use that information to make the necessary changes in your n8n dashboard.

**Does n8n MCP show my actual passwords?**
No, it only retrieves metadata like the system type and unique IDs. This keeps your actual credentials secure while still letting you audit your connections.

**How does n8n MCP help with debugging?**
It allows you to query execution history and get detailed logs for specific IDs. This means you can identify errors without clicking through pages of logs in the n8n UI.

**Can I see who has access to my n8n instance?**
Yes, you can ask the agent to list all collaborators and their roles. This is great for quickly auditing your team's permissions.

**Can I use n8n MCP to see the JSON logic of my nodes?**
Yes, you can pull the specific details of any workflow. This includes the logic nodes and trigger configurations, which is helpful for understanding complex automations.

**What is the benefit of using n8n MCP for my automation?**
It turns your n8n workspace into a searchable database. Instead of manual navigation, you use natural language to find workflows, check logs, and audit your setup.

**Does this work with self-hosted n8n instances?**
Yes. You just need to provide your full n8n Base URL (e.g., https://n8n.your-company.com). Your agent will connect securely to your private instance using your n8n API Key.

**Can I see exactly why an n8n execution failed through my agent?**
Yes. Use the `get_execution` tool with a specific Execution ID. Your agent will retrieve the node-level trace logs, allowing you to see which specific node encountered an error and the resulting output payload for that step.

**Can my agent list the automation credentials saved in my n8n account?**
Absolutely. Use the `list_credentials` tool to identify all stored auth hooks. Your agent will report the credential names and system types (e.g., Slack, GitHub), helping you audit your integrations without exposing literal secure tokens.