OnlyDNS MCP Server (@onlydns/mcp)
Official Model Context Protocol (MCP) server for OnlyDNS enabling AI agents (Claude Desktop, Cursor, Devin, LangChain) to inspect and manage DNS zones, records, 1-click DNSSEC, and TSIG keys directly. Learn more on the AI Agent Infrastructure solution page.
npm install -g @onlydns/mcp
Or run instantly: npx -y @onlydns/mcp
Authentication Environment Variable: ONLYDNS_API_TOKEN (see Configuration).
Features
- π Domain Management: List all managed domains and create new DNS zones.
- π DNS Record Operations:
list_records: Query DNS records with optional filtering by type (A, AAAA, CNAME, MX, TXT, SRV, CAA, etc.) or hostname.add_record: Create new records or append values to existing record sets with automatic domain normalization.update_record: Modify existing DNS records and update TTLs.delete_record: Delete specific record values or entire record sets.set_records: Batch replace full zone record sets.
- π DNSSEC Management: Inspect DNSSEC status, fetch DS/DNSKEY records, enable, and disable DNSSEC signing.
- π TSIG Keys: Generate and manage TSIG keys for secondary DNS zone transfers (AXFR) and RFC 2136 dynamic updates.
Installation & Quick Start
1. One-Click Desktop Installation (MCPB Bundle)
Download onlydns-mcp.mcpb directly from the GitHub Releases page. Compatible desktop clients (such as Claude Desktop) allow one-click installation and configure your ONLYDNS_API_TOKEN through a secure settings dialog.
2. Using npx (No installation needed)
You can run the server directly using npx:
export ONLYDNS_API_TOKEN="your_onlydns_api_token"
npx -y @onlydns/mcp
3. Global Installation
npm install -g @onlydns/mcp
Configuration
The server requires an OnlyDNS API Bearer Token.
Environment Variables
| Variable | Description | Default |
|---|---|---|
ONLYDNS_API_TOKEN | Your OnlyDNS API Bearer Token (Required) | - |
ONLYDNS_API_BASE_URL | OnlyDNS REST API base URL | https://api.onlydns.com/v1 |
Client Integration Examples
Claude Desktop
Add the following to your claude_desktop_config.json:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json
{
"mcpServers": {
"onlydns": {
"command": "npx",
"args": ["-y", "@onlydns/mcp"],
"env": {
"ONLYDNS_API_TOKEN": "YOUR_ONLYDNS_BEARER_TOKEN"
}
}
}
}
Cursor (or Windsurf / Claude Code)
Add to your MCP settings or .cursor/mcp.json:
{
"mcpServers": {
"onlydns": {
"command": "npx",
"args": ["-y", "@onlydns/mcp"],
"env": {
"ONLYDNS_API_TOKEN": "YOUR_ONLYDNS_BEARER_TOKEN"
}
}
}
}
Available MCP Tools
π Domains
list_domains(limit?, offset?): Lists all domains in the account.create_domain(domainName): Creates a new DNS zone for a domain.
π DNS Records
list_records(domainName, type?, name?): Lists DNS records for a domain, with optional filtering.add_record(domainName, name, type, value, ttl?): Adds/appends a DNS record (e.g.A,CNAME,MX,TXT,URL,PROXY).update_record(domainName, name, type, value, ttl?): Replaces values and/or TTL for a record type.delete_record(domainName, name, type, value?): Deletes a record or specific value.set_records(domainName, records): Batch replaces all records for a zone.
π DNSSEC
get_dnssec(domainName): Fetches DNSSEC status and keys (DS, DNSKEY).enable_dnssec(domainName): Enables DNSSEC signing for a zone.disable_dnssec(domainName): Disables DNSSEC signing.
π TSIG Keys
list_tsig_keys(): Lists all account TSIG keys.get_tsig_key(keyName): Retrieves TSIG key details.create_tsig_key(algorithm?): Generates a new TSIG key (hmac-sha256,hmac-sha512, etc.).get_domain_tsig(domainName): Retrieves TSIG keys and permissions configured on a domain.configure_domain_tsig(domainName, keyName, allowAxfr, allowDnsUpdate, subdomains?): Configures AXFR, DDNS, and optional subdomain restriction permissions for a domain.remove_domain_tsig(domainName): Removes all TSIG keys from a domain.
Development & Testing
# Clone and install dependencies
git clone https://github.com/Onlydns/onlydns-mcp.git
cd onlydns-mcp
npm install
# Run unit tests
npm test
# Build TypeScript
npm run build
# Run locally in development
npm run dev
License
MIT Β© 2026 OnlyDNS