Domain MCP

Instructions

Implementation Reference

• src/register.ts:36-63 (handler)

  Registration and handler function for the dynadot_folder tool. The server.registerTool call registers the tool by name and defines the inline async handler that processes the input (action + params), looks up the action definition from schema, transforms parameters, executes the corresponding Dynadot API command via client.execute, and returns the JSON response.
  server.registerTool( tool.name, { description: tool.description, inputSchema, }, async (input) => { const action = input.action as string; const actionDef = tool.actions[action]; if (!actionDef) { throw new Error(`Unknown action: ${action}. Valid actions: ${actionKeys.join(', ')}`); } const client = getClient(); const params = actionDef.transform ? actionDef.transform(action, input as Record<string, unknown>) : (input as ApiParams); // Remove 'action' from params sent to API delete params.action; const result = await client.execute(actionDef.command, params); return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], }; } );
• src/schema.ts:747-872 (schema)

  Input schema and action definitions for dynadot_folder tool, mapping user actions (e.g., list, create, delete, set_whois) to Dynadot API commands (e.g., folder_list, create_folder, set_folder_whois) with parameter schemas and transform functions.
  { name: 'dynadot_folder', description: 'Folder management: create, delete, list, configure folder-level settings', actions: { list: { command: 'folder_list', description: 'List all folders', }, create: { command: 'create_folder', description: 'Create new folder', params: z.object({ folderName: p.name }), transform: (_, input) => ({ folder_name: input.folderName as string }), }, delete: { command: 'delete_folder', description: 'Delete folder', params: z.object({ folderId: p.folderId }), transform: (_, input) => tx.folderId(input), }, rename: { command: 'set_folder_name', description: 'Rename folder', params: z.object({ folderId: p.folderId, folderName: p.name }), transform: (_, input) => ({ folder_id: input.folderId as string, folder_name: input.folderName as string, }), }, set_whois: { command: 'set_folder_whois', description: 'Set WHOIS for all domains in folder', params: z.object({ folderId: p.folderId, contactId: p.contactId }), transform: (_, input) => ({ folder_id: input.folderId as string, contact_id: input.contactId as string, }), }, set_ns: { command: 'set_folder_ns', description: 'Set nameservers for folder', params: z.object({ folderId: p.folderId, nameservers: p.nameservers }), transform: (_, input) => tx.folderNs(input), }, set_parking: { command: 'set_folder_parking', description: 'Enable parking for folder', params: z.object({ folderId: p.folderId }), transform: (_, input) => tx.folderId(input), }, set_forwarding: { command: 'set_folder_forwarding', description: 'Set forwarding for folder', params: z.object({ folderId: p.folderId, forwardUrl: p.url }), transform: (_, input) => ({ folder_id: input.folderId as string, forward_url: input.forwardUrl as string, }), }, set_stealth: { command: 'set_folder_stealth', description: 'Set stealth forwarding for folder', params: z.object({ folderId: p.folderId, stealthUrl: p.url }), transform: (_, input) => ({ folder_id: input.folderId as string, stealth_url: input.stealthUrl as string, }), }, set_hosting: { command: 'set_folder_hosting', description: 'Set hosting for folder', params: z.object({ folderId: p.folderId, options: z.record(z.string(), z.string()) }), transform: (_, input) => { const params: ApiParams = { folder_id: input.folderId as string }; for (const [k, v] of Object.entries(input.options as Record<string, string>)) { params[k] = v; } return params; }, }, set_dns: { command: 'set_folder_dns', description: 'Set DNS for folder', params: z.object({ folderId: p.folderId, mainRecords: z.array(dnsRecord).optional(), subdomainRecords: z.array(subdomainRecord).optional(), }), transform: (_, input) => tx.folderDns(input), }, set_dns2: { command: 'set_folder_dns2', description: 'Set DNS2 for folder', params: z.object({ folderId: p.folderId, mainRecords: z.array(dnsRecord).optional(), subdomainRecords: z.array(subdomainRecord).optional(), }), transform: (_, input) => tx.folderDns(input), }, set_email_forward: { command: 'set_folder_email_forward', description: 'Set email forwarding for folder', params: z.object({ folderId: p.folderId, email: p.email }), transform: (_, input) => ({ folder_id: input.folderId as string, email: input.email as string, }), }, set_renew_option: { command: 'set_folder_renew_option', description: 'Set renewal option for folder', params: z.object({ folderId: p.folderId, renewOption: p.renewOption }), transform: (_, input) => ({ folder_id: input.folderId as string, renew_option: input.renewOption as string, }), }, clear_settings: { command: 'set_clear_folder_setting', description: 'Clear all folder settings', params: z.object({ folderId: p.folderId }), transform: (_, input) => tx.folderId(input), }, }, },
• src/register.ts:6-65 (registration)

  registerAllTools function that loops over all composite tools from schema.ts (including dynadot_folder) and calls server.registerTool for each.
  export function registerAllTools(server: McpServer): void { for (const tool of compositeTools) { // Build action enum from keys const actionKeys = Object.keys(tool.actions) as [string, ...string[]]; // Build combined input schema with action + all possible params const actionDescriptions = actionKeys .map((k) => { const actionDef = tool.actions[k]; return actionDef ? `${k}: ${actionDef.description}` : k; }) .join(' | '); const inputSchema: Record<string, z.ZodTypeAny> = { action: z.enum(actionKeys).describe(`Action to perform: ${actionDescriptions}`), }; // Collect all unique params across actions for (const action of Object.values(tool.actions)) { if (action?.params) { const shape = action.params.shape; for (const [key, schema] of Object.entries(shape)) { if (!inputSchema[key]) { // Make optional since not all actions need all params inputSchema[key] = (schema as z.ZodTypeAny).optional(); } } } } server.registerTool( tool.name, { description: tool.description, inputSchema, }, async (input) => { const action = input.action as string; const actionDef = tool.actions[action]; if (!actionDef) { throw new Error(`Unknown action: ${action}. Valid actions: ${actionKeys.join(', ')}`); } const client = getClient(); const params = actionDef.transform ? actionDef.transform(action, input as Record<string, unknown>) : (input as ApiParams); // Remove 'action' from params sent to API delete params.action; const result = await client.execute(actionDef.command, params); return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], }; } ); } }
• src/client.ts:116-134 (helper)

  DynadotClient.execute method: formats parameters, authenticates with API key, sends GET request to Dynadot API endpoint for the specified command (e.g., folder_list), parses JSON response, and throws on error status.
  async execute(command: string, params: ApiParams = {}): Promise<ApiResponse> { const searchParams = new URLSearchParams(); searchParams.set('key', this.apiKey); searchParams.set('command', command); for (const [key, value] of Object.entries(params)) { if (value !== undefined) { searchParams.set(key, String(value)); } } const response = await this.client.get('api3.json', { searchParams }).json<ApiResponse>(); if (response.Status === 'error') { throw new Error(`Dynadot API error: ${response.Error || 'Unknown error'}`); } return response; }