Use DNS Doctor from GitHub's MCP registry
DNS Doctor is listed in GitHub's MCP registry. Install it in VS Code or the GitHub Copilot app, then check and fix a domain's email authentication (SPF, DMARC, DKIM), propagation and DNS health from a chat. Free checks need no account.
Install it
- Open DNS Doctor - Email & DMARC in GitHub's MCP registry.
- Choose Install MCP server, then Install in VS Code, Install in VS Code Insiders or Install in GitHub Copilot app.
- Ask about your own domain in the chat, for example “Why does mail from my domain land in spam?”
The listing installs @dnsdoctor/mcp, a small open-source (Apache-2.0) server that runs on your machine and needs Node 20 or newer. It calls the public DNS Doctor API and has the same tools as the hosted server. Its source is on GitHub.
Add it by hand
If your client reads an mcpServers file, add this:
{
"mcpServers": {
"dns-doctor": {
"command": "npx",
"args": ["-y", "@dnsdoctor/mcp"]
}
}
}To run exactly the version you checked, add @ and the version number after the name, as the GitHub listing does: @dnsdoctor/mcp@<version>.
If your client supports remote servers, skip the install and use the hosted server instead. Nothing to install, no keys:
{
"mcpServers": {
"dns-doctor": {
"type": "http",
"url": "https://dnsdoctor.dev/mcp"
}
}
}What works without an account
Every check and lookup is free and needs no token:
- A full domain scan and its report: SPF, DMARC, DKIM, MX, DNS health, blacklists, and domain and SSL expiry.
- SPF: the DNS lookup count against the limit of 10, and an audit of every include (who can send as your domain).
- DMARC: check a record, generate one for a domain that has none, and the next policy step when the evidence supports it.
- DKIM: check a specific selector and its key.
- Propagation: whether a DNS change has reached resolvers around the world, and a quick read of any single record.
- Reverse DNS for a mail server IP.
- WHOIS and registration: registrar, expiry date, locks and nameservers.
- Lookalike domains: which close variants of your name resolve and accept mail.
- DMARC aggregate reports: upload one and get it in readable form.
- A protection pack for a domain that sends no mail.
- Email test: get an address, send it one real email, and see how that message authenticated, scored out of 10.
- BIMI: whether your logo can show in the inbox, mailbox by mailbox.
What needs your DNS Doctor account
- Add a domain to monitoring and get the ownership record to publish.
- Check whether that record is visible yet and mark the domain verified.
- Get the records a monitored domain still needs.
- Read your alerts, DMARC readiness and lookalike watches.
- List your earlier email tests and their results.
These need a token. Create one at dnsdoctor.dev under Settings → API tokens and add it to the server's entry, next to args:
"env": {
"DNSDOCTOR_API_TOKEN": "dnsd_..."
}The server sends it only to dnsdoctor.dev. Never commit it to a repository. A new account starts with a 14-day free trial, no card required.
What it can and can't do
- It never changes your DNS. You publish every record yourself.
- Every record it shows comes from DNS Doctor's record engine, not written by AI.
- You can revoke the token any time: in DNS Doctor, open Settings → API tokens.
What is sent to DNS Doctor
The domains you ask about are sent to dnsdoctor.dev. A domain scan saves a public report page for that domain, which anyone with the link can open. Details are in the privacy policy.
If something goes wrong
- The tools never show up
- The server needs Node 20 or newer. Run
node --versionin a terminal, or use the hosted server above, which needs no install. - Something else
- Email hello@dnsdoctor.dev and say what you saw.
Scan your domain
Check SPF, DMARC, DKIM, MX, DNS health, blacklists and domain & SSL expiry in one free scan, with the exact record to paste for each problem it finds.
GitHub, GitHub Copilot and VS Code are trademarks of their owners. DNS Doctor is listed in GitHub's MCP registry and is not affiliated with or endorsed by GitHub.