domain-search-mcp 1.0.0

package/dist/tools/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Tool Exports.
+ */
+export { searchDomainTool, searchDomainSchema, executeSearchDomain, type SearchDomainInput, } from './search_domain.js';
+export { bulkSearchTool, bulkSearchSchema, executeBulkSearch, type BulkSearchInput, } from './bulk_search.js';
+export { compareRegistrarsTool, compareRegistrarsSchema, executeCompareRegistrars, type CompareRegistrarsInput, } from './compare_registrars.js';
+export { suggestDomainsTool, suggestDomainsSchema, executeSuggestDomains, type SuggestDomainsInput, } from './suggest_domains.js';
+export { tldInfoTool, tldInfoSchema, executeTldInfo, type TldInfoInput, } from './tld_info.js';
+export { checkSocialsTool, checkSocialsSchema, executeCheckSocials, type CheckSocialsInput, } from './check_socials.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,iBAAiB,EACjB,KAAK,eAAe,GACrB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,wBAAwB,EACxB,KAAK,sBAAsB,GAC5B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,mBAAmB,GACzB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,WAAW,EACX,aAAa,EACb,cAAc,EACd,KAAK,YAAY,GAClB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Tool Exports.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeCheckSocials = exports.checkSocialsSchema = exports.checkSocialsTool = exports.executeTldInfo = exports.tldInfoSchema = exports.tldInfoTool = exports.executeSuggestDomains = exports.suggestDomainsSchema = exports.suggestDomainsTool = exports.executeCompareRegistrars = exports.compareRegistrarsSchema = exports.compareRegistrarsTool = exports.executeBulkSearch = exports.bulkSearchSchema = exports.bulkSearchTool = exports.executeSearchDomain = exports.searchDomainSchema = exports.searchDomainTool = void 0;
+var search_domain_js_1 = require("./search_domain.js");
+Object.defineProperty(exports, "searchDomainTool", { enumerable: true, get: function () { return search_domain_js_1.searchDomainTool; } });
+Object.defineProperty(exports, "searchDomainSchema", { enumerable: true, get: function () { return search_domain_js_1.searchDomainSchema; } });
+Object.defineProperty(exports, "executeSearchDomain", { enumerable: true, get: function () { return search_domain_js_1.executeSearchDomain; } });
+var bulk_search_js_1 = require("./bulk_search.js");
+Object.defineProperty(exports, "bulkSearchTool", { enumerable: true, get: function () { return bulk_search_js_1.bulkSearchTool; } });
+Object.defineProperty(exports, "bulkSearchSchema", { enumerable: true, get: function () { return bulk_search_js_1.bulkSearchSchema; } });
+Object.defineProperty(exports, "executeBulkSearch", { enumerable: true, get: function () { return bulk_search_js_1.executeBulkSearch; } });
+var compare_registrars_js_1 = require("./compare_registrars.js");
+Object.defineProperty(exports, "compareRegistrarsTool", { enumerable: true, get: function () { return compare_registrars_js_1.compareRegistrarsTool; } });
+Object.defineProperty(exports, "compareRegistrarsSchema", { enumerable: true, get: function () { return compare_registrars_js_1.compareRegistrarsSchema; } });
+Object.defineProperty(exports, "executeCompareRegistrars", { enumerable: true, get: function () { return compare_registrars_js_1.executeCompareRegistrars; } });
+var suggest_domains_js_1 = require("./suggest_domains.js");
+Object.defineProperty(exports, "suggestDomainsTool", { enumerable: true, get: function () { return suggest_domains_js_1.suggestDomainsTool; } });
+Object.defineProperty(exports, "suggestDomainsSchema", { enumerable: true, get: function () { return suggest_domains_js_1.suggestDomainsSchema; } });
+Object.defineProperty(exports, "executeSuggestDomains", { enumerable: true, get: function () { return suggest_domains_js_1.executeSuggestDomains; } });
+var tld_info_js_1 = require("./tld_info.js");
+Object.defineProperty(exports, "tldInfoTool", { enumerable: true, get: function () { return tld_info_js_1.tldInfoTool; } });
+Object.defineProperty(exports, "tldInfoSchema", { enumerable: true, get: function () { return tld_info_js_1.tldInfoSchema; } });
+Object.defineProperty(exports, "executeTldInfo", { enumerable: true, get: function () { return tld_info_js_1.executeTldInfo; } });
+var check_socials_js_1 = require("./check_socials.js");
+Object.defineProperty(exports, "checkSocialsTool", { enumerable: true, get: function () { return check_socials_js_1.checkSocialsTool; } });
+Object.defineProperty(exports, "checkSocialsSchema", { enumerable: true, get: function () { return check_socials_js_1.checkSocialsSchema; } });
+Object.defineProperty(exports, "executeCheckSocials", { enumerable: true, get: function () { return check_socials_js_1.executeCheckSocials; } });
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uDAK4B;AAJ1B,oHAAA,gBAAgB,OAAA;AAChB,sHAAA,kBAAkB,OAAA;AAClB,uHAAA,mBAAmB,OAAA;AAIrB,mDAK0B;AAJxB,gHAAA,cAAc,OAAA;AACd,kHAAA,gBAAgB,OAAA;AAChB,mHAAA,iBAAiB,OAAA;AAInB,iEAKiC;AAJ/B,8HAAA,qBAAqB,OAAA;AACrB,gIAAA,uBAAuB,OAAA;AACvB,iIAAA,wBAAwB,OAAA;AAI1B,2DAK8B;AAJ5B,wHAAA,kBAAkB,OAAA;AAClB,0HAAA,oBAAoB,OAAA;AACpB,2HAAA,qBAAqB,OAAA;AAIvB,6CAKuB;AAJrB,0GAAA,WAAW,OAAA;AACX,4GAAA,aAAa,OAAA;AACb,6GAAA,cAAc,OAAA;AAIhB,uDAK4B;AAJ1B,oHAAA,gBAAgB,OAAA;AAChB,sHAAA,kBAAkB,OAAA;AAClB,uHAAA,mBAAmB,OAAA"}

package/dist/tools/search_domain.d.ts

@@ -0,0 +1,61 @@
+/**
+ * search_domain Tool - Primary Domain Search.
+ *
+ * This is the main entry point for domain availability checks.
+ * Designed for magic first moment: works with zero configuration.
+ */
+import { z } from 'zod';
+import type { SearchResponse } from '../types.js';
+/**
+ * Input schema for search_domain.
+ */
+export declare const searchDomainSchema: z.ZodObject<{
+    domain_name: z.ZodString;
+    tlds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    registrars: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    domain_name: string;
+    tlds?: string[] | undefined;
+    registrars?: string[] | undefined;
+}, {
+    domain_name: string;
+    tlds?: string[] | undefined;
+    registrars?: string[] | undefined;
+}>;
+export type SearchDomainInput = z.infer<typeof searchDomainSchema>;
+/**
+ * Tool definition for MCP.
+ */
+export declare const searchDomainTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            domain_name: {
+                type: string;
+                description: string;
+            };
+            tlds: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+            registrars: {
+                type: string;
+                items: {
+                    type: string;
+                };
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Execute the search_domain tool.
+ */
+export declare function executeSearchDomain(input: SearchDomainInput): Promise<SearchResponse>;
+//# sourceMappingURL=search_domain.d.ts.map

package/dist/tools/search_domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search_domain.d.ts","sourceRoot":"","sources":["../../src/tools/search_domain.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAoB7B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAEnE;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoC5B,CAAC;AAEF;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,cAAc,CAAC,CAOzB"}

package/dist/tools/search_domain.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * search_domain Tool - Primary Domain Search.
+ *
+ * This is the main entry point for domain availability checks.
+ * Designed for magic first moment: works with zero configuration.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.searchDomainTool = exports.searchDomainSchema = void 0;
+exports.executeSearchDomain = executeSearchDomain;
+const zod_1 = require("zod");
+const domain_search_js_1 = require("../services/domain-search.js");
+const errors_js_1 = require("../utils/errors.js");
+/**
+ * Input schema for search_domain.
+ */
+exports.searchDomainSchema = zod_1.z.object({
+    domain_name: zod_1.z
+        .string()
+        .min(1)
+        .max(63)
+        .describe("The domain name you want to check (e.g., 'vibecoding', 'myapp'). Don't include the extension (.com, .io, etc.)"),
+    tlds: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe("TLD extensions to check (e.g., ['com', 'io', 'dev']). Defaults to ['com', 'io', 'dev'] if not specified."),
+    registrars: zod_1.z
+        .array(zod_1.z.string())
+        .optional()
+        .describe("Optional: specific registrars to check (e.g., ['porkbun', 'namecheap']). Leave empty to auto-select."),
+});
+/**
+ * Tool definition for MCP.
+ */
+exports.searchDomainTool = {
+    name: 'search_domain',
+    description: `Search for domain availability and pricing across multiple TLDs.
+
+Returns:
+- Availability status for each domain
+- Pricing (first year and renewal)
+- Whether WHOIS privacy is included
+- Human-readable insights and next steps
+
+Examples:
+- search_domain("vibecoding") → checks vibecoding.com, .io, .dev
+- search_domain("myapp", ["com", "io"]) → checks specific TLDs`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            domain_name: {
+                type: 'string',
+                description: "The domain name to search (e.g., 'vibecoding'). No extension needed.",
+            },
+            tlds: {
+                type: 'array',
+                items: { type: 'string' },
+                description: "TLD extensions to check (e.g., ['com', 'io', 'dev']). Defaults to ['com', 'io', 'dev'].",
+            },
+            registrars: {
+                type: 'array',
+                items: { type: 'string' },
+                description: "Optional: specific registrars to check. Leave empty to auto-select.",
+            },
+        },
+        required: ['domain_name'],
+    },
+};
+/**
+ * Execute the search_domain tool.
+ */
+async function executeSearchDomain(input) {
+    try {
+        const { domain_name, tlds, registrars } = exports.searchDomainSchema.parse(input);
+        return await (0, domain_search_js_1.searchDomain)(domain_name, tlds, registrars);
+    }
+    catch (error) {
+        throw (0, errors_js_1.wrapError)(error);
+    }
+}
+//# sourceMappingURL=search_domain.js.map

package/dist/tools/search_domain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search_domain.js","sourceRoot":"","sources":["../../src/tools/search_domain.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA8EH,kDASC;AArFD,6BAAwB;AAExB,mEAA4D;AAC5D,kDAA+C;AAE/C;;GAEG;AACU,QAAA,kBAAkB,GAAG,OAAC,CAAC,MAAM,CAAC;IACzC,WAAW,EAAE,OAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,EAAE,CAAC;SACP,QAAQ,CACP,gHAAgH,CACjH;IACH,IAAI,EAAE,OAAC;SACJ,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CACP,0GAA0G,CAC3G;IACH,UAAU,EAAE,OAAC;SACV,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;SACjB,QAAQ,EAAE;SACV,QAAQ,CACP,sGAAsG,CACvG;CACJ,CAAC,CAAC;AAIH;;GAEG;AACU,QAAA,gBAAgB,GAAG;IAC9B,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE;;;;;;;;;;+DAUgD;IAC7D,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACV,WAAW,EAAE;gBACX,IAAI,EAAE,QAAQ;gBACd,WAAW,EACT,sEAAsE;aACzE;YACD,IAAI,EAAE;gBACJ,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,yFAAyF;aAC5F;YACD,UAAU,EAAE;gBACV,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;gBACzB,WAAW,EACT,qEAAqE;aACxE;SACF;QACD,QAAQ,EAAE,CAAC,aAAa,CAAC;KAC1B;CACF,CAAC;AAEF;;GAEG;AACI,KAAK,UAAU,mBAAmB,CACvC,KAAwB;IAExB,IAAI,CAAC;QACH,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,0BAAkB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1E,OAAO,MAAM,IAAA,+BAAY,EAAC,WAAW,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAA,qBAAS,EAAC,KAAK,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/tools/suggest_domains.d.ts

@@ -0,0 +1,82 @@
+/**
+ * suggest_domains Tool - Domain Name Suggestions.
+ *
+ * Generate and check variations of a base domain name.
+ * Helps find available alternatives when the primary name is taken.
+ */
+import { z } from 'zod';
+/**
+ * Input schema for suggest_domains.
+ */
+export declare const suggestDomainsSchema: z.ZodObject<{
+    base_name: z.ZodString;
+    tld: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    variants: z.ZodOptional<z.ZodArray<z.ZodEnum<["hyphen", "numbers", "abbreviations", "synonyms", "prefixes", "suffixes"]>, "many">>;
+    max_suggestions: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    tld: string;
+    base_name: string;
+    max_suggestions: number;
+    variants?: ("hyphen" | "numbers" | "abbreviations" | "synonyms" | "prefixes" | "suffixes")[] | undefined;
+}, {
+    base_name: string;
+    tld?: string | undefined;
+    variants?: ("hyphen" | "numbers" | "abbreviations" | "synonyms" | "prefixes" | "suffixes")[] | undefined;
+    max_suggestions?: number | undefined;
+}>;
+export type SuggestDomainsInput = z.infer<typeof suggestDomainsSchema>;
+/**
+ * Tool definition for MCP.
+ */
+export declare const suggestDomainsTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            base_name: {
+                type: string;
+                description: string;
+            };
+            tld: {
+                type: string;
+                description: string;
+            };
+            variants: {
+                type: string;
+                items: {
+                    type: string;
+                    enum: string[];
+                };
+                description: string;
+            };
+            max_suggestions: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Response format for suggestions.
+ */
+interface SuggestDomainsResponse {
+    base_name: string;
+    tld: string;
+    total_checked: number;
+    available_count: number;
+    suggestions: Array<{
+        domain: string;
+        price_first_year: number | null;
+        registrar: string;
+        score: number;
+    }>;
+    insights: string[];
+}
+/**
+ * Execute the suggest_domains tool.
+ */
+export declare function executeSuggestDomains(input: SuggestDomainsInput): Promise<SuggestDomainsResponse>;
+export {};
+//# sourceMappingURL=suggest_domains.d.ts.map

package/dist/tools/suggest_domains.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest_domains.d.ts","sourceRoot":"","sources":["../../src/tools/suggest_domains.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;EAwB/B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwC9B,CAAC;AAoGF;;GAEG;AACH,UAAU,sBAAsB;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,KAAK,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;QAChC,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,sBAAsB,CAAC,CA0EjC"}

package/dist/tools/suggest_domains.js

@@ -0,0 +1,227 @@
+"use strict";
+/**
+ * suggest_domains Tool - Domain Name Suggestions.
+ *
+ * Generate and check variations of a base domain name.
+ * Helps find available alternatives when the primary name is taken.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.suggestDomainsTool = exports.suggestDomainsSchema = void 0;
+exports.executeSuggestDomains = executeSuggestDomains;
+const zod_1 = require("zod");
+const domain_search_js_1 = require("../services/domain-search.js");
+const validators_js_1 = require("../utils/validators.js");
+const errors_js_1 = require("../utils/errors.js");
+/**
+ * Input schema for suggest_domains.
+ */
+exports.suggestDomainsSchema = zod_1.z.object({
+    base_name: zod_1.z
+        .string()
+        .min(1)
+        .describe("The base domain name to generate variations from (e.g., 'vibecoding')."),
+    tld: zod_1.z
+        .string()
+        .optional()
+        .default('com')
+        .describe("TLD to check suggestions against (e.g., 'com'). Defaults to 'com'."),
+    variants: zod_1.z
+        .array(zod_1.z.enum(['hyphen', 'numbers', 'abbreviations', 'synonyms', 'prefixes', 'suffixes']))
+        .optional()
+        .describe("Types of variations to generate. Defaults to all types."),
+    max_suggestions: zod_1.z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .optional()
+        .default(10)
+        .describe("Maximum number of suggestions to return (1-50). Defaults to 10."),
+});
+/**
+ * Tool definition for MCP.
+ */
+exports.suggestDomainsTool = {
+    name: 'suggest_domains',
+    description: `Generate and check availability of domain name variations.
+
+Creates variations like:
+- Hyphenated: vibe-coding
+- With numbers: vibecoding1, vibecoding2
+- Prefixes: getvibecoding, tryvibecoding
+- Suffixes: vibecodingapp, vibecodinghq
+
+Returns only available suggestions, ranked by quality.
+
+Example:
+- suggest_domains("vibecoding") → finds available variations`,
+    inputSchema: {
+        type: 'object',
+        properties: {
+            base_name: {
+                type: 'string',
+                description: "The base domain name to generate variations from.",
+            },
+            tld: {
+                type: 'string',
+                description: "TLD to check (e.g., 'com'). Defaults to 'com'.",
+            },
+            variants: {
+                type: 'array',
+                items: {
+                    type: 'string',
+                    enum: ['hyphen', 'numbers', 'abbreviations', 'synonyms', 'prefixes', 'suffixes'],
+                },
+                description: "Types of variations to generate. Defaults to all.",
+            },
+            max_suggestions: {
+                type: 'number',
+                description: "Maximum suggestions to return (1-50). Defaults to 10.",
+            },
+        },
+        required: ['base_name'],
+    },
+};
+/**
+ * Generate domain name variations.
+ */
+function generateVariations(baseName, variantTypes) {
+    const variations = new Set();
+    // Always include the original
+    variations.add(baseName);
+    if (variantTypes.includes('hyphen') || variantTypes.length === 0) {
+        // Add hyphens at word boundaries (heuristic: before capital letters or common words)
+        const hyphenated = baseName.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
+        if (hyphenated !== baseName) {
+            variations.add(hyphenated);
+        }
+        // Try hyphen in the middle
+        if (baseName.length >= 6) {
+            const mid = Math.floor(baseName.length / 2);
+            variations.add(baseName.slice(0, mid) + '-' + baseName.slice(mid));
+        }
+    }
+    if (variantTypes.includes('numbers') || variantTypes.length === 0) {
+        // Add numbers
+        for (let i = 1; i <= 3; i++) {
+            variations.add(`${baseName}${i}`);
+        }
+        variations.add(`${baseName}io`);
+        variations.add(`${baseName}app`);
+    }
+    if (variantTypes.includes('prefixes') || variantTypes.length === 0) {
+        const prefixes = ['get', 'try', 'use', 'my', 'the', 'go', 'hey', 'hi'];
+        for (const prefix of prefixes) {
+            variations.add(`${prefix}${baseName}`);
+        }
+    }
+    if (variantTypes.includes('suffixes') || variantTypes.length === 0) {
+        const suffixes = ['app', 'hq', 'io', 'labs', 'dev', 'ai', 'hub', 'now'];
+        for (const suffix of suffixes) {
+            variations.add(`${baseName}${suffix}`);
+        }
+    }
+    if (variantTypes.includes('abbreviations') || variantTypes.length === 0) {
+        // Remove vowels (except first letter)
+        const abbreviated = baseName[0] + baseName.slice(1).replace(/[aeiou]/gi, '');
+        if (abbreviated.length >= 3 && abbreviated !== baseName) {
+            variations.add(abbreviated);
+        }
+    }
+    return Array.from(variations);
+}
+/**
+ * Score a domain suggestion.
+ * Higher score = better suggestion.
+ */
+function scoreSuggestion(original, suggestion, result) {
+    let score = 50; // Base score
+    // Prefer shorter names
+    score -= suggestion.length;
+    // Prefer exact match
+    if (suggestion === original)
+        score += 20;
+    // Prefer no hyphens
+    if (!suggestion.includes('-'))
+        score += 5;
+    // Prefer no numbers
+    if (!/\d/.test(suggestion))
+        score += 5;
+    // Prefer cheaper prices
+    if (result.price_first_year !== null) {
+        if (result.price_first_year <= 10)
+            score += 10;
+        else if (result.price_first_year <= 15)
+            score += 5;
+    }
+    // Penalize premiums
+    if (result.premium)
+        score -= 20;
+    // Bonus for privacy included
+    if (result.privacy_included)
+        score += 5;
+    return score;
+}
+/**
+ * Execute the suggest_domains tool.
+ */
+async function executeSuggestDomains(input) {
+    try {
+        const { base_name, tld, variants, max_suggestions } = exports.suggestDomainsSchema.parse(input);
+        const normalizedBase = (0, validators_js_1.validateDomainName)(base_name);
+        const variantTypes = variants || [];
+        // Generate variations
+        const variations = generateVariations(normalizedBase, variantTypes);
+        // Limit to max + some buffer for unavailable ones
+        const toCheck = variations.slice(0, max_suggestions * 2);
+        // Check availability for all variations
+        const results = [];
+        for (const name of toCheck) {
+            try {
+                const response = await (0, domain_search_js_1.searchDomain)(name, [tld]);
+                const result = response.results.find((r) => r.domain === `${name}.${tld}`);
+                results.push({ name, result: result || null });
+            }
+            catch {
+                results.push({ name, result: null });
+            }
+        }
+        // Filter to available and score them
+        const available = results
+            .filter((r) => r.result?.available)
+            .map((r) => ({
+            name: r.name,
+            result: r.result,
+            score: scoreSuggestion(normalizedBase, r.name, r.result),
+        }))
+            .sort((a, b) => b.score - a.score)
+            .slice(0, max_suggestions);
+        const insights = [];
+        if (available.length > 0) {
+            insights.push(`✅ Found ${available.length} available variation${available.length > 1 ? 's' : ''}`);
+            const best = available[0];
+            insights.push(`⭐ Top suggestion: ${best.name}.${tld} ($${best.result.price_first_year ?? 'unknown'}/year)`);
+        }
+        else {
+            insights.push(`❌ No available variations found for ${normalizedBase}.${tld}`);
+            insights.push('💡 Try a different TLD or modify the base name more significantly');
+        }
+        return {
+            base_name: normalizedBase,
+            tld,
+            total_checked: toCheck.length,
+            available_count: available.length,
+            suggestions: available.map((a) => ({
+                domain: `${a.name}.${tld}`,
+                price_first_year: a.result.price_first_year,
+                registrar: a.result.registrar,
+                score: a.score,
+            })),
+            insights,
+        };
+    }
+    catch (error) {
+        throw (0, errors_js_1.wrapError)(error);
+    }
+}
+//# sourceMappingURL=suggest_domains.js.map

package/dist/tools/suggest_domains.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggest_domains.js","sourceRoot":"","sources":["../../src/tools/suggest_domains.ts"],"names":[],"mappings":"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"}

package/dist/tools/tld_info.d.ts

@@ -0,0 +1,56 @@
+/**
+ * tld_info Tool - TLD Information.
+ *
+ * Get information about a Top Level Domain (TLD).
+ * Includes pricing, restrictions, and recommendations.
+ */
+import { z } from 'zod';
+import type { TLDInfo } from '../types.js';
+/**
+ * Input schema for tld_info.
+ */
+export declare const tldInfoSchema: z.ZodObject<{
+    tld: z.ZodString;
+    detailed: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    tld: string;
+    detailed: boolean;
+}, {
+    tld: string;
+    detailed?: boolean | undefined;
+}>;
+export type TldInfoInput = z.infer<typeof tldInfoSchema>;
+/**
+ * Tool definition for MCP.
+ */
+export declare const tldInfoTool: {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties: {
+            tld: {
+                type: string;
+                description: string;
+            };
+            detailed: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+};
+/**
+ * Response format for TLD info.
+ */
+interface TldInfoResponse extends TLDInfo {
+    insights: string[];
+    recommendation: string;
+}
+/**
+ * Execute the tld_info tool.
+ */
+export declare function executeTldInfo(input: TldInfoInput): Promise<TldInfoResponse>;
+export {};
+//# sourceMappingURL=tld_info.d.ts.map

package/dist/tools/tld_info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tld_info.d.ts","sourceRoot":"","sources":["../../src/tools/tld_info.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAK3C;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;EAWxB,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;CA0BvB,CAAC;AAgIF;;GAEG;AACH,UAAU,eAAgB,SAAQ,OAAO;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,KAAK,EAAE,YAAY,GAClB,OAAO,CAAC,eAAe,CAAC,CAsC1B"}