Installation

Installation

Two ways to use domain-mcp:

1. Hosted remote MCP (no install) — https://domain-mcp.gietmanic.com/mcp
2. Local / self-hosted — source, Docker, or your own deploy

For full client-by-client remote setup (Cursor, Claude Desktop, VS Code, Windsurf, …), see the README § Install remote MCP or Configuration.

Hosted (recommended)

https://domain-mcp.gietmanic.com/mcp

Health: https://domain-mcp.gietmanic.com/health

Minimal config (clients with native HTTP MCP):

{
  "mcpServers": {
    "domain-mcp": {
      "url": "https://domain-mcp.gietmanic.com/mcp"
    }
  }
}

Stdio-only clients (Claude Desktop, etc.):

{
  "mcpServers": {
    "domain-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://domain-mcp.gietmanic.com/mcp"]
    }
  }
}

Claude Code:

claude mcp add --transport http domain-mcp https://domain-mcp.gietmanic.com/mcp

Requirements (local)

• Python 3.11+ (source install)
• Network access to public RDAP and WHOIS servers
• Optional: Docker / uv / Node 18+ (for mcp-remote)

From source

git clone https://github.com/danielgtmn/domain-mcp.git
cd domain-mcp
uv sync
uv run domain-mcp

With pip:

pip install -e .
domain-mcp

Docker

HTTP (default):

docker pull ghcr.io/danielgtmn/domain-mcp:latest
docker run --rm -p 8000:8000 ghcr.io/danielgtmn/domain-mcp:latest
# http://localhost:8000/mcp

stdio:

docker run -i --rm -e MCP_TRANSPORT=stdio ghcr.io/danielgtmn/domain-mcp:latest

See Docker for tags and Coolify hosting.

Verify

Hosted:

curl -sS https://domain-mcp.gietmanic.com/health

Local library:

uv run python -c "
from domain_mcp.checker import DomainChecker
print(DomainChecker().check('example.com').to_dict())
"

You should see status: registered for example.com.