MCP Server

The RobotDomainSearch MCP server gives AI agents the ability to search, check, and look up domain information through the Model Context Protocol — an open standard for connecting AI applications to external tools.

Installation

Install globally via npm:

npm install -g @robotdomainsearch/mcp

Or run directly with npx (no install required):

npx @robotdomainsearch/mcp

Client Setup

Claude Desktop

Add to your claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "robotdomainsearch": {
      "command": "npx",
      "args": ["-y", "@robotdomainsearch/mcp"],
      "env": {
        "ROBOTDOMAINSEARCH_API_KEY": "your-api-key"
      }
    }
  }
}

Restart Claude Desktop after saving.

Cursor

Add to your MCP settings in Cursor (Settings → MCP):

{
  "robotdomainsearch": {
    "command": "npx",
    "args": ["-y", "@robotdomainsearch/mcp"]
  }
}

Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": {
    "robotdomainsearch": {
      "command": "npx",
      "args": ["-y", "@robotdomainsearch/mcp"],
      "env": {
        "ROBOTDOMAINSEARCH_API_KEY": "your-api-key"
      }
    }
  }
}

Generic MCP Client

Any MCP-compatible client can connect using:

  • Command: npx
  • Args: ["-y", "@robotdomainsearch/mcp"]
  • Transport: stdio

Available Tools

The MCP server exposes 4 tools:

  • check_domain — Check if a single domain is available for registration
  • bulk_check — Check multiple domains at once across different TLDs
  • list_tlds — Get all 511+ supported top-level domains
  • get_registration_link — Get registrar links to register available domains

Note: WHOIS, Domain Intel, Auctions, Aftermarket, Name Search Presence, and ENS lookups are not yet available via MCP. Use the REST API for these endpoints.

Environment Variables

Variable Description Required
ROBOTDOMAINSEARCH_API_KEY Your API key for authenticated requests No (free during beta)

Example Prompts

Once configured, you can ask your AI assistant things like:

  • “Check if mycoolstartup.com is available”
  • “Find me an available .dev domain for ‘aitools’”
  • “Check these domains: startup.io, startup.co, startup.dev”
  • “What TLDs are available in the technology category?”

Troubleshooting

Server not connecting

  1. Make sure Node.js 18+ is installed: node --version
  2. Verify npx works: npx @robotdomainsearch/mcp --help
  3. Check your client’s MCP log for error messages
  4. Restart your AI client after configuration changes

Tools not appearing

  1. Confirm the server is listed in your client’s MCP settings
  2. Some clients require a restart to pick up new MCP servers
  3. Check that the JSON configuration is valid (no trailing commas)

Rate limiting

During beta, all requests are limited to 60/minute. Set ROBOTDOMAINSEARCH_API_KEY to increase limits.

Next Steps