How to Use the Duda MCP in OpenAI Agents SDK

Q: How do I connect my Duda sites to the OpenAI Agents SDK using MCP?

You register the Duda server using MCPServerStreamableHttp within your OpenAI python script. The OpenAI Agents SDK then auto-discovers Duda tools like listdudasites immediately.

Q: Can the OpenAI Agents SDK filter Duda sites by domain?

Yes, your OpenAI agent calls the Duda searchsitesbydomain tool to locate specific layouts. This keeps your OpenAI agent focused on the correct Duda domain.

Q: How does OpenAI Agents SDK handle Duda site collections?

The OpenAI agent runs listsitecollections to extract Duda dynamic database schemas. These Duda schemas are then mapped directly to the OpenAI agent's memory.

Q: How does the OpenAI Agents SDK list published Duda sites?

The OpenAI agent executes the listpublishedwebsites tool to identify active Duda URLs. This filters out draft Duda sites from the OpenAI monitoring loop.

Build production-grade OpenAI Agents SDK systems that query, audit, and manage your Duda sites with built-in guardrails.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Duda MCP to OpenAI Agents SDK

Create your Vinkius account to connect Duda 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 Duda with OpenAI Agents SDK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Duda site audits via OpenAI Agents SDK

Your OpenAI Agents SDK python agent runs `quick_site_health_audit` to find inactive Duda sites. This prevents your OpenAI agent from querying stale Duda pages. When the OpenAI agent identifies a problem, it uses `get_site_details` to pull Duda configuration logs. The OpenAI tracing dashboard records this MCP Server action for strict debugging.

Manage Duda client accounts with safe OpenAI handoffs

The OpenAI Agents SDK routes complex Duda client requests to a specialized account agent. This specialized OpenAI agent runs `list_client_accounts` to find matching Duda profiles. OpenAI guardrails prevent the agent from changing Duda permissions via `get_client_account_profile` without authorization. This ensures your OpenAI workflows never corrupt Duda user databases.

Dynamic Duda template matching with OpenAI

This MCP Server lets your OpenAI agent inspect Duda layout structures instantly. Your OpenAI python code feeds `list_site_templates` output directly into the agent's context. When a customer requests a design, the OpenAI agent evaluates Duda layouts via `get_template_details`. This allows the OpenAI agent to select the correct Duda design.

Setup guide

Set up Duda 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 Duda tools at runtime.
3

Create your Agent

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

Run the agent

Call Runner.run(agent, prompt) to execute. The agent invokes the appropriate Duda 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="Duda Agent",
            instructions="You have access to Duda 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 Duda. 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 Duda 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 Duda MCP in OpenAI Agents SDK

You register the Duda server using `MCPServerStreamableHttp` within your OpenAI python script. The OpenAI Agents SDK then auto-discovers Duda tools like `list_duda_sites` immediately.

Yes, your OpenAI agent calls the Duda `search_sites_by_domain` tool to locate specific layouts. This keeps your OpenAI agent focused on the correct Duda domain.

The OpenAI agent runs `list_site_collections` to extract Duda dynamic database schemas. These Duda schemas are then mapped directly to the OpenAI agent's memory.

The OpenAI agent executes the `list_published_websites` tool to identify active Duda URLs. This filters out draft Duda sites from the OpenAI monitoring loop.

All Duda client account profiles are processed in memory inside an ephemeral V8 sandbox before reaching OpenAI. No Duda credentials or profile data are ever stored on Vinkius servers.

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