DNSFix API and MCP server
Check a domain's email and website DNS from your own scripts, dashboards or AI assistant. It's read-only: nothing here changes DNS. Fixes stay with you, using the step-by-step fix guide.
1. Get a key
Sign in and open Settings > API keys. Each key is shown once, so copy it then. We keep only a fingerprint of it.
- Free: scan any domain, 50 scans a day per key.
- Pro: 500 scans a day, plus 5000 reads a day of your watched domains, alerts, grade history and DMARC summaries.
Limits reset at midnight UTC. Send the key in the Authorization: Bearer dnsf_… header, never in a link.
2. REST API
2. REST API: what this panel shows and what you can change here.| Call | What it returns | Plan |
|---|---|---|
GET /v1/scan?domain=example.com | Grade, score and every check, with the records to change | Free |
GET /v1/domains | Your watched domains with the latest grade | Pro |
GET /v1/domains/{domain} | The latest full check for one domain | Pro |
GET /v1/domains/{domain}/history?days=30 | Grade and score over time | Pro |
GET /v1/domains/{domain}/dmarc?days=30 | Who sends email as you, and how much passes | Pro |
GET /v1/alerts?domain=&since=2026-11-01&limit=20 | Recent alerts, newest first | Pro |
curl -H "Authorization: Bearer dnsf_YOUR_KEY" "https://app.dnsfix.com/v1/scan?domain=example.com"
Errors come back as {"error": "…"} with 400 (bad input), 401 (missing or wrong key), 403 (needs Pro), 404 (not one of your domains) or 429 (daily limit).
3. MCP server for AI assistants
Point any MCP client that supports remote (HTTP) servers at https://app.dnsfix.com/mcp. The free check tools need no key (about 20 an hour). AI chat apps connect your account with a sign-in (OAuth); see DNSFix in your AI assistant. Other tools can send your key in the Authorization header. For example:
{
"mcpServers": {
"dnsfix": {
"type": "http",
"url": "https://app.dnsfix.com/mcp",
"headers": {
"Authorization": "Bearer dnsf_YOUR_KEY"
}
}
}
}
Tools (all read-only):
scan_domain: Checks a domain's public DNS for email and website problems (SPF, DKIM, DMARC, MX, SSL, expiry and more). Returns the grade, the top problems in plain words, the record to paste for the first fix, and a link to the full DNSFix report. Public data only; no sign-in needed.check_record: Tests a DNS record someone gave you (from a chatbot, a DNS host or a web person) against the domain's live records before it is published: SPF lookups and dropped senders, DMARC that would block your own mail, DKIM keys, MX moves, CNAME clashes. Says safe, careful or stop. Never publishes anything.check_spf: Reads a domain's SPF record and counts its DNS lookups against the limit of 10, with void lookups, includes and other mistakes in plain words.check_dmarc: Reads a domain's DMARC record: the policy, every tag explained, and what to change.check_dkim: Finds a domain's DKIM keys at the usual selector names (or the one you give) and checks key type, length, hash and test mode.check_propagation: Asks six big public DNS services (US, Europe and Asia) for the same record and says whether a change has reached them, and how long older copies last.lookup_dns: Looks up one record type for a name, with each record's time to live and whether it is signed with DNSSEC.build_dmarc_record: Writes a DMARC record for a domain as text, with where to add it and what each part does. It is never published: the domain owner adds it at their DNS host.list_domains: Lists the domains your DNSFix account watches, with the latest grade and expiry dates. Needs a connected DNSFix account with domain watching.get_domain: The latest check for one of your watched domains: grade, top problems and the record to paste. Needs a connected DNSFix account with domain watching.get_alerts: Recent alerts (changes, problems, expiry warnings, things resolved) for your watched domains, newest first. Needs a connected DNSFix account with domain watching.get_history: Grade and score over time for one of your watched domains. Needs a connected DNSFix account with domain watching.get_dmarc_summary: Who sent email as your domain (from DMARC reports) and how much passed SPF or DKIM. Needs a connected DNSFix account with domain watching.
Your AI assistant's own provider sees what it sends and receives. Only connect a key to assistants you trust. You can revoke a key any time in Settings.
Fair use
Use the API for domains you own or look after, or to check a domain before you work with it. Don't resell raw results, and don't use it to probe sites at scale. Keys that do get revoked. Questions: support@dnsfix.com.