A remote MCP server exposing a handful of name.ai's public, no-auth-required
APIs as tools: domain search/availability, WHOIS lookup, TLD registration
pricing, and TLD requirements. See
src/nameai_mcp/server.py for the tool definitions
and src/nameai_mcp/nameai_client.py for the
HTTP client that talks to name.ai.
Domain availability search, WHOIS lookup, TLD pricing and registry rules from name.ai. Read-only.
2026-10-19
Stars
—
Tools
4
Uptime
—
Endpoints
GET /health — health check.
POST /mcp (and GET /mcp for the SSE stream) — the MCP streamable-http
endpoint. This is the URL an MCP client/host connects to.
Configuration
NAMEAI_API_BASE_URL — base URL of the name.ai API this server calls.
Defaults to https://name.ai.
HOST / PORT — bind address for the server itself. Default 0.0.0.0:8000.
Local development
uv sync
uv run uvicorn nameai_mcp.app:app --reload
Docker
docker build -t nameai-mcp .
docker run -p 8000:8000 nameai-mcp
The image runs nameai-mcp (the main() entry point in
src/nameai_mcp/__init__.py), which reads
HOST/PORT from the environment — pass -e PORT=... if your platform
injects a different port.
Deploying
Any host that can run the Docker image works. It is deployed through Coolify
on the Hetzner server and served at https://mcp.name.ai/mcp
(streamable-http), with Traefik terminating TLS. The original hostname,
https://nameai-mcp.h.namekart.com/mcp, still routes to the same container, so
client configs written against it keep working.
mcp.name.ai is a DNS-only A record to the Hetzner box. It exists because
scanners and MCP tooling look for a server at mcp.<domain> instead of reading
the URL out of a manifest — ora's scanner was watched, in this container's own
access log, never dialling the manifest's mcpUrl during a scan. Adding a
hostname needs two things besides DNS: the domain on the Coolify app, and the
host appended to MCP_ALLOWED_HOSTS, without which the SDK's DNS-rebinding
guard answers it with 421.
The server calls the public API at NAMEAI_API_BASE_URL, default
https://name.ai. Since name.ai moved to Hetzner that resolves to the same
host this container runs on, so the calls leave the container, reach the
host's own public IP, and come back in through Traefik. That hairpin works
here and is left in place deliberately: talking to the API exactly the way an
outside client would is the point of this server.
Being reachable isn't the same as being discovered — and that part is done.
name.ai advertises this server in four places:
https://name.ai/.well-known/mcp.json — manifest
https://name.ai/.well-known/mcp/server-card.json — server card
https://name.ai/llms.txt — in both the endpoint list and the tool guidance
the MCP Registry, namespace ai.name, domain-verified
All four live in the nameaiv1 repo. If the deployed URL changes, they change
with it — otherwise agents keep being pointed at the old one.
Check whether a domain is available and, for the same label, whether its
common alternate TLDs are too (e.g. querying "acme.com" also returns
"acme.ai", "acme.io", ...).
Backed by POST /api/domain/search — public, no auth required.
Buy-now (aftermarket/marketplace) prices are hidde
Look up WHOIS/RDAP registration details for a domain: registrar,
registrant, creation/expiration dates, nameservers.
Backed by POST /api/tools/whois — public, no auth required, but rate
limited by name.ai to 10 lookups per day per caller IP. Since every MCP
call shares this server's
Get the current USD price for a domain-lifecycle operation on a TLD
(new registration, transfer-in, renewal, or restore from redemption).
Backed by GET /api/pricing/tld — public, no auth required. This is
name.ai's own registration pricing, not an aftermarket/marketplace price,
so i
Get registration requirements for a TLD: allowed registration period
range, whether an organization is required, allowed registrant
countries, nameserver rules, and similar registry policy.
Backed by GET /api/tlds/{tld}/metadata — public, no auth required.
Args:
tld: The TL
FAQ
Questions
How do I install Name.ai MCP Server?
Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
Does Name.ai MCP Server need an API key?
No required environment variable is listed on this record.
What transport does Name.ai MCP Server use?
Name.ai MCP Server is reached over HTTP.
When was Name.ai MCP Server last checked?
Last checked 2026-10-19. Domain availability search, WHOIS lookup, TLD pricing and registry rules from name.ai. Read-only.