Setup

Available Tools

The MCP server exposes 84 tools organized into five categories.

DNS

Web Redirect

Domain

Email

Monitor

Usage Examples

Once configured, you can interact with Dynu through natural language. Here are some things you can ask your AI assistant:

Check on DNS status

"Show me all my DNS services and their current status."

"How many of my domains have TXT records?"

"Do any of my domains have wildcard aliases?"

"What is the TTL on the MX record for example.dynu.com?"Prompts

Manage DNS records

"Add a TXT record with value 'v=spf1 include:example.com ~all' to my domain example.dynu.com."

"Update the A record for home.example.com to point to 203.0.113.10."

"Delete the CNAME record for old.example.com."

"Disable the MX record for mail.example.dynu.com temporarily."

"Enable DNSSEC for my domain example.com."Prompts

Manage web redirects

"List all web redirects for DNS service 12345."

"Create a redirect on service 12345 that sends visitors to https://www.mysite.com."

"Change the redirect on service 12345 to use a cloaked redirect instead."Prompts

Manage registered domains

"List all my registered domains and show which ones expire soon."

"Enable auto-renewal for domain ID 67890."

"Lock domain 67890 to prevent unauthorized transfers."

"Add ns2.example.com as a nameserver to domain 67890."Prompts

Manage email services

"List all my email services."

"Create an email account 'john' with a password on email service 11111."

"Add an alias that forwards info@example.com to john@example.com."

"Show me the delivery queue for email service 11111."

"Add nospam@badactor.com to the blacklist for service 11111."Prompts

Monitor uptime

"List all my uptime monitors."

"Create an HTTP monitor for https://www.example.com that checks every 60 seconds."

"Pause monitor 99 while I do maintenance."

"Resume monitor 99."

"How many monitors do I have and what is my limit?"Prompts

Testing with cURL

You can test the MCP endpoint directly with cURL to verify your API key works.

Initialize

curl -X POST https://api.dynu.com/mcp   -H "Authorization: YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2025-03-26",
      "capabilities": {},
      "clientInfo": {"name": "curl", "version": "1.0"}
    }
  }'

List tools

curl -X POST https://api.dynu.com/mcp   -H "Authorization: YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"jsonrpc":"2.0","id":2,"method":"tools/list"}'

Call a tool

curl -X POST https://api.dynu.com/mcp   -H "Authorization: YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{
    "jsonrpc": "2.0",
    "id": 3,
    "method": "tools/call",
    "params": {
      "name": "dns_list",
      "arguments": {}
    }
  }'

Tool Reference

DNS

dns_list
Returns all DNS services for the account.
No parameters.

dns_get
Returns full details for a single DNS service.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.

dns_create
Creates a new DNS service (hostname).

Parameter	Type	Required	Description
hostname	string	Yes	Hostname to create (e.g. home.example.com).
ipv4Address	string	No	IPv4 address to assign.
ipv6Address	string	No	IPv6 address to assign.

dns_update
Updates a DNS service's IP address or TTL.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.
ipv4Address	string	No	New IPv4 address.
ipv6Address	string	No	New IPv6 address.
ttl	integer	No	TTL in seconds.

dns_delete
Permanently deletes a DNS service.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.

dns_record_list
Lists all DNS records for a service.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.

dns_record_get
Returns details of a specific DNS record.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.
recordId	integer	Yes	DNS record ID.

dns_record_create
Adds a new DNS record to a service.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.
recordType	string	Yes	Record type: A, AAAA, MX, CNAME, TXT, NS, SRV, CAA, etc.
nodeName	string	No	Subdomain or @ for root.
content	string	No	Record value — IP, hostname, or text depending on type.
ttl	integer	No	TTL in seconds.
priority	integer	No	Priority (MX/SRV records only).
state	boolean	No	Enable the record (default: true).

dns_record_update
Updates an existing DNS record.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.
recordId	integer	Yes	DNS record ID.
nodeName	string	No	Subdomain or @ for root.
content	string	No	New record value.
ttl	integer	No	TTL in seconds.
priority	integer	No	Priority (MX/SRV records only).
state	boolean	No	Enable or disable the record.

dns_record_delete / dns_record_enable / dns_record_disable

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.
recordId	integer	Yes	DNS record ID.

dns_limit
Returns global DNS limits for the account.
No parameters.

dns_service_limit
Returns DNS record limits for a specific service.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.

dns_toplevel
Lists available top-level domains filtered by the account's membership level.
No parameters.

dns_getroot
Resolves the root (apex) domain for any hostname.

Parameter	Type	Required	Description
hostname	string	Yes	Hostname to resolve (e.g. sub.example.com).

dns_record_query
Queries a specific DNS record type for a hostname.

Parameter	Type	Required	Description
hostname	string	Yes	Hostname to query.
recordType	string	Yes	Record type: A, AAAA, MX, CNAME, TXT, etc.

dns_ipupdatehistory
Returns the IP update history for the account (requires membership).
No parameters.

dns_dnssec_get / dns_dnssec_enable / dns_dnssec_disable
Get, enable, or disable DNSSEC for a DNS service (premium domains only).

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.

dns_group_list
Lists DNS groups / access controls for a service.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.

dns_group_create
Creates a DNS group for a service.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.
name	string	Yes	Group name.

dns_group_update
Updates a DNS group name.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.
groupId	integer	Yes	Group ID.
name	string	No	New group name.

dns_group_delete
Deletes a DNS group.

Parameter	Type	Required	Description
groupId	integer	Yes	Group ID.

Web Redirect

webredirect_list
Lists all web redirects for a DNS service.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.

webredirect_get
Returns details of a specific web redirect.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.
webredirectId	integer	Yes	Web redirect ID.

webredirect_create
Creates a web redirect for a DNS service.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.
url	string	Yes	Destination URL.
redirectType	string	No	Redirect type: redirect, cloakedredirect, or iframe.

webredirect_update
Updates a web redirect.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.
webredirectId	integer	Yes	Web redirect ID.
url	string	No	New destination URL.
redirectType	string	No	Redirect type: redirect, cloakedredirect, or iframe.

webredirect_delete
Deletes a web redirect.

Parameter	Type	Required	Description
id	integer	Yes	DNS service ID.
webredirectId	integer	Yes	Web redirect ID.

Domain

domain_list
Returns all registered domains for the account.
No parameters.

domain_get
Returns details of a specific registered domain.

Parameter	Type	Required	Description
id	integer	Yes	Domain ID.

domain_autorenewenable / domain_autorenewdisable
Enable or disable automatic renewal for a domain.

Parameter	Type	Required	Description
id	integer	Yes	Domain ID.

domain_lock / domain_unlock
Lock or unlock a domain to prevent or permit transfers.

Parameter	Type	Required	Description
id	integer	Yes	Domain ID.

domain_cancel
Cancels a domain service.

Parameter	Type	Required	Description
id	integer	Yes	Domain ID.

domain_nameserver_list
Lists nameservers for a domain.

Parameter	Type	Required	Description
id	integer	Yes	Domain ID.

domain_nameserver_add
Adds a nameserver to a domain.

Parameter	Type	Required	Description
id	integer	Yes	Domain ID.
nameserver	string	Yes	Nameserver hostname to add.

domain_nameserver_primary
Sets the primary nameserver for a domain.

Parameter	Type	Required	Description
id	integer	Yes	Domain ID.
nameserver	string	Yes	Nameserver hostname to set as primary.

domain_nameserver_delete
Removes a nameserver from a domain.

Parameter	Type	Required	Description
id	integer	Yes	Domain ID.
nameserver	string	Yes	Nameserver hostname to remove.

Email

email_list
Returns all email services for the account.
No parameters.

email_get
Returns details of a specific email service.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.

email_update
Updates email service settings.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.

email_account_list
Lists all email accounts for a service.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.

email_account_get
Returns details of a specific email account.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
accountId	integer	Yes	Account ID.

email_account_create
Creates a new email account.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
username	string	Yes	Account username.
password	string	Yes	Account password.
forwardTo	string	No	Forward-to address.

email_account_update
Updates an email account's password or forwarding address.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
accountId	integer	Yes	Account ID.
password	string	No	New password.
forwardTo	string	No	New forward-to address.

email_account_delete
Deletes an email account.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
accountId	integer	Yes	Account ID.

email_alias_list
Lists all email aliases for a service.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.

email_alias_get
Returns details of a specific email alias.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
aliasId	integer	Yes	Alias ID.

email_alias_create
Creates an email alias.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
alias	string	Yes	Alias address (e.g. info@example.com).
forwardTo	string	Yes	Forward-to address.

email_alias_update
Updates an email alias.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
aliasId	integer	Yes	Alias ID.
alias	string	No	New alias address.
forwardTo	string	No	New forward-to address.

email_alias_delete
Deletes an email alias.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
aliasId	integer	Yes	Alias ID.

email_distributionlist_list
Lists all distribution lists for a service.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.

email_distributionlist_get
Returns details of a specific distribution list.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
distributionlistId	integer	Yes	Distribution list ID.

email_distributionlist_create
Creates a distribution list.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
name	string	Yes	Distribution list name.
address	string	Yes	List email address.

email_distributionlist_update
Updates a distribution list.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
distributionlistId	integer	Yes	Distribution list ID.
name	string	No	New list name.

email_distributionlist_delete
Deletes a distribution list.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
distributionlistId	integer	Yes	Distribution list ID.

email_distributionlist_recipient_list
Lists recipients of a distribution list.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
distributionlistId	integer	Yes	Distribution list ID.

email_distributionlist_recipient_create
Adds a recipient to a distribution list.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
distributionlistId	integer	Yes	Distribution list ID.
address	string	Yes	Recipient email address.

email_distributionlist_recipient_delete
Removes a recipient from a distribution list.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
distributionlistId	integer	Yes	Distribution list ID.
recipientId	integer	Yes	Recipient ID.

email_blacklist_list / email_whitelist_list
Lists blacklisted or whitelisted addresses for a service.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.

email_blacklist_get / email_whitelist_get
Returns a specific blacklist or whitelist entry.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
blacklistId / whitelistId	integer	Yes	Entry ID.

email_blacklist_create / email_whitelist_create
Adds an address to the blacklist or whitelist.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
address	string	Yes	Email address to add.

email_blacklist_update / email_whitelist_update
Updates a blacklist or whitelist entry.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
blacklistId / whitelistId	integer	Yes	Entry ID.
address	string	No	New address value.

email_blacklist_delete / email_whitelist_delete
Removes an address from the blacklist or whitelist.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.
blacklistId / whitelistId	integer	Yes	Entry ID.

email_dkim_get
Returns the DKIM configuration for a service.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.

email_dkim_update
Updates the DKIM configuration for a service.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.

email_autogeneratedkim_get
Returns the auto-generated DKIM DNS record for a service.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.

email_dailylimit_get
Returns the daily send limit for a service.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.

email_deliveryqueue_get
Returns the delivery queue status for a service.

Parameter	Type	Required	Description
id	integer	Yes	Email service ID.

Monitor

monitor_list
Returns all uptime monitors for the account.
No parameters.

monitor_get
Returns details of a specific monitor.

Parameter	Type	Required	Description
id	integer	Yes	Monitor ID.

monitor_create
Creates a new uptime monitor.

Parameter	Type	Required	Description
monitorType	string	Yes	Monitor type: DNS, HTTP, KEYWORD, PING, or PORT.
name	string	Yes	Monitor display name.
checkInterval	integer	No	Check interval in seconds.
host	string	No	Hostname or IP (DNS, PING, PORT monitor types).
port	integer	No	Port number (PORT monitor type only).
url	string	No	URL to monitor (HTTP, KEYWORD monitor types).
keyword	string	No	Keyword to look for in the response (KEYWORD monitor type).
keywordExists	boolean	No	True if keyword should exist; false if it should not.

monitor_delete
Permanently deletes a monitor.

Parameter	Type	Required	Description
id	integer	Yes	Monitor ID.

monitor_pause / monitor_unpause
Pause or resume a monitor.

Parameter	Type	Required	Description
id	integer	Yes	Monitor ID.

monitor_limit
Returns monitor limits for the account.
No parameters.

Troubleshooting

401 Unauthorized

• Verify your API key is correct and active in the API Credentials area.
• Make sure the key is passed in the Authorization header (raw key or with Bearer prefix).
• OAuth bearer tokens expire after 8 hours. Re-authenticate to obtain a fresh token.

Corporate membership required

• Most tools require a corporate membership. The initialize, ping, and notifications/initialized protocol methods work without one.
• Upgrade your account at dynu.com/Membership.

OAuth authorization fails (ChatGPT)

• Ensure Developer Mode is enabled in your ChatGPT settings (Pro, Plus, Team, Business, Enterprise, or Edu plans).
• Sign in using your Dynu username or email address and your Dynu account password on the authorization page.
• If the authorization page shows an error, verify your credentials in the Dynu Control Panel.

Tools not showing in your AI client

• Restart the AI client after editing the MCP configuration.
• Verify the URL is exactly https://api.dynu.com/mcp.
• Test the endpoint with a cURL initialize call (see Testing with cURL above) to confirm connectivity and that your API key is accepted.

Protocol or parse errors

• All requests must use Content-Type: application/json.
• The jsonrpc field must be exactly "2.0".
• Tool arguments must match the expected types; passing a string where an integer is required will return a -32602 Invalid params error.

Required parameter missing

• If a required parameter such as id or recordId is absent, the server returns a -32602 Invalid params error with a message identifying the missing field.
• Use dns_list, domain_list, email_list, or monitor_list to discover the IDs of your resources.

API Reference

The MCP server implements the MCP specification (2025-03-26) using Streamable HTTP transport over a single POST /mcp endpoint with JSON-RPC 2.0.

Endpoint
POST https://api.dynu.com/mcp

Authentication
Pass your API key directly in the Authorization header, or use a Bearer token obtained via OAuth 2.1:

API key Authorization: YOUR_API_KEY
OAuth token Authorization: Bearer YOUR_BEARER_TOKEN

OAuth 2.1 Endpoints
Authorize GET https://api.dynu.com/mcp/oauth/authorize
Token POST https://api.dynu.com/mcp/oauth/token
Register POST https://api.dynu.com/mcp/oauth/register

The authorization code flow requires PKCE (S256 or plain). Client credentials flow uses HTTP Basic authentication with your clientId and secret from the API Credentials area. Bearer tokens expire after 8 hours (expires_in: 28800).