Domainr

Provides domain search, availability checks, and registration links via an MCP server using the Domainr API.

python

0

GitHub Stars

python

Language

3 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run the Domainr MCP Server locally to search domains, check availability, and generate registration links through a flexible MCP client workflow. It supports asynchronous domain operations and can be configured with your Domainr API key for real API access.

How to use

You will run the MCP server locally or via your MCP client, then use supported tools to perform domain searches, check statuses, and obtain registration URLs. The server exposes three primary tools you can invoke through your MCP client: search_domains, check_domain_status, and register_domain. Use these tools to compose end-to-end workflows such as finding suitable domain options, verifying their availability, and obtaining direct registration links.

How to install

Prerequisites: ensure you have Python installed (3.x) and a compatible MCP client environment. You can also use modern package managers that support running MCP servers.

Option 1: Use the uvx runtime (recommended — no installation required) to start the MCP server directly.

uvx domainr-mcp-server

Option 2: Install with uv tool and run the MCP server through uvx as a client.

uv tool install domainr-mcp-server

Option 3: Install via pip and run the MCP server locally.

pip install domainr-mcp-server

After installation, run the server locally depending on your approach.

python -m domainr_mcp_server.server

Configuration and usage notes

You must provide a Domainr API key to access the Domainr API. Set the environment variable DOMAINR_API_KEY in your shell before starting the MCP server.

Example environment variable setup if you are using a Unix-like shell.

export DOMAINR_API_KEY="your_api_key_here"

Example environment variable setup for Windows.

set DOMAINR_API_KEY=your_api_key_here

Client configuration examples

To integrate with a Claude Desktop client or uvx, configure the MCP client with the following structure so the client can call the server and pass the API key.

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

Security and best practices

Keep your API key secure. Do not commit it to code repositories. Use environment-specific configuration or secret management to inject the key at runtime.

Available tools

search_domains

Search for domain names with intelligent suggestions and filtering.

check_domain_status

Check availability status for specific domains.

register_domain

Get registration URLs for domains.