# onlydns-mcp [Verified owner] [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/Onlydns/onlydns-mcp  
**GitHub Stars:** 0  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/onlydns-mcp

## Description
Official MCP server for OnlyDNS that lets AI agents inspect and manage DNS zones, records, DNSSEC, and TSIG keys.

## Tools
Capabilities this server exposes over MCP:

- **A**
- **CNAME**
- **MX**
- **TXT**
- **URL**
- **PROXY**
- **hmac-sha256**
- **hmac-sha512**

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "onlydns-mcp": {
    "command": "npx",
    "args": ["-y","@onlydns/mcp"],
    "env": {
      "ONLYDNS_API_TOKEN": "",
      "ONLYDNS_API_BASE_URL": ""
    }
  }
}
```

**Requires environment variables:** `ONLYDNS_API_TOKEN`, `ONLYDNS_API_BASE_URL` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What onlydns-mcp does

onlydns-mcp exposes OnlyDNS account and zone administration through the Model Context Protocol. Agents can enumerate managed domains, create DNS zones, inspect records, and modify individual records or complete record sets. Record operations support filtering by record type or hostname and cover common types such as A, AAAA, CNAME, MX, TXT, SRV, CAA, URL, and PROXY.

The server also provides DNSSEC controls and TSIG key management. Agents can inspect DNSSEC state and retrieve DS or DNSKEY data, enable or disable signing, list and retrieve TSIG keys, generate keys with supported HMAC algorithms, and assign transfer or update permissions to domains.

## How it works

The package runs as an MCP process and communicates with the OnlyDNS REST API using a bearer token. A client starts the package with `npx -y @onlydns/mcp` or invokes a globally installed executable. The default API endpoint is `https://api.onlydns.com/v1`; deployments can provide a different base URL through configuration.

Domain and record changes are exposed as separate MCP operations. Records can be added, updated, deleted, or replaced in batches. TSIG configuration can permit AXFR transfers, RFC 2136 dynamic updates, and optional restrictions for subdomains.

## Setup and configuration

Install the package globally:

```bash
npm install -g @onlydns/mcp
```

Alternatively, run it without a permanent installation:

```bash
export ONLYDNS_API_TOKEN="your_onlydns_api_token"
npx -y @onlydns/mcp
```

The required `ONLYDNS_API_TOKEN` value is an OnlyDNS API bearer token. `ONLYDNS_API_BASE_URL` can override the default REST API base URL. MCP clients that launch commands can register the package with `npx`, pass `-y` and `@onlydns/mcp` as arguments, and provide the token in the process environment.

An MCPB bundle is also available from the project's GitHub Releases page for compatible desktop clients. Claude Desktop can be configured with an `mcpServers` entry that launches the package and supplies the token.

## Tools and capabilities

- List managed domains with optional pagination and create new DNS zones.
- Query records by domain, record type, or hostname.
- Add, append, update, delete, or batch-replace DNS records.
- Inspect DNSSEC status and retrieve DS and DNSKEY records.
- Enable or disable DNSSEC signing for a zone.
- List TSIG keys, retrieve key details, and create keys using algorithms such as `hmac-sha256` and `hmac-sha512`.
- Read or change domain TSIG permissions, including AXFR, dynamic DNS updates, and optional subdomain limits.

## Limitations and notes

DNS changes and security-setting changes require an OnlyDNS bearer token with suitable account permissions. Batch replacement through `set_records` affects the full record set for a zone, so it should be used with an intentional complete record definition. TSIG configuration controls transfer and update permissions but does not itself perform a zone transfer or dynamic update.

The package is licensed under MIT. Its documented client configurations cover Claude Desktop, Cursor, Windsurf, and Claude Code.

_Full upstream README: https://allmcps.com/mcp/onlydns-mcp/readme_

