# AgentDomainService MCP Server
An [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that enables AI assistants like Claude to check domain availability in real-time. Powered by [AgentDomainService.com](https://agentdomainservice.com).
## Why This Exists
**The Problem:** AI assistants can't help you check if a domain is available. Traditional registrars like GoDaddy and Namecheap block automated access with CAPTCHAs and bot detection.
**The Solution:** [AgentDomainService](https://agentdomainservice.com) provides a simple API that AI can use. This MCP server wraps that API so Claude and other MCP-compatible assistants can check domains directly.
## Features
- **Price Filtering** - Find domains within your budget (e.g., under $15)
- **Category Search** - Browse domains by category (AI agents, startups, e-commerce, etc.)
- **AI Brainstorming** - Describe your project and get creative domain suggestions that are actually available
- **Domain Analysis** - AI-powered scoring for memorability, brandability, and SEO potential
- **Check any domain** - Verify if `yourproject.com`, `startup.io`, or `brand.ai` is available
- **Explore names across TLDs** - See availability for `.com`, `.io`, `.ai`, `.co`, `.dev`, `.app`, `.net`, `.xyz`, `.org` at once
- **Real pricing** - See actual purchase and renewal prices from Name.com (not just WHOIS/DNS checks)
- **No API keys required** - Just install and use
- **No CAPTCHAs** - [AgentDomainService](https://agentdomainservice.com) handles all the complexity
## Installation
### For Claude Desktop
Add this to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
```json
{
"mcpServers": {
"domain-availability": {
"command": "npx",
"args": ["-y", "agent-domain-service-mcp"]
}
}
}
```
Then restart Claude Desktop.
### Manual Installation
```bash
npm install -g agent-domain-service-mcp
```
## Available Tools
### `check_domain`
Check if a specific domain is available for registration.
**Example prompts:**
- "Is example.com available?"
- "Check if myawesomestartup.io is taken"
- "What's the price for coolproject.ai?"
**Returns:**
- Availability status (available/registered/unknown)
- Purchase price in USD
- Renewal price per year
- Whether it's a premium domain
- Alternative suggestions if the domain is taken
### `explore_name`
Explore a name across multiple TLDs to find available options.
**Example prompts:**
- "What TLDs are available for 'acmewidgets'?"
- "Explore domain options for 'nextstartup'"
- "Which extensions can I get for 'brandname'?"
**Returns:**
- Availability across 9 popular TLDs
- Pricing for each available option
- Summary of available vs taken
### `brainstorm_domains`
Generate creative domain name ideas based on a description of your project. **This is what makes this MCP different** - it uses AI to suggest names AND verifies they're actually available with real pricing.
**Example prompts:**
- "I need a domain for an AI-powered recipe app for busy parents"
- "Brainstorm domain names for a sustainable fashion marketplace"
- "Find me available domains for a developer tools startup focused on API testing"
**Returns:**
- 10+ creative domain suggestions
- Only domains that are actually available
- Real purchase prices from Name.com
- Premium domain indicators
### `analyze_domain`
Get an AI-powered analysis of any domain name to help you decide if it's a good choice.
**Example prompts:**
- "Analyze coolstartup.com - is it a good domain?"
- "What do you think of neuralflow.ai as a domain name?"
- "Score brandify.io for brandability and memorability"
**Returns:**
- Scores (0-10) for: Memorability, Brandability, Pronunciation, SEO Potential
- List of pros and cons
- Overall verdict and recommendation
- Availability status and pricing
### `search_domains` ⭐ NEW
Search for available domains with filters. Perfect for finding affordable domains within a budget.
**Example prompts:**
- "Find me domains under $15"
- "Show me available AI agent domains under $20"
- "What startup domains are available for under $10?"
- "Find cheap .com domains"
**Parameters:**
- `category` - Filter by category (e.g., 'ai-agents', 'startup-names', 'ecommerce')
- `max_price` - Maximum price in USD (e.g., 15 for under $15)
- `min_price` - Minimum price in USD (optional)
- `tlds` - Filter by TLDs (e.g., ['com', 'io'])
- `sort` - Sort by 'price_asc', 'price_desc', or 'newest'
- `limit` - Number of results (default: 20, max: 100)
**Returns:**
- List of available domains with pricing
- Sorted by price (cheapest first by default)
- Category tags for each domain
### `list_categories` ⭐ NEW
List all available domain categories with their domain counts. Use this to discover what categories are available before searching.
**Example prompts:**
- "What domain categories are available?"
- "Show me all the categories I can search"
- "How many AI domains do you have?"
**Returns:**
- All categories with domain counts
- Category descriptions
- Total available domains
## Example Usage
Once installed, you can ask Claude:
> "Find me a domain under $15 for my AI startup"
Claude will use `search_domains` with `max_price=15` to find affordable domains, sorted by price.
> "I'm building an app that helps remote teams do async standups. Can you brainstorm some domain names?"
Claude will use the `brainstorm_domains` tool to generate creative suggestions like `asynchuddle.com`, `standupflow.io`, etc. - all verified as available with real pricing.
> "I'm starting a new AI company called 'NeuralFlow'. Can you check which domain options are available?"
Claude will use the `explore_name` tool to check `neuralflow.com`, `neuralflow.io`, `neuralflow.ai`, etc. and show you which are available with pricing.
> "What categories of domains do you have available?"
Claude will use `list_categories` to show all domain categories with counts.
> "What do you think of 'quickpulse.ai' as a domain? Is it any good?"
Claude will use `analyze_domain` to score it on memorability, brandability, and SEO potential, then give you pros/cons and a verdict.
## How It Works
```
┌─────────────┐ ┌─────────────────┐ ┌─────────────────────────┐
│ Claude │─────▶│ MCP Server │─────▶│ AgentDomainService.com │
│ Desktop │◀─────│ (this package) │◀─────│ (Name.com API) │
└─────────────┘ └─────────────────┘ └─────────────────────────┘
```
1. You ask Claude about a domain
2. Claude calls this MCP server
3. The server queries [AgentDomainService.com](https://agentdomainservice.com)
4. Results are returned to Claude
5. Claude presents the information to you
## API Endpoints Used
This MCP server uses the [AgentDomainService API](https://agentdomainservice.com/docs/domain-availability-api):
- `GET /api/v1/lookup/{domain}` - Check a single domain
- `GET /api/v1/explore/{name}` - Explore a name across TLDs
- `GET /api/v1/domains/search` - Search with price/category filters ⭐ NEW
- `GET /api/v1/domains/categories` - List available categories ⭐ NEW
- `POST /api/v1/brainstorm` - AI-powered domain name generation
- `POST /api/v1/analyze-domain` - AI-powered domain analysis
Full API documentation: [agentdomainservice.com/docs/domain-availability-api](https://agentdomainservice.com/docs/domain-availability-api)
## Related Resources
- **Main Website:** [agentdomainservice.com](https://agentdomainservice.com)
- **API Documentation:** [agentdomainservice.com/docs/domain-availability-api](https://agentdomainservice.com/docs/domain-availability-api)
- **LLM Instructions:** [agentdomainservice.com/llms.txt](https://agentdomainservice.com/llms.txt)
- **OpenAPI Spec:** [agentdomainservice.com/openapi.json](https://agentdomainservice.com/openapi.json)
- **Blog:** [agentdomainservice.com/blog](https://agentdomainservice.com/blog)
## Use Cases
- **Startup founders** brainstorming names for their next venture
- **Developers** automating domain availability checks
- **Brand managers** monitoring domain availability
- **Domain investors** researching opportunities
- **Anyone** who wants to check domains without CAPTCHAs
## Troubleshooting
### "Tool not found" error
Make sure Claude Desktop is restarted after adding the config.
### Slow responses
[AgentDomainService](https://agentdomainservice.com) caches results. First queries may take 1-2 seconds; subsequent queries for the same domain are faster.
### Rate limiting
The service is free and doesn't require authentication. We ask for reasonable use. If you hit rate limits, results will show `status: unknown`.
## Contributing
Issues and PRs welcome! This project is open source.
## License
MIT
---
Built with [AgentDomainService.com](https://agentdomainservice.com) - Domain availability checking for AI agents.
