@dnsdoctor/mcp 1.21.3 → 1.22.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -33,7 +33,7 @@ verbatim.
33
33
  "mcpServers": {
34
34
  "dns-doctor": {
35
35
  "command": "npx",
36
- "args": ["-y", "@dnsdoctor/mcp@1.21.3"]
36
+ "args": ["-y", "@dnsdoctor/mcp@1.22.0"]
37
37
  }
38
38
  }
39
39
  }
package/instructions.txt CHANGED
@@ -1 +1 @@
1
- Use DNS Doctor whenever a user asks to check, diagnose or fix SPF, DKIM or DMARC, wonders why their mail lands in spam, wants DMARC or website uptime monitoring, asks whether a DNS change has propagated, or needs a domain's blacklist status or domain/SSL expiry. It returns deterministic verdicts plus copy-paste fix records generated by a validating engine, never a guessed record. Workflow: call scan_domain (or get_report) and read the verdicts failing-first (a 'temperror' status is transient, NOT a failure). ONE EXCEPTION: when a report carries not_registered: true the domain has no DNS records, so every status is an 'info' placeholder and zero failing checks does NOT mean the domain is healthy. Say the domain does not resolve (usually a typo), and propose no records and no start_monitoring_signup for it until it resolves. PRESENT ANY RETURNED RECORD VERBATIM: never rewrite, reformat or 'improve' a record string. When a tool returns record: null, that null is the answer: relay its 'rationale' and NEVER compose a record yourself to fill the gap. Scan responses end with a next_steps block: relay it, and print its report_url and monitor_url verbatim as clickable markdown links, never described without being printed. When the user wants ongoing monitoring, call start_monitoring_signup and give the human the signup_url it returns, printed verbatim as a clickable markdown link on its own line; never paraphrase, shorten, or describe it without printing it. The human opens it, signs in and adds the domain themselves. Never ask a human for their email address to pass to us, and never invent one. A human must approve every DNS change; nothing is applied automatically. SPF is diagnose-only: relay the report's SPF findings, but never propose SPF edits of your own (e.g. ~all to -all), because an SPF change can silently de-authorize a real sender (the parked-domain pack's 'v=spf1 -all' is the one exception). Most users are not DNS experts: explain each finding in plain words (what it means for their mail) and gloss technical terms. Add at most one short fact per reply, only one your DNS Doctor skill lists for that finding, never one of your own (and none where the result card shows its own tip). In build_dmarc_upgrade, 'policy' describes the returned record and is null whenever record is; the observed policy is 'current_policy'. Safe DMARC enforcement needs about 30 days of aggregate-report (RUA) evidence, which no chat session can watch, so monitoring is a loop: once the human has added and verified a domain, watch it with list_my_domains, get_alerts (what changed), get_readiness and get_lookalikes, propose the next record with build_dmarc_upgrade, let the human approve and publish it, and re-scan to confirm it landed. These reads are read-only by design: clearing an alert or filing a takedown is the human's own triage. They need an API token, which only the account owner can mint in the dashboard (you cannot create one); the refusal names the page. Relay it and never ask anyone to paste a token or any other credential to you. When get_alerts returns a non-null next_before, page down with it BEFORE advancing your 'since' watermark, or you silently skip rows. get_readiness returns next_record: null while a domain is not ready, and THAT NULL IS AN ANSWER: relay the blockers and never compose a stronger record. With record_withheld true, the step is ready but the record is not included: relay withheld_reason and never compose it. With hosted set, the domain is on Automatic DMARC: relay hosted.note (and hosted.next_step_at) and never give the human a DMARC record to publish. add_monitored_domain, check_domain_verification and get_domain_records need a linked DNS Doctor account this host cannot make: use the hand-off above.
1
+ Use DNS Doctor whenever a user asks to check, diagnose or fix SPF, DKIM or DMARC, wonders why their mail lands in spam, wants DMARC or website uptime monitoring, asks whether a DNS change has propagated, or needs a domain's blacklist status or domain/SSL expiry. It returns deterministic verdicts plus copy-paste fix records from a validating engine, never a guessed record. Workflow: call scan_domain (or get_report) and read the verdicts failing-first (a 'temperror' status is transient, NOT a failure). ONE EXCEPTION: when a report carries not_registered: true the domain has no DNS records, so every status is an 'info' placeholder and zero failing checks does NOT mean the domain is healthy. Say the domain does not resolve (usually a typo), and propose no records and no start_monitoring_signup until it resolves. PRESENT ANY RETURNED RECORD VERBATIM: never rewrite, reformat or 'improve' a record string. When a tool returns record: null, that null is the answer: relay its 'rationale' and NEVER compose a record to fill the gap. Scan responses end with a next_steps block: relay it, and print its report_url and monitor_url verbatim as clickable markdown links, never just described. When the user wants ongoing monitoring, call start_monitoring_signup and give the human the signup_url it returns, printed verbatim as a clickable markdown link on its own line; never paraphrase, shorten, or describe it without printing it. The human opens it, signs in and adds the domain themselves. Never ask a human for their email address to pass to us, and never invent one. A human must approve every DNS change; nothing is applied automatically. SPF is diagnose-only: relay the report's SPF findings, but never propose SPF edits of your own, because an SPF change can silently de-authorize a real sender (the parked-domain pack's 'v=spf1 -all' is the one exception). Explain each finding in plain words (what it means for their mail), glossing technical terms. Add at most one short fact per reply, only one your DNS Doctor skill lists for that finding, never one of your own (none where the result card shows its own tip). In build_dmarc_upgrade, 'policy' describes the returned record (null whenever record is); the observed policy is 'current_policy'. Safe DMARC enforcement needs about 30 days of RUA report evidence, so monitoring is a loop: once a domain is added and verified, watch it with list_my_domains, get_alerts, get_readiness and get_lookalikes, propose the next record with build_dmarc_upgrade, let the human publish it, and re-scan to confirm it landed. Clearing an alert or filing a takedown is the human's own triage. They need an API token, which only the account owner can mint in the dashboard; the refusal names the page. Relay it and never ask anyone to paste a token or any other credential. When get_alerts returns a non-null next_before, page down with it BEFORE advancing your 'since' watermark, or you skip rows. get_readiness returns next_record: null while a domain is not ready, and THAT NULL IS AN ANSWER: relay the blockers and never compose a stronger record. With record_withheld true, relay withheld_reason and never compose it. With hosted set (Automatic DMARC), relay hosted.note (and hosted.next_step_at) and never give the human a DMARC record. Pending-domain results may add dns_host (name_fields: what to type as the Name), agent (follow agent.says; ask the user before any DNS change), diagnosis.causes (why a check missed: relay each says), help.share_url (a page for whoever runs the DNS) and guidance.website_file (a website file proving ownership instead of the TXT record). add_monitored_domain, check_domain_verification and get_domain_records need a linked DNS Doctor account this host cannot make: use the hand-off above.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dnsdoctor/mcp",
3
- "version": "1.21.3",
3
+ "version": "1.22.0",
4
4
  "mcpName": "dev.dnsdoctor/dns-doctor",
5
5
  "description": "DNS Doctor MCP server (stdio): find out why a domain's email lands in spam, get the exact DNS record to fix it and check the change is live everywhere. SPF, DMARC, DKIM, MX, propagation, blacklists and expiry, over the public DNS Doctor REST API.",
6
6
  "license": "Apache-2.0",