How to Use the n8n (AI Workflow Automation) MCP in OpenAI Agents SDK

Q: How does the OpenAI Agents SDK use the n8n (AI Workflow Automation) server to find specific workflows?

Your agent uses listworkflows to get a full list, then can filter them by name or use listworkflowtags to find workflows grouped by project or function. It’s a direct way to target the exact automation you need to inspect.

Q: What's the best way to debug a failed n8n workflow with the OpenAI Agents SDK?

First, call listworkflowexecutions to find the failed run and get its ID. Then, feed that ID into getexecutiondetails. Your agent gets the complete execution trace to pinpoint the exact point of failure.

Q: Can I use this n8n (AI Workflow Automation) MCP Server to monitor user access with my OpenAI Agents SDK agent?

Yes. The listinstanceusers tool gives your agent a list of all users on the n8n instance. You can use this to automate security checks for off-boarding or to audit who has access to sensitive workflows.

Q: How is my n8n (AI Workflow Automation) credential data protected when using the OpenAI Agents SDK?

The liststoredcredentials tool is designed for security, exposing only metadata and never the secrets themselves. Vinkius also runs each MCP server in an ephemeral, zero-trust sandbox, so your connection is isolated and secure.

Build production-grade n8n auditors with the OpenAI Agents SDK. Get full tracing and safety guardrails for every workflow action.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect n8n (AI Workflow Automation) MCP to OpenAI Agents SDK

Create your Vinkius account to connect n8n (AI Workflow Automation) to OpenAI Agents SDK and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup n8n (AI Workflow Automation) with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Audit Workflows, Don't Just Run Them

Stop guessing what's running in your n8n instance. Give your agent a tool to pull a complete inventory with `list_workflows` and see exactly who has access with `list_instance_users`. It's the first step to locking things down. Your OpenAI Agent can then dig into specific workflows using `get_workflow_details`. This isn't just about listing names; it's about programmatically checking triggers, steps, and connections before they become a problem.

Trace Executions with the OpenAI Agents SDK

When an n8n automation fails, you need the logs now, not after clicking through a dozen UI screens. Your agent can pull the history for any workflow with `list_workflow_executions`. Find the failure, get the run ID. Then, hand that ID to `get_execution_details`. Your agent gets the full trace, including input data and error messages, right in your OpenAI dashboard. It's how you debug complex agent-triggered automations without losing your mind.

Secure Your Credentials

Hard-coded keys are a disaster waiting to happen. Use `list_stored_credentials` to have your agent audit every credential saved in n8n. It doesn't get the secret, just the metadata—who created it, when it was last updated, and what it's for. This lets you build automated security checks with your MCP Server. Your agent can flag old keys, identify credentials used in non-compliant workflows, and enforce security policies across your entire n8n setup.

Setup guide

Set up n8n (AI Workflow Automation) MCP in OpenAI Agents SDK

Prerequisites

Python 3.10+ installed
openai-agents package (pip install openai-agents)
Active Vinkius subscription with a valid endpoint token

1

Install the SDK

Run pip install openai-agents to install the OpenAI Agents SDK. The MCP integration is built-in — no extra dependencies needed.
2

Connect via SSE transport

Use MCPServerSse with your Vinkius endpoint URL. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. The SDK auto-discovers all n8n (AI Workflow Automation) tools at runtime.
3

Create your Agent

Pass the MCP to Agent(mcp_servers=[server]). The agent receives n8n (AI Workflow Automation) tools as native definitions — JSON schemas resolve automatically.
4

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate n8n (AI Workflow Automation) tools and returns structured results. Copy the full example on the right to get started.

agent.py

import asyncio
from agents import Agent, Runner
from agents.mcp import MCPServerSse

async def main():
    async with MCPServerSse(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ) as server:
        agent = Agent(
            name="n8n (AI Workflow Automation) Agent",
            instructions="You have access to n8n (AI Workflow Automation) tools.",
            mcp_servers=[server],
        )
        result = await Runner.run(agent, "List recent transactions")
        print(result.final_output)

asyncio.run(main())

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by n8n. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect n8n (AI Workflow Automation) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about n8n (AI Workflow Automation) MCP in OpenAI Agents SDK

Your agent uses `list_workflows` to get a full list, then can filter them by name or use `list_workflow_tags` to find workflows grouped by project or function. It’s a direct way to target the exact automation you need to inspect.

No, and that's the point. The tool only returns metadata like the credential's name, type, and creation date. It's for auditing, not for accessing secrets.

First, call `list_workflow_executions` to find the failed run and get its ID. Then, feed that ID into `get_execution_details`. Your agent gets the complete execution trace to pinpoint the exact point of failure.

Yes. The `list_instance_users` tool gives your agent a list of all users on the n8n instance. You can use this to automate security checks for off-boarding or to audit who has access to sensitive workflows.

The `list_stored_credentials` tool is designed for security, exposing only metadata and never the secrets themselves. Vinkius also runs each MCP server in an ephemeral, zero-trust sandbox, so your connection is isolated and secure.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript