dns-gate
OfficialIntegrates with Porkbun’s DNS API so agents can read DNS records for granted domains and propose record changes; changes are applied only after a person reviews and accepts them, with stale-change detection and post-apply readback verification.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
dns-gate
Agents read DNS and propose changes. A person accepts them before they go live.
Most DNS providers hand out API tokens that can do everything on the account, so an AI agent cannot safely hold one. dns-gate holds the provider credentials itself and gives each agent its own, much weaker identity: it can read the records of the domains it is granted and propose changes, and that is all. A proposal changes nothing. A person signs in to dns-gate's web page with Google, reads the proposal and accepts or rejects it; only an accept writes to the provider.
Several providers: Porkbun and Domeneshop today; the provider layer is small to extend.
Domain groups: domains are put in groups, and each agent and each person is granted groups. Outside its groups a domain does not exist for that principal.
No silent overwrites: accepting re-reads the live records first. If any record the proposal touches changed after the proposal was made, nothing is applied and the proposal is marked stale.
Read back: after applying, dns-gate reads the records again and marks the proposal failed if they do not match, so a provider's "OK" is not taken on trust.
Audit log: every proposal, decision and outcome is recorded with who and when.
Status: first version. Records of type A, AAAA, CNAME, MX, TXT, SRV and NS can be changed; other types and HTTP forwards are shown but read-only.
How it fits together
agent ──MCP (bearer token)──▶ dns-gate ──provider API──▶ Porkbun / Domeneshop
person ──web page (Google sign-in)──▶ dns-gatedns-gate must run where agents cannot read its config directory or credential files. An agent that can read the provider credentials can bypass dns-gate entirely, so running it as a local MCP server next to the agent would defeat the point. Run it as a service on a separate machine or container.
Related MCP server: ZoneMender
Running it
Requires Node.js 22.18 or newer (it runs the TypeScript sources directly) and no build step.
npm ci
node src/cli.ts new-token # an agent token, plus the hash for the config
node src/cli.ts check-config --config cfg.json # validate, and test each provider's credentials (reads only)
node src/cli.ts serve --config cfg.jsonPut dns-gate behind a TLS-terminating reverse proxy, and set publicUrl to the URL people open.
Config
{
"listen": { "host": "127.0.0.1", "port": 8787 },
"publicUrl": "https://dns-gate.example.com",
"database": "/var/lib/dns-gate/dns-gate.db",
"providers": {
"porkbun": { "type": "porkbun", "credentialsFile": "/etc/dns-gate/porkbun.json" },
"domeneshop": { "type": "domeneshop", "credentialsFile": "/etc/dns-gate/domeneshop.json" }
},
"domains": { "example.rocks": "porkbun", "example.no": "domeneshop" },
"groups": { "homelab": ["example.rocks"], "company": ["example.no"] },
"agents": [{ "id": "my-agent", "tokenSha256": "<from new-token>", "groups": ["homelab"] }],
"people": [{ "email": "me@example.com", "groups": ["homelab", "company"] }],
"oidc": {
"issuer": "https://accounts.google.com",
"clientId": "<Google OAuth client id>",
"clientSecretFile": "/etc/dns-gate/google-client-secret"
}
}The config holds no secrets. Agents are listed by the SHA-256 of their token; credentials are in the files it names, which should be readable only by the dns-gate service user.
A domain is managed only if it is listed under
domains. Others on the same account are invisible.Unknown keys are refused, and
check-configreports every problem at once.
Credential files:
Provider | File contents | Where to get it |
Porkbun |
| Account → API Access. Also switch API access on for each domain. |
Domeneshop |
| domeneshop.no/admin?view=api |
Google sign-in: create an OAuth client of type Web application in a Google Cloud project, with the
redirect URI <publicUrl>/auth/callback. dns-gate asks only for openid email and refuses an
address Google has not verified, or one not listed under people.
Connecting an agent
Claude Code:
claude mcp add --transport http dns-gate https://dns-gate.example.com/mcp \
--header "Authorization: Bearer <agent token>"Tools: list_domains, list_records, list_forwards, propose_change, list_proposals,
get_proposal, withdraw_proposal. There is no tool to accept or reject.
Development
npm test # unit and HTTP tests, no network
npm run typecheckRuntime dependency: openid-client (for Google sign-in) only. The MCP endpoint is a small
hand-written JSON-RPC handler rather than the MCP SDK, to keep the dependency tree of a service that
holds DNS credentials short. SQLite comes from Node itself (node:sqlite).
License
Apache License 2.0. See LICENSE.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Zendesk configuration management for AI agents: propose, review, apply and roll back changes.
Connect custom domains via AI agents: DNS pre-flight checks, hand-off connect sessions and checks.
Agent-first domain registration and DNS management, paid with USDC via x402.
Human-in-the-loop review and approval for AI agents. Audit trail, approval policies, native MCP.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to check domain availability, purchase domains via Stripe, and perform full DNS and nameserver management. It facilitates automated domain lifecycle tasks like record updates and transfer locks without requiring CAPTCHAs.MIT
- AlicenseNot gradedqualityBmaintenanceMCP server for AI agents to safely manage Cloudflare DNS, DMARC, SPF, BIMI, and Email Routing with dry-run-first and approval-based writes.10MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for reading and changing DNS records via the Spaceship API, with reviewable two-step confirmation and safety restrictions. It exposes only safe DNS operations, using domain allowlisting and failing closed when not configured.128 npmMIT
- AlicenseAqualityBmaintenanceOne MCP server holding a live session with every client's account at once, so one agent can read across a dozen businesses and write inside only the one you name. It forwards each provider's own MCP tools (Cloudflare, Vercel, Resend, Supabase, Linear, Notion, Sentry, Netlify and more) with that client's credentials, and adds deterministic DNS and email checks that never call a model.1618 PyPI6MIT