# dns-aid

MCP server discovers and publishes AI agents using DNS SVCB records without centralized registries. Useful for connecting distributed tools through standard domain names.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 73
- Author: dns-aid
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dns-aid/dns-aid-core
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/dns-aid

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `DNS_AID_BACKEND` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env DNS_AID_BACKEND=<DNS_AID_BACKEND> --transport stdio dns-aid -- uvx dns-aid
```
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>

### Codex

**Platform CLI**
```bash
codex mcp add dns-aid --env DNS_AID_BACKEND=<DNS_AID_BACKEND> -- uvx dns-aid
```
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>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e DNS_AID_BACKEND=<DNS_AID_BACKEND> dns-aid uvx dns-aid
```
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>

## When to use it
- 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
- Find available MCP agents at `example.com` using dns-aid.
- Check the DNS records and security score for `agent.example.com`.
- Publish a new MCP agent under domain `example.com`.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md