# DomainFinder MCP Server

[![NPM Version](https://img.shields.io/npm/v/@codingstark-dev/domainfinder-mcp)](https://www.npmjs.com/package/@codingstark/domainfinder-mcp)
[![NPM Downloads](https://img.shields.io/npm/dw/@codingstark-dev/domainfinder-mcp)](https://www.npmjs.com/package/@codingstark/domainfinder-mcp)
[![License](https://img.shields.io/npm/l/@codingstark-dev/domainfinder-mcp)](LICENSE)
[![GitHub stars](https://img.shields.io/github/stars/codingstark-dev/domainfinder-mcp)](https://github.com/codingstark-dev/domainfinder-mcp)

> ⭐ **If you find this useful, please star this repo on [GitHub](https://github.com/codingstark-dev/domainfinder-mcp)!** ⭐

A Model Context Protocol (MCP) server for checking domain name availability with support for 877 TLDs. Built with Bun and the official MCP SDK.

## ✨ Features

- ✅ Check domain availability across 877 TLDs
- ✅ Generate intelligent domain suggestions
- ✅ Get WHOIS information for registered domains
- ✅ Auto-updating WHOIS database (weekly)
- ✅ Support for Claude Desktop, Cursor, OpenCode, and more

## 📦 Installation

```bash
npm install -g @codingstark-dev/domainfinder-mcp
```

## 🚀 Quick Setup

### Claude Desktop

Add to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "domainfinder": {
      "command": "npx",
      "args": ["-y", "@codingstark-dev/domainfinder-mcp"]
    }
  }
}
```

Restart Claude Desktop.

### Cursor

Add to `.cursor/mcp.json`:

```json
{
  "mcpServers": {
    "domainfinder": {
      "command": "npx",
      "args": ["-y", "@codingstark-dev/domainfinder-mcp"]
    }
  }
}
```

### OpenCode

**Local:**
```json
{
  "mcp": {
    "domainfinder": {
      "type": "local",
      "command": ["npx", "-y", "@codingstark-dev/domainfinder-mcp"],
      "enabled": true
    }
  }
}
```

**Remote (Hosted):**
```json
{
  "mcp": {
    "domainfinder": {
      "type": "remote",
      "url": "https://domain-finder.codingstark.com/sse",
      "enabled": true
    }
  }
}
```

## 💡 Usage

Once connected, ask your AI assistant:

- "Check if example.com is available"
- "Find available domains for 'myawesomeapp'"
- "Check google across all TLDs"
- "Get WHOIS info for github.com"
- "Suggest domains for my startup"

## 🛠️ Available Tools

- `check_domain` - Check single domain availability
- `check_domains_bulk` - Check multiple domains at once
- `suggest_domains` - Generate domain suggestions
- `whois_lookup` - Get WHOIS registration info
- `find_across_tlds` - Check across popular TLDs

## 🌐 Remote Server

Use the hosted version instead of running locally:

```
https://domain-finder.codingstark.com/sse
```

## 🤝 Contributing

Found a bug or have a feature request? [Open an issue](https://github.com/codingstark-dev/domainfinder-mcp/issues)!

## 📄 License

MIT License - feel free to use this in your projects!

---

> ⭐ **Don't forget to [star this repo](https://github.com/codingstark-dev/domainfinder-mcp) if you find it helpful!** ⭐