dynadot-mcp

Instructions

Implementation Reference

• src/tools/folder.ts:103-148 (handler)

  The implementation and registration of the 'set_folder_settings' MCP tool, which applies various domain folder settings via the Dynadot API.

  server.tool(
    "set_folder_settings",
    "Apply default settings to a folder. All domains in the folder will " +
      "inherit these settings. Supports nameservers, DNS, forwarding, " +
      "parking, stealth, and renewal options. Pass the appropriate " +
      "Dynadot API parameters for the setting type.",
    {
      folder_id: z.string().describe("Folder ID to configure"),
      setting_type: z
        .enum(["whois", "ns", "dns", "dns2", "forwarding", "stealth", "parking", "hosting", "email_forward", "renew_option", "clear"])
        .describe(
          "Type of setting to apply: 'whois' (WHOIS contacts), 'ns' (nameservers), " +
            "'dns' (basic DNS), 'dns2' (advanced DNS records), 'forwarding', 'stealth', " +
            "'parking', 'hosting', 'email_forward', 'renew_option', or 'clear' (remove settings)"
        ),
      params: z
        .record(z.string())
        .optional()
        .describe("Setting parameters as key-value pairs (varies by setting type)"),
    },
    async ({ folder_id, setting_type, params }) => {
      try {
        const command =
          setting_type === "clear"
            ? "set_clear_folder_setting"
            : `set_folder_${setting_type}`;
        const result = await client.call(command, {
          folder_id,
          ...(params || {}),
        });
        return {
          content: [
            { type: "text" as const, text: JSON.stringify(result, null, 2) },
          ],
        };
      } catch (error) {
        const msg = error instanceof Error ? error.message : String(error);
        return {
          content: [
            { type: "text" as const, text: `Failed to set folder settings: ${msg}` },
          ],
          isError: true,
        };
      }
    }
  );