How to Use the Duda MCP in Mastra AI

Q: How do I automate Duda site checks in Mastra AI?

You create a workflow in Mastra AI that includes the quicksitehealthaudit tool. Set up a trigger to run the audit on a schedule, and the agent will handle the status checks for your sites. You can then define branching logic based on the audit results.

Q: How do I filter Duda sites in a Mastra AI workflow?

Use searchsitesbydomain or listdudasites as the first step in your agent workflow. You can then pass the output to a filter step to isolate the specific sites you want to manage. The agent handles the data transformation.

Build reliable, multi-step maintenance workflows for Duda using Mastra AI agent frameworks.

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 Mastra AI

Create your Vinkius account to connect Duda to Mastra AI 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 Mastra AI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automated site health workflows in Mastra AI

Create agent workflows that chain site discovery with health checks. You can script a sequence where `list_published_websites` feeds into `quick_site_health_audit` to monitor your entire portfolio automatically. If the agent finds a site with issues, you can branch the workflow to alert your team. It keeps your operations running without manual oversight.

Complex site management with Mastra AI

Define agent agents that handle site updates and template tracking. By using `get_site_details` and `get_template_details`, your agents can compare current site versions against your master templates. It allows you to build logic for site consistency across hundreds of accounts. The agent manages the state and handles any retries if the API is busy.

Conditional client account handling

Build agents that verify account permissions before taking action. Use `list_client_accounts` to scope your operations and `get_client_account_profile` to confirm that an account has the right access level. This adds a layer of safety to your automated tasks. Your agents will only act on accounts that pass your programmed logic.

Setup guide

Set up Duda MCP in Mastra AI

Prerequisites

Node.js 18+ and a TypeScript project
@mastra/mcp + @mastra/core packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run npm install @mastra/mcp @mastra/core plus your preferred model provider (e.g. @ai-sdk/openai).
2

Configure the MCPClient
Create an MCPClient with your Vinkius endpoint as a URL object. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Discover and inject tools
Call mcpClient.listTools() and spread the result into your agent's tools object. All Duda tools become native Mastra tools.
4

Run with any model
Swap openai("gpt-4o") for any AI SDK-compatible provider. Call agent.generate() and the agent routes tool calls through MCP automatically.

agent.ts

import { MCPClient } from "@mastra/mcp";
import { Agent } from "@mastra/core/agent";
import { openai } from "@ai-sdk/openai";

const mcpClient = new MCPClient({
  id: "duda-mcp-client",
  servers: {
    "duda-mcp": {
      url: new URL(
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
      ),
    },
  },
});

const agent = new Agent({
  name: "Duda Agent",
  model: openai("gpt-4o"),
  instructions: "You have access to Duda tools.",
  tools: {
    ...(await mcpClient.listTools()),
  },
});

const result = await agent.generate(
  "List recent Duda transactions"
);
console.log(result.text);

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 Mastra AI

You create a workflow in Mastra AI that includes the `quick_site_health_audit` tool. Set up a trigger to run the audit on a schedule, and the agent will handle the status checks for your sites. You can then define branching logic based on the audit results.

Mastra AI includes a built-in workflow engine that manages retries and backoff. If a Duda API call fails, the agent automatically retries based on your defined policy. This ensures your site management tasks complete even during transient network issues.

All site data and client account details remain within your controlled environment. The MCP Server acts as a bridge, and Mastra AI processes the information locally within your infrastructure. No external party sees your sensitive account configurations.

Yes, you simply add the server to your agent's configuration. Once connected, your agents can call any of the ten tools, including `list_site_collections`, to manage your data. It is a direct, typed integration.

Use `search_sites_by_domain` or `list_duda_sites` as the first step in your agent workflow. You can then pass the output to a filter step to isolate the specific sites you want to manage. The agent handles the data transformation.

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