MCP Cloudflare DNS Server

Instructions

Implementation Reference

• src/index.ts:357-378 (handler)

  The primary handler function for the 'delete_dns_record' tool in the MCP server. It checks configuration, calls the Cloudflare API via CloudflareApi.deleteDnsRecord, handles errors, and returns a formatted response.

  const handleDeleteDnsRecord = async (args: { recordId: string }) => {
    try {
      if (!configureApiIfNeeded()) {
        return {
          content: [{ type: "text", text: "❌ Configuration incomplete. Please configure Cloudflare API Token and Zone ID first." }],
        };
      }
      
      await CloudflareApi.deleteDnsRecord(args.recordId);
      
      return {
        content: [{ 
          type: "text", 
          text: `✅ DNS record deleted successfully! (ID: ${args.recordId})`
        }],
      };
    } catch (error) {
      return {
        content: [{ type: "text", text: `❌ Error deleting DNS record: ${error instanceof Error ? error.message : 'Unknown error'}` }],
      };
    }
  };

• src/api.ts:186-193 (helper)

  Core helper function that performs the actual HTTP DELETE request to Cloudflare's API to delete the DNS record by ID, including response validation.

  deleteDnsRecord: async (recordId: string): Promise<void> => {
    const response = await api(`dns_records/${recordId}`, 'DELETE');
    const data = CloudflareApiResponse.parse(await response.json());
    
    if (!data.success) {
      throw new Error(`API Error: ${data.errors.map(e => e.message).join(', ')}`);
    }
  },

• src/index.ts:157-170 (registration)

  Registration of the 'delete_dns_record' tool in the MCP server's listTools response, including name, description, and input schema.

  {
    name: "delete_dns_record",
    description: "Delete a DNS record",
    inputSchema: {
      type: "object",
      properties: {
        recordId: {
          type: "string",
          description: "The DNS record ID to delete",
        },
      },
      required: ["recordId"],
    },
  },

• src/index.ts:195-197 (registration)

  Dispatch logic in the MCP CallToolRequestHandler that routes calls to 'delete_dns_record' to the appropriate handler function.

  if (name === "delete_dns_record") {
    return await handleDeleteDnsRecord(args as { recordId: string });
  }

• src/api.ts:188-193 (schema)

  Response validation using CloudflareApiResponse schema after the DELETE API call.

    const data = CloudflareApiResponse.parse(await response.json());
    
    if (!data.success) {
      throw new Error(`API Error: ${data.errors.map(e => e.message).join(', ')}`);
    }
  },