domain-search-mcp 1.0.0

package/dist/utils/validators.js

@@ -0,0 +1,159 @@
+"use strict";
+/**
+ * Domain Name Validators.
+ *
+ * Validates domain names, TLDs, and other inputs.
+ * Provides user-friendly error messages.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateDomainName = validateDomainName;
+exports.validateTld = validateTld;
+exports.parseDomain = parseDomain;
+exports.validateTlds = validateTlds;
+exports.isFullDomain = isFullDomain;
+exports.buildDomain = buildDomain;
+exports.validateRegistrar = validateRegistrar;
+const config_js_1 = require("../config.js");
+const errors_js_1 = require("./errors.js");
+/**
+ * Valid domain name pattern (without TLD).
+ * - 1-63 characters per label
+ * - Alphanumeric and hyphens
+ * - Cannot start or end with hyphen
+ * - Cannot have consecutive hyphens (except for IDN: xn--)
+ */
+const DOMAIN_LABEL_PATTERN = /^[a-z0-9]([a-z0-9-]{0,61}[a-z0-9])?$/i;
+/**
+ * Valid TLD pattern.
+ * - 2-63 characters
+ * - Alphanumeric only (no hyphens in TLD)
+ */
+const TLD_PATTERN = /^[a-z]{2,63}$/i;
+/**
+ * Characters that are definitely not allowed in domains.
+ */
+const INVALID_CHARS = /[^a-z0-9.-]/i;
+/**
+ * Validate and normalize a domain name (without TLD).
+ *
+ * @param name - The domain name to validate
+ * @returns Normalized domain name (lowercase)
+ * @throws InvalidDomainError if invalid
+ */
+function validateDomainName(name) {
+    // Trim and lowercase
+    const normalized = name.trim().toLowerCase();
+    // Check for empty
+    if (!normalized) {
+        throw new errors_js_1.InvalidDomainError(name, 'Domain name cannot be empty');
+    }
+    // Check length
+    if (normalized.length > 63) {
+        throw new errors_js_1.InvalidDomainError(name, `Domain name too long (${normalized.length} chars, max 63)`);
+    }
+    // Check for invalid characters
+    if (INVALID_CHARS.test(normalized)) {
+        const invalidChar = normalized.match(INVALID_CHARS)?.[0];
+        throw new errors_js_1.InvalidDomainError(name, `Contains invalid character: "${invalidChar}"`);
+    }
+    // Check pattern
+    if (!DOMAIN_LABEL_PATTERN.test(normalized)) {
+        if (normalized.startsWith('-')) {
+            throw new errors_js_1.InvalidDomainError(name, 'Cannot start with a hyphen');
+        }
+        if (normalized.endsWith('-')) {
+            throw new errors_js_1.InvalidDomainError(name, 'Cannot end with a hyphen');
+        }
+        throw new errors_js_1.InvalidDomainError(name, 'Invalid format. Use only letters, numbers, and hyphens.');
+    }
+    return normalized;
+}
+/**
+ * Validate a TLD.
+ *
+ * @param tld - The TLD to validate (with or without leading dot)
+ * @returns Normalized TLD (lowercase, no dot)
+ * @throws UnsupportedTldError if invalid or not allowed
+ */
+function validateTld(tld) {
+    // Remove leading dot if present
+    const normalized = tld.replace(/^\./, '').trim().toLowerCase();
+    // Check for empty
+    if (!normalized) {
+        throw new errors_js_1.UnsupportedTldError(tld, config_js_1.config.allowedTlds);
+    }
+    // Check pattern
+    if (!TLD_PATTERN.test(normalized)) {
+        throw new errors_js_1.UnsupportedTldError(normalized, config_js_1.config.allowedTlds);
+    }
+    // Check against deny list
+    if (config_js_1.config.denyTlds.includes(normalized)) {
+        throw new errors_js_1.UnsupportedTldError(normalized, config_js_1.config.allowedTlds);
+    }
+    // Check against allow list (if not empty)
+    if (config_js_1.config.allowedTlds.length > 0 &&
+        !config_js_1.config.allowedTlds.includes(normalized)) {
+        throw new errors_js_1.UnsupportedTldError(normalized, config_js_1.config.allowedTlds);
+    }
+    return normalized;
+}
+/**
+ * Parse a full domain name into name and TLD.
+ *
+ * @param fullDomain - Full domain like "example.com" or "sub.example.co.uk"
+ * @returns Object with name and tld
+ * @throws InvalidDomainError if parsing fails
+ */
+function parseDomain(fullDomain) {
+    const normalized = fullDomain.trim().toLowerCase();
+    // Find the last dot
+    const lastDot = normalized.lastIndexOf('.');
+    if (lastDot === -1) {
+        throw new errors_js_1.InvalidDomainError(fullDomain, 'No TLD found. Include the extension (e.g., "example.com")');
+    }
+    const name = normalized.slice(0, lastDot);
+    const tld = normalized.slice(lastDot + 1);
+    // Handle multi-part TLDs (e.g., co.uk) - for simplicity, we don't support these yet
+    // In a full implementation, you'd use the Public Suffix List
+    return {
+        name: validateDomainName(name),
+        tld: validateTld(tld),
+    };
+}
+/**
+ * Validate an array of TLDs.
+ *
+ * @param tlds - Array of TLDs to validate
+ * @returns Array of normalized TLDs
+ */
+function validateTlds(tlds) {
+    if (!tlds || tlds.length === 0) {
+        // Return default TLDs
+        return ['com', 'io', 'dev'];
+    }
+    return tlds.map(validateTld);
+}
+/**
+ * Check if a string looks like a full domain (has a dot).
+ */
+function isFullDomain(input) {
+    return input.includes('.');
+}
+/**
+ * Build a full domain from name and TLD.
+ */
+function buildDomain(name, tld) {
+    return `${validateDomainName(name)}.${validateTld(tld)}`;
+}
+/**
+ * Validate registrar name.
+ */
+function validateRegistrar(registrar) {
+    const normalized = registrar.trim().toLowerCase();
+    const validRegistrars = ['porkbun', 'namecheap', 'godaddy'];
+    if (!validRegistrars.includes(normalized)) {
+        throw new Error(`Invalid registrar: "${registrar}". Valid options: ${validRegistrars.join(', ')}`);
+    }
+    return normalized;
+}
+//# sourceMappingURL=validators.js.map

package/dist/utils/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../../src/utils/validators.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAiCH,gDAyCC;AASD,kCA4BC;AASD,kCAsBC;AAQD,oCAOC;AAKD,oCAEC;AAKD,kCAEC;AAKD,8CAWC;AAzLD,4CAAsC;AACtC,2CAAsE;AAEtE;;;;;;GAMG;AACH,MAAM,oBAAoB,GAAG,uCAAuC,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAErC;;GAEG;AACH,MAAM,aAAa,GAAG,cAAc,CAAC;AAErC;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAAC,IAAY;IAC7C,qBAAqB;IACrB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE7C,kBAAkB;IAClB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,8BAAkB,CAAC,IAAI,EAAE,6BAA6B,CAAC,CAAC;IACpE,CAAC;IAED,eAAe;IACf,IAAI,UAAU,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;QAC3B,MAAM,IAAI,8BAAkB,CAC1B,IAAI,EACJ,yBAAyB,UAAU,CAAC,MAAM,iBAAiB,CAC5D,CAAC;IACJ,CAAC;IAED,+BAA+B;IAC/B,IAAI,aAAa,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QACnC,MAAM,WAAW,GAAG,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,IAAI,8BAAkB,CAC1B,IAAI,EACJ,gCAAgC,WAAW,GAAG,CAC/C,CAAC;IACJ,CAAC;IAED,gBAAgB;IAChB,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3C,IAAI,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC/B,MAAM,IAAI,8BAAkB,CAAC,IAAI,EAAE,4BAA4B,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,MAAM,IAAI,8BAAkB,CAAC,IAAI,EAAE,0BAA0B,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,IAAI,8BAAkB,CAC1B,IAAI,EACJ,yDAAyD,CAC1D,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,WAAW,CAAC,GAAW;IACrC,gCAAgC;IAChC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAE/D,kBAAkB;IAClB,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,+BAAmB,CAAC,GAAG,EAAE,kBAAM,CAAC,WAAW,CAAC,CAAC;IACzD,CAAC;IAED,gBAAgB;IAChB,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,+BAAmB,CAAC,UAAU,EAAE,kBAAM,CAAC,WAAW,CAAC,CAAC;IAChE,CAAC;IAED,0BAA0B;IAC1B,IAAI,kBAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,+BAAmB,CAAC,UAAU,EAAE,kBAAM,CAAC,WAAW,CAAC,CAAC;IAChE,CAAC;IAED,0CAA0C;IAC1C,IACE,kBAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC;QAC7B,CAAC,kBAAM,CAAC,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EACxC,CAAC;QACD,MAAM,IAAI,+BAAmB,CAAC,UAAU,EAAE,kBAAM,CAAC,WAAW,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,WAAW,CAAC,UAAkB;IAC5C,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAEnD,oBAAoB;IACpB,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC5C,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;QACnB,MAAM,IAAI,8BAAkB,CAC1B,UAAU,EACV,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC1C,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;IAE1C,oFAAoF;IACpF,6DAA6D;IAE7D,OAAO;QACL,IAAI,EAAE,kBAAkB,CAAC,IAAI,CAAC;QAC9B,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC;KACtB,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,SAAgB,YAAY,CAAC,IAAc;IACzC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,sBAAsB;QACtB,OAAO,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAC9B,CAAC;IAED,OAAO,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AAC/B,CAAC;AAED;;GAEG;AACH,SAAgB,YAAY,CAAC,KAAa;IACxC,OAAO,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAgB,WAAW,CAAC,IAAY,EAAE,GAAW;IACnD,OAAO,GAAG,kBAAkB,CAAC,IAAI,CAAC,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,SAAiB;IACjD,MAAM,UAAU,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IAE5D,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CACb,uBAAuB,SAAS,qBAAqB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClF,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/docs/marketing/devto-post.md

@@ -0,0 +1,135 @@
+---
+title: I Built an MCP Server to Check Domain Availability from Claude
+published: true
+description: How I stopped context-switching between AI and domain registrars
+tags: ai, typescript, opensource, webdev
+cover_image: https://dev-to-uploads.s3.amazonaws.com/uploads/articles/placeholder.png
+---
+
+# I Built an MCP Server to Check Domain Availability from Claude
+
+Last week, I was brainstorming names for a new side project with Claude. Every time I came up with a name, I had to:
+
+1. Leave Claude
+2. Open Namecheap/Porkbun
+3. Search the domain
+4. Go back to Claude
+5. Report the result
+6. Repeat 50 times
+
+This was frustrating. So I built a solution.
+
+## Introducing Domain Search MCP
+
+[Domain Search MCP](https://github.com/dorukardahan/domain-search-mcp) is an open-source MCP server that gives Claude the ability to check domain availability in real-time.
+
+Now my workflow is:
+
+> **Me:** "Is vibecoding.com available?"
+> **Claude:** "✅ vibecoding.com is available at $9.73/year on Porkbun (includes free WHOIS privacy)"
+
+## What is MCP?
+
+[Model Context Protocol (MCP)](https://modelcontextprotocol.io) is Anthropic's open standard for connecting AI assistants to external tools and data sources. Think of it as USB-C for AI – a universal way to plug in capabilities.
+
+## Features
+
+### 1. Multi-Source Search
+Checks domain availability across:
+- **Porkbun** (with pricing)
+- **Namecheap** (with pricing)
+- **RDAP** (free, 50+ TLDs)
+- **WHOIS** (fallback)
+
+### 2. Sherlock-Style Social Check
+```
+check_socials("vibecoding")
+```
+Returns availability across 10 platforms:
+- HIGH confidence: GitHub, npm, PyPI, Reddit
+- MEDIUM confidence: Twitter, YouTube, ProductHunt
+- LOW confidence: Instagram, LinkedIn, TikTok
+
+### 3. Premium Domain Analysis
+When a domain is premium, you get insights:
+```
+💎 ai.io is priced at $5000 (125x standard .io pricing)
+Why premium: Two-character domain, Popular keyword "ai", High-demand .io extension
+💡 Try: getai.io, aihq.io, ai.dev
+```
+
+### 4. Expiration Tracking
+For taken domains, see when they expire:
+```
+🕐 coolstartup.com expires in 23 days — watch for availability
+```
+
+## Quick Start
+
+```bash
+# Add to Claude Desktop
+npx @anthropic/claude-code mcp add domain-search-mcp
+```
+
+Or manually add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "domain-search": {
+      "command": "npx",
+      "args": ["-y", "domain-search-mcp"]
+    }
+  }
+}
+```
+
+## Zero Config Mode
+
+Works out of the box using public RDAP/WHOIS. Add registrar API keys for pricing:
+
+```bash
+PORKBUN_API_KEY=pk1_xxx
+PORKBUN_API_SECRET=sk1_xxx
+```
+
+## Technical Highlights
+
+- **TypeScript** with strict types
+- **Zod validation** for all API responses
+- **98 tests** passing
+- **LRU cache** with TTL
+- **Rate limiting** per registrar
+- **Security audited** (see SECURITY.md)
+
+## Architecture
+
+```
+┌─────────────────────────────────────────┐
+│           MCP Protocol Layer            │
+│        (Zod schema validation)          │
+├─────────────────────────────────────────┤
+│              6 Tools                    │
+│  search_domain, bulk_search, compare,   │
+│  suggest, tld_info, check_socials       │
+├─────────────────────────────────────────┤
+│         Registrar Adapters              │
+│   Porkbun │ Namecheap │ RDAP │ WHOIS    │
+└─────────────────────────────────────────┘
+```
+
+## What's Next?
+
+I'm considering adding:
+- DNS record checking
+- SSL certificate info
+- Trademark search integration
+
+What features would you find useful? Drop a comment!
+
+---
+
+**GitHub:** https://github.com/dorukardahan/domain-search-mcp
+**License:** MIT
+
+If this helped you, consider giving it a ⭐ on GitHub!

package/docs/marketing/hackernews.md

@@ -0,0 +1,42 @@
+# Hacker News - Show HN Post
+
+## Title (80 char max):
+```
+Show HN: Domain Search MCP – AI-powered domain availability checker for Claude
+```
+
+## URL:
+```
+https://github.com/dorukardahan/domain-search-mcp
+```
+
+## Text (optional, for self-posts):
+```
+I built an MCP (Model Context Protocol) server that lets Claude check domain availability in real-time.
+
+Why? I was tired of context-switching between Claude and domain registrars while brainstorming project names. Now I just ask Claude "Is vibecoding.com available?" and it checks Porkbun, Namecheap, RDAP, and WHOIS in seconds.
+
+Features:
+- Check availability + pricing across multiple TLDs
+- Compare prices between registrars
+- Sherlock-style social handle checking (10 platforms)
+- Premium domain detection with "why it's premium" insights
+- Domain expiration tracking for taken domains
+
+Works with zero config (uses public RDAP/WHOIS), or add registrar API keys for pricing.
+
+Built with TypeScript, 98 tests, security audited. Open source, MIT license.
+
+Would love feedback on the architecture or feature requests!
+```
+
+---
+
+## Posting Tips:
+- Post between 6-9 AM PT (best visibility)
+- Monday-Thursday performs best
+- Don't post on weekends
+- Respond to comments quickly
+
+## Suggested posting time:
+- 6:00 AM PT = 4:00 PM Istanbul time

package/docs/marketing/producthunt.md

@@ -0,0 +1,109 @@
+# Product Hunt Launch Preparation
+
+## Basic Info
+
+**Name:** Domain Search MCP
+
+**Tagline (60 chars max):**
+```
+Check domain availability directly from Claude AI
+```
+
+**Description:**
+```
+Domain Search MCP is an open-source tool that gives Claude AI the ability to check domain availability in real-time.
+
+Stop context-switching between your AI assistant and domain registrars. Just ask Claude "Is mybrand.com available?" and get instant results with pricing from multiple sources.
+
+🔍 What it does:
+• Check domain availability across Porkbun, Namecheap, RDAP, WHOIS
+• Compare prices between registrars instantly
+• Check social handle availability (GitHub, Twitter, npm, etc.)
+• Understand why premium domains are expensive
+• Track when taken domains will expire
+
+⚡ Key features:
+• Works with zero configuration (uses public RDAP/WHOIS)
+• Add registrar API keys for real-time pricing
+• 50+ TLD support including .com, .io, .dev, .ai, and more
+• Sherlock-style social media username checking
+• Security audited, 98 tests passing
+
+🛠 Built with:
+• TypeScript + Zod validation
+• Model Context Protocol (MCP) by Anthropic
+• MIT License, fully open source
+
+Perfect for:
+• Developers brainstorming project names
+• Startup founders checking brand availability
+• Anyone who uses Claude for ideation
+```
+
+---
+
+## Topics/Categories:
+- Developer Tools
+- Artificial Intelligence
+- Open Source
+- Productivity
+
+---
+
+## First Comment (Maker's Comment):
+```
+Hey Product Hunt! 👋
+
+I'm the maker of Domain Search MCP.
+
+The problem: I use Claude constantly for brainstorming. Every time I come up with a project name, I have to leave Claude, open a domain registrar, check if it's available, and then go back to report the result. This breaks my flow.
+
+The solution: An MCP server that lets Claude check domains directly. Now I just ask "Is coolname.com available?" and Claude tells me instantly — with pricing from multiple registrars.
+
+This is open source (MIT license) and works with Claude Desktop. Would love your feedback!
+
+Try it: npx @anthropic/claude-code mcp add domain-search-mcp
+```
+
+---
+
+## Launch Checklist:
+
+### Before Launch:
+- [ ] Create Product Hunt account
+- [ ] Verify email
+- [ ] Complete profile with photo
+- [ ] Have 5+ followers on PH
+- [ ] Prepare 4-6 images/screenshots
+- [ ] Write description
+- [ ] Schedule for Monday 12:01 AM PT
+
+### Launch Day (Monday):
+- [ ] Post at 12:01 AM PT (10:01 AM Istanbul)
+- [ ] Share on Twitter immediately
+- [ ] Share on LinkedIn
+- [ ] Reply to every comment within 1 hour
+- [ ] Ask friends to upvote + comment (authentic)
+
+### Images Needed:
+1. Logo/Icon (240x240)
+2. Gallery image 1: Hero screenshot
+3. Gallery image 2: Example conversation
+4. Gallery image 3: Feature overview
+5. Gallery image 4: Social check feature
+
+---
+
+## Screenshot Ideas:
+
+### Screenshot 1 - Hero:
+Claude conversation showing domain search in action
+
+### Screenshot 2 - Multi-TLD:
+Checking .com, .io, .dev at once
+
+### Screenshot 3 - Social Check:
+Showing the 10-platform social handle check
+
+### Screenshot 4 - Premium Analysis:
+Premium domain with "why it's expensive" insight

package/docs/marketing/reddit-post.md

@@ -0,0 +1,59 @@
+# Reddit Post - r/ClaudeAI
+
+## Title:
+```
+I built an MCP server that lets Claude check domain availability in real-time
+```
+
+## Body:
+```
+Hey everyone!
+
+I got frustrated with constantly leaving Claude to check if domains were available while brainstorming project names. So I built an MCP server to solve this.
+
+**What it does:**
+
+- Check domain availability + pricing across Porkbun, Namecheap, RDAP, WHOIS
+- Compare prices between registrars
+- Check social handle availability (GitHub, Twitter, npm, etc.)
+- Tell you WHY premium domains are expensive
+- Show when taken domains expire
+
+**Example conversation:**
+
+> Me: "Is vibecoding.com available?"
+>
+> Claude: "✅ vibecoding.com is available!
+> - Porkbun: $9.73/year (includes free WHOIS privacy)
+> - .io also available at $39.99/year
+> - .dev available at $12.00/year
+>
+> 💡 .com is the classic, universal choice — trusted worldwide"
+
+**Install:**
+
+```bash
+npx @anthropic/claude-code mcp add domain-search-mcp
+```
+
+**Links:**
+- GitHub: https://github.com/dorukardahan/domain-search-mcp
+- MIT License, open source
+- 98 tests, TypeScript, security audited
+
+Would love to hear your feedback or feature requests!
+```
+
+---
+
+## Subreddit options:
+1. r/ClaudeAI (primary)
+2. r/LocalLLaMA (if they allow MCP posts)
+3. r/MachineLearning (Saturday thread)
+4. r/SideProject
+
+## Tips:
+- Post during US working hours (9 AM - 5 PM EST)
+- Respond to every comment
+- Don't be too promotional
+- Ask for feedback genuinely

package/docs/marketing/twitter-thread.md

@@ -0,0 +1,105 @@
+# Twitter Thread
+
+## Thread (copy each tweet separately):
+
+---
+
+**Tweet 1 (Hook):**
+```
+I got tired of leaving Claude every time I needed to check if a domain was available.
+
+So I built an MCP server that does it for me.
+
+Now I just ask: "Is vibecoding.com available?"
+
+🧵 Here's what I built (open source):
+```
+
+---
+
+**Tweet 2:**
+```
+Domain Search MCP connects Claude to:
+
+• Porkbun (with pricing)
+• Namecheap (with pricing)
+• RDAP (50+ TLDs)
+• WHOIS (fallback)
+
+One question → multiple sources checked in seconds.
+```
+
+---
+
+**Tweet 3:**
+```
+But domains aren't enough.
+
+I added Sherlock-style social handle checking.
+
+One command checks 10 platforms:
+✅ GitHub, npm, PyPI, Reddit (high confidence)
+⚠️ Twitter, YouTube, ProductHunt (medium)
+🔒 Instagram, LinkedIn, TikTok (verify manually)
+```
+
+---
+
+**Tweet 4:**
+```
+Premium domains now tell you WHY they're expensive:
+
+💎 "ai.io is $5000 (125x standard pricing)"
+
+"Why premium: Two-character domain, Popular keyword, High-demand TLD"
+
+"Try instead: getai.io, aihq.io, ai.dev"
+```
+
+---
+
+**Tweet 5:**
+```
+For taken domains, it shows expiration dates:
+
+🕐 "coolstartup.com expires in 23 days"
+
+Useful if you're watching a domain.
+```
+
+---
+
+**Tweet 6:**
+```
+Technical details for the nerds:
+
+• TypeScript + Zod validation
+• 98 tests passing
+• LRU cache with TTL
+• Rate limiting per registrar
+• Security audited
+
+MIT license, contributions welcome.
+```
+
+---
+
+**Tweet 7 (CTA):**
+```
+Try it now:
+
+npx @anthropic/claude-code mcp add domain-search-mcp
+
+Or check GitHub for manual setup:
+github.com/dorukardahan/domain-search-mcp
+
+@AnthropicAI @ClaudeAI #MCP #AI #OpenSource
+```
+
+---
+
+## Posting tips:
+- Post between 9-11 AM or 1-3 PM (your local time)
+- Use the thread feature (reply to yourself)
+- Add a relevant image/GIF to Tweet 1
+- Pin the thread after posting