Domainr

PyPI version Python 3.8+

A Model Context Protocol (MCP) server that provides domain search and availability checking functionality using the Domainr API. Perfect for AI assistants and domain research workflows.

Features

• 🔍 Domain Search - Search for domains with intelligent suggestions
• ✅ Availability Checking - Check if domains are available for registration
• 🌐 Registration URLs - Get direct links to register domains
• 🎯 Advanced Filtering - Filter by registrar, keywords, and location
• ⚡ Async Performance - Built with modern async Python

Installation

Option 1: uvx (Recommended - No Installation Required)

uvx domainr-mcp-server

Option 2: uv (Modern Package Manager)

uv tool install domainr-mcp-server

Option 3: pip (Traditional)

pip install domainr-mcp-server

Setup

1. Get a Domainr API Key

1. Sign up at RapidAPI
2. Subscribe to the Domainr API
3. Copy your API key

2. Set Environment Variable

# Linux/macOS
export DOMAINR_API_KEY="your_api_key_here"

# Windows
set DOMAINR_API_KEY=your_api_key_here

3. Configure Your MCP Client

For Claude Desktop:

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "domainr": {
      "command": "domainr-mcp-server",
      "env": {
        "DOMAINR_API_KEY": "your_api_key_here"
      }
    }
  }
}

For uvx users:

{
  "mcpServers": {
    "domainr": {
      "command": "uvx",
      "args": ["domainr-mcp-server"],
      "env": {
        "DOMAINR_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

🔍 search_domains

Search for domain names with intelligent suggestions and filtering.

Parameters:

• query (required) - Search terms for domain names
• location (optional) - Country code for localized results (default: "us")
• registrar (optional) - Filter by registrar (e.g., "dnsimple.com")
• defaults (optional) - Always include specific TLDs (e.g., "com,org")
• keywords (optional) - Seed results with keywords (e.g., "tech,startup")

Example:

{
  "query": "awesome startup",
  "keywords": "tech,software",
  "defaults": "com,io"
}

✅ check_domain_status

Check availability status of specific domains.

Parameters:

• domains (required) - Comma-separated list of domains to check

Example:

{
  "domains": "example.com,example.io,example.org"
}

🌐 register_domain

Get registration URLs for domains.

Parameters:

• domain (required) - Domain name to register
• registrar (optional) - Preferred registrar

Example:

{
  "domain": "myawesomesite.com",
  "registrar": "dnsimple.com"
}

Usage Examples

Basic Domain Search

User: "Find domains for a coffee shop"
Assistant: [searches domains with coffee-related keywords]
→ Returns: coffeeshop.com, mycafe.coffee, brew.cafe, etc.

Availability Check

User: "Is example.com available?"
Assistant: [checks domain status]
→ Returns: example.com: active (not available)

Complete Workflow

User: "I need a domain for my tech startup"
Assistant: 
1. [searches with tech keywords]
2. [checks availability of top options]  
3. [provides registration links for available domains]

Development

Local Development

git clone https://github.com/danohn/domainr-mcp-server
cd domainr-mcp-server

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Linux/macOS
# or
venv\Scripts\activate     # Windows

# Install dependencies
pip install -r requirements.txt

# Run locally
python -m domainr_mcp_server.server

Testing

# Set your API key
export DOMAINR_API_KEY="your_test_key"

# Test the server
echo '{"method":"tools/list","params":{},"jsonrpc":"2.0","id":1}' | python -m domainr_mcp_server.server

API Reference

This server integrates with the Domainr API v2 endpoints:

• Search: /v2/search - Domain search with suggestions
• Status: /v2/status - Domain availability checking
• Register: /v2/register - Registration URL generation

---

Made with ❤️ for the MCP ecosystem