dns-aid — Claude Code MCP server: what it does, how to install
MCP server discovers and publishes AI agents using DNS SVCB records without centralized registries. Useful for connecting distributed tools through standard domain names.
claude mcp add --env DNS_AID_BACKEND=<DNS_AID_BACKEND> --transport stdio dns-aid -- uvx dns-aidWhat dns-aid does
The server runs on standard DNS. Instead of relying on private registries or static addresses, it discovers agents through SVCB records. A client queries a domain and instantly gets reachable endpoints with supported protocols.
The tooling handles both publishing and record verification. It checks authenticity via DNSSEC and DANE, then filters endpoints by supported authorization methods. When searching across multiple domains, it can query external HTTP catalogs.
Publishing records requires setting the DNS_AID_BACKEND environment variable for your DNS provider. Without valid DNS credentials, write operations will fail.
What it helps with
- publish agent endpoints to DNS via SVCB records
- discover remote agents using domain names
- verify DNS records and security parameters
- filter agent services by protocols and auth types
Example prompts for the agent
- Find available MCP agents at
example.comusing dns-aid. - Check the DNS records and security score for
agent.example.com. - Publish a new MCP agent under domain
example.com.
How to install dns-aid
Platform CLI
claude mcp add --env DNS_AID_BACKEND=<DNS_AID_BACKEND> --transport stdio dns-aid -- uvx dns-aidReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from dns-aid <command>
Platform CLI
codex mcp add dns-aid --env DNS_AID_BACKEND=<DNS_AID_BACKEND> -- uvx dns-aidReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from dns-aid <command>
Config file
{
"mcpServers": {
"dns-aid": {
"command": "uvx",
"args": [
"dns-aid"
],
"env": {
"DNS_AID_BACKEND": "<DNS_AID_BACKEND>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from dns-aid <command>
Config file
{
"servers": {
"dns-aid": {
"type": "stdio",
"command": "uvx",
"args": [
"dns-aid"
],
"env": {
"DNS_AID_BACKEND": "<DNS_AID_BACKEND>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from dns-aid <command>
Platform CLI
gemini mcp add -e DNS_AID_BACKEND=<DNS_AID_BACKEND> dns-aid uvx dns-aidReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from dns-aid <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about dns-aid
How to install dns-aid in Claude Code?
Run claude mcp add dns-aid -- uvx dns-aid in your terminal.
What does dns-aid do?
It lets AI agents discover and publish service endpoints using DNS SVCB records. Agents communicate without relying on centralized registries or hardcoded addresses.
Which DNS providers are supported for publishing?
The tool supports cloudflare, route53, ns1, cloud_dns, infoblox, akamai-edgedns, and ddns. You configure your provider by setting the DNS_AID_BACKEND environment variable.
