# Duda MCP MCP

> Duda manages your entire agency website portfolio through one connection. This MCP lets you check site statuses, track templates, audit client accounts, and monitor dynamic data collections for every Duda-built website—all using plain conversation with your agent.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** website-builder, template-management, client-accounts, dynamic-data, web-publishing, agency-tools

## Description

Running an agency means juggling dozens of websites. You need to know if a client's site is live, what template it used, or who actually has permission to update the blog. This MCP connects all that data for you. Instead of logging into multiple dashboards and clicking through status pages just to get an overview, your agent talks directly to Duda’s backend. You can ask simple questions like, 'Which sites are published but haven't been checked in three weeks?' or 'Show me the full profile for Alice Miller.' If you're managing many client accounts, this single connection through Vinkius gives your AI client a complete picture of your entire digital footprint. It turns complex site management into simple conversation.

## Tools

### search_sites_by_domain
Searches for any Duda website using a provided domain name or keyword search term.

### get_template_details
Retrieves full details about a specified Duda template, including structural identifiers.

### list_client_accounts
Lists every client account registered within your entire Duda organization.

### list_site_collections
Lists all dynamic data collections attached to a particular site for content review.

### list_published_websites
Identifies and lists only the sites that are currently marked as 'Published' and live.

### list_duda_sites
Generates a complete list of all websites configured in your Duda account, regardless of status.

### list_site_templates
Provides a comprehensive list of every available Duda website template in your library.

### get_client_account_profile
Retrieves the full profile and specific permission data for any listed client account.

### quick_site_health_audit
Pulls together a high-level summary of site activity, including publishing rates and key metrics.

### get_site_details
Gets detailed configuration settings and operational information for one specific Duda website.

## Prompt Examples

**Prompt:** 
```
List all my published Duda sites.
```

**Response:** 
```
I've found 12 published sites, including 'Main Corporate Site' (corporate.com) and 'E-commerce Shop' (shop.com). Would you like to see the creation date for any of these?
```

**Prompt:** 
```
Show me the details for site 'site_12345'.
```

**Response:** 
```
Site 'site_12345' (Name: Tech Project) is currently 'PUBLISHED'. It is using the 'Modern Agency' template and has 2 dynamic collections. Should I list the collections for this site?
```

**Prompt:** 
```
Which client accounts have permission to 'Manage Blog'?
```

**Response:** 
```
In your organization, 3 client accounts have 'Manage Blog' permissions: 'John Doe', 'Alice Miller', and 'Marketing Team A'. Would you like to see the full profile for John Doe?
```

## Capabilities

### Check Site Publishing Status
Retrieve real-time details and publishing statuses for all Duda websites in your account.

### Audit Client Permissions
List all client accounts in your organization and check specific user permissions or profile data.

### Track Website Templates
Access the Duda template library to get details on available designs and structural types.

### Discover and Search Sites
List all configured websites or search for a site using its domain name or keyword.

### Monitor Site Data Structures
Review dynamic data collections associated with specific sites to ensure content is properly organized.

## Use Cases

### The Quarterly Client Audit
An agency owner needs to audit 45 client sites. Instead of running a batch report manually, they prompt their agent: 'Give me the status and template ID for all my published sites.' The agent uses `list_published_websites` and then loops through each one using `get_site_details`, delivering a single summary table.

### Onboarding a New Employee
The ops manager needs to confirm which accounts can access the marketing blog. They prompt: 'Which client accounts have permission for Blog Management?' The agent uses `list_client_accounts` and filters the results using specific profile checks, instantly identifying only the correct users.

### Debugging a Broken Site
A developer hears that site 'techcorp.com' is failing to load content. They prompt: 'What are the dynamic collections for techcorp.com?' The agent uses `search_sites_by_domain` first, then runs `list_site_collections`, showing the exact data sources needed for debugging.

### Pre-Launch Review
Before a major launch, you need to confirm every required template is available. You ask: 'Show me all current templates and list any that are flagged as deprecated.' The agent uses `list_site_templates` for the full catalog.

## Benefits

- Stop manually checking status dashboards. You can ask your agent to use `list_published_websites` or `quick_site_health_audit` to get an immediate overview of the entire site fleet.
- Never lose track of who has access. Use `list_client_accounts` and then `get_client_account_profile` to audit every user's permissions across your organization in seconds.
- Templates are easy to reference, too. You can use `list_site_templates` or `get_template_details` to confirm which design structure was used on a specific client site.
- You gain full visibility into content architecture. By using `list_site_collections`, you instantly see what dynamic data is attached to any given website, making audits simple.
- Need to find a site quickly? Use `search_sites_by_domain` with just the domain name, and your agent finds it without needing internal IDs.

## How It Works

The bottom line is: you talk to your AI client, it talks to Duda, and you get structured data without leaving your chat window.

1. Connect the Duda integration in Vinkius and authenticate using your API credentials.
2. Your agent receives permission to read site, client, and template data from your Duda account.
3. Ask a natural language question—like 'List my top five published sites'—and get the specific details back immediately.

## Frequently Asked Questions

**How do I check if my site is live using list_published_websites?**
You prompt your agent with 'List all published sites.' The tool uses `list_published_websites` to give you a clean, current list of every active domain in your account.

**What is the difference between list_duda_sites and search_sites_by_domain?**
`list_duda_sites` gives you an exhaustive list of everything configured. Use `search_sites_by_domain` when you only know a piece of information, like a domain name, and need to find one specific site quickly.

**Can I see the permissions for John Doe using get_client_account_profile?**
Yes. Running `get_client_account_profile` allows you to retrieve all profile data and granular permission levels for any specified client account, confirming their exact access.

**How do I see what templates are available using list_site_templates?**
You ask your agent to run `list_site_templates`. This tool pulls the entire library of Duda designs and structures into a readable list for review.

**I need deep configuration data for a specific site; should I use `get_site_details` or `list_duda_sites`?**
Use `get_site_details`. This tool retrieves the full, detailed settings and metadata for one particular Duda site. While `list_duda_sites` just gives you a list of configured domains, `get_site_details` gives you everything—the structural info, key settings, etc.

**How do I check which dynamic data collections are linked to a specific site using `list_site_collections`?**
The tool lists all associated dynamic data collections for a given site. This is critical for content management because it shows you the sources of structured, editable content attached to that domain.

**I manage many client accounts; can I use `list_client_accounts` to filter by specific permissions?**
Yes, while `list_client_accounts` lists all registered clients, you pass filtering criteria in the request. This lets your agent narrow down the list and show only users who possess certain roles or access levels.

**I need a quick overview of my whole portfolio; what does the `quick_site_health_audit` tool provide?**
The audit gives you a high-level summary of site activity and publishing rates across your entire Duda account. It's an instant way to check overall performance without having to list every single domain individually.

**How do I get Duda API credentials?**
Log in to your Duda account, navigate to the **Developer Portal**, and you can generate your unique API Username and API Password from the **API Credentials** section.

**Can the agent publish my sites?**
This integration currently focuses on listing and auditing sites, templates, and accounts. Triggering a live publication should be managed via the Duda editor or your custom dashboard.

**Does the integration support white-label settings?**
Yes, you can use the get_site_details or get_client_account_profile tools to retrieve information about your white-labeled sites and client configurations.