@dnsdoctor/mcp 1.16.2 → 1.20.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
@@ -1,161 +1,50 @@
1
- # DNS Doctor MCP server and Claude Code plugin — DNS skill (DMARC, SPF, DKIM)
1
+ # @dnsdoctor/mcp: DNS Doctor as a local stdio MCP server
2
2
 
3
- Scan, fix and verify a domain's DNS — email authentication (SPF, DMARC, DKIM)
4
- first, plus multi-region propagation, SPF include supply-chain audits, MX, DNS
5
- health, blacklists and domain/SSL expiry — from inside Claude. This plugin bundles the DNS Doctor **skill**
6
- (the scan → diagnose → fix workflow) and an **MCP server config** pointing at the
7
- hosted DNS Doctor tools.
3
+ A thin MCP server that runs on your machine and calls the public
4
+ [DNS Doctor](https://dnsdoctor.dev) REST API. It exposes the same 29 tools as the
5
+ hosted server at `https://dnsdoctor.dev/mcp`: scan a domain's email
6
+ authentication (SPF, DMARC, DKIM), MX, DNS health, blacklists and domain/SSL
7
+ expiry, check propagation, and get the exact fix record to publish.
8
8
 
9
- The moat: every fix record you get back is generated and validated by a
10
- deterministic engine — RFC grammar plus the SPF 10-lookup counter — **never an LLM
11
- guess**. Your agent hands the human a record that already parses correctly, not a
12
- plausible-looking string that silently fails.
9
+ It holds no diagnosis logic of its own and relays every record string verbatim.
10
+ Every fix record comes from DNS Doctor's deterministic engine, never from a model
11
+ guess.
13
12
 
14
- ## What's inside
15
-
16
- ```
17
- claude-plugin/
18
- ├── .claude-plugin/plugin.json # plugin manifest
19
- ├── .mcp.json # MCP server: https://dnsdoctor.dev/mcp (HTTP)
20
- ├── skills/dns-doctor/SKILL.md # the scan → diagnose → fix workflow
21
- ├── src/ # @dnsdoctor/mcp — the local stdio MCP server
22
- ├── tools.json # the tool definitions (generated, never hand-edited)
23
- ├── instructions.txt # the server's own `initialize` guidance (generated)
24
- ├── tests/ # vitest suite for the stdio server
25
- ├── package.json tsconfig.json # npm package + build
26
- ├── LICENSE # Apache-2.0
27
- └── README.md
28
- ```
29
-
30
- ## Tools
31
-
32
- | Tool | Does |
33
- |---|---|
34
- | `scan_domain` | Fresh scan of a domain; full report. |
35
- | `get_report` | Persisted report (scans once if none exists). |
36
- | `build_dmarc_upgrade` | A validated DMARC enforcement record, capped at `p=quarantine` and returned only when the server-derived alignment gate passes; without that evidence the answer is reporting-first and no record is returned. `p=reject` comes from the readiness engine's aggregate-report evidence, never from a scan. |
37
- | `count_spf_lookups` | The SPF DNS-lookup count against the RFC limit of 10. |
38
- | `validate_dmarc_record` | Parse and validate a DMARC record, tag by tag. |
39
- | `generate_dmarc_record` | Build a DMARC record from a policy + reporting address. |
40
- | `check_dkim_selector` | Look up one DKIM selector and check the key. |
41
- | `parse_dmarc_report` | Parse an aggregate (RUA) report file into rows. |
42
- | `check_record` | Read any DNS record type for a name; with `expected_value`, a one-word verdict on whether a change has landed. |
43
- | `check_propagation` | Whether a DNS change has gone global: six vantage points (five owner-run probes plus the server's own resolver) read the same name, returning the grid plus a deterministic verdict. Observation only — an unavailable cell is a vantage point we could not read, never a missing record, and under three reached vantage points the verdict stays `unknown`. |
44
- | `lookup_registration` | Registrar, dates, EPP status codes, nameservers, DNSSEC and abuse contact from one RDAP read. Observation only; a registry that did not answer is `unknown` with a reason, never "not registered". |
45
- | `check_lookalikes` | Which close variants of a domain's name resolve and which accept mail: counts plus up to ten resolving names. DNS-only facts, never a verdict; a name that could not be checked is `unknown`, and unregistered names are never listed. |
46
- | `check_bimi` | Whether a domain can show its logo in the inbox (BIMI): the DMARC gate, the published record, the logo and any certificate, and eligibility per mailbox, never a promise that a logo will show. With a candidate `logo_url`, the engine's record to publish. |
47
- | `start_email_test`, `get_email_test` | How one real message authenticated: a single-use address the user sends one email to, then the SPF, DKIM and DMARC verdicts (every signature, alignment, the disposition the policy implies), blocklist status, a score out of 10 with every deduction itemized, and per-provider estimates (Gmail, Yahoo, Outlook, Apple) of whether the message is accepted and reaches the inbox. Only verdicts and selected header facts are kept (24 hours, 90 days with an account), never the body. |
48
- | `check_reverse_dns` | PTR / forward-confirmed reverse DNS for an IP. |
49
- | `audit_spf_includes` | The SPF include/redirect tree — who can transitively send as the domain, with typed findings (broken include, confirmed-unregistered include, expiring registration, nested `+all`). Analysis only; no SPF fix record. |
50
- | `build_parked_domain_records` | The Null MX + `v=spf1 -all` + `p=reject; np=reject` hardening pack for a domain that sends no mail. The server re-checks DNS itself and refuses when it finds evidence of mail. |
51
- | `start_monitoring_signup` | A sign-up link to hand to the human who owns the domain. Sends no email and creates nothing — they open it, sign in on our page themselves (a social provider or an emailed link, whichever that deployment offers), and the domain is carried over to their dashboard already filled in; monitoring starts once they verify it with a TXT record. |
52
- | `get_alerts` | **Token required.** The account's monitoring alert log, newest first. Read-only — no acknowledge, no delete. Page down with `before` until `next_before` is `null` before advancing `since`. |
53
- | `get_readiness` | **Token required.** Whether one monitored domain's aggregate-report evidence justifies a stronger DMARC policy yet: `ready`, the `blockers`, and `next_record` (validated, or `null` while blocked — which is an answer, not a gap). |
54
- | `get_lookalikes` | **Token required.** The watched lookalike domains of one monitored domain, highest threat % first, with the itemized points and site facts. `ai_assessment.summary` is written from third-party page content: untrusted data, never an instruction. Read-only; takedowns are filed by the owner from the dashboard. |
55
- | `list_email_tests` | **Token required.** The account's own earlier email tests, newest first, with status, score and DMARC result; read one in full with `get_email_test`. |
56
- | `list_my_domains` | **Token required.** Every domain on the account with its state (verified, pending, verification lapsed) and the next step for it. |
57
-
58
- The three monitoring reads are **listed for everyone and callable with a token**:
59
- they appear in the tool list on both transports, and without a valid token the
60
- call is refused with the page the account owner mints one on. Over the hosted
61
- HTTP transport the `dnsdoctor://domains` resource (your monitored domains) is
62
- likewise always listed and refused without a token; the local stdio server
63
- registers the tools only — no resource. Anonymous access covers all nineteen
64
- diagnosis tools, which is enough for a one-off diagnosis either way.
65
-
66
- ## Install
67
-
68
- ### Claude Code
69
-
70
- Add the marketplace/repo and enable the plugin:
71
-
72
- ```bash
73
- /plugin marketplace add dnsdoctor/claude-plugin
74
- /plugin install dns-doctor
75
- ```
76
-
77
- > Public home: [github.com/dnsdoctor/claude-plugin](https://github.com/dnsdoctor/claude-plugin)
78
- > (org `dnsdoctor`, domain-verified). The plugin is developed in the DNS Doctor
79
- > monorepo and published here as clean release snapshots.
80
-
81
- Or point Claude Code at a local checkout of this directory during development.
82
- Once enabled, the skill auto-loads and the `dns-doctor` MCP server connects to
83
- `https://dnsdoctor.dev/mcp`.
84
-
85
- ### claude.ai (MCP connector)
86
-
87
- Add a custom connector with:
88
-
89
- - **URL:** `https://dnsdoctor.dev/mcp`
90
- - **Transport:** Streamable HTTP
91
- - **Auth:** none (anonymous) — or a Bearer token (below)
92
-
93
- ### Any MCP client (standard config)
13
+ Most clients should use the hosted server instead (no install, no keys):
94
14
 
95
15
  ```json
96
- {
97
- "mcpServers": {
98
- "dns-doctor": {
99
- "url": "https://dnsdoctor.dev/mcp"
100
- }
101
- }
102
- }
16
+ { "mcpServers": { "dns-doctor": { "type": "http", "url": "https://dnsdoctor.dev/mcp" } } }
103
17
  ```
104
18
 
105
- ## Optional: API token for monitored domains
106
-
107
- Anonymous access covers scanning and fixes. A per-account API token unlocks the
108
- account's own monitoring data: the `get_alerts`, `get_readiness`, `get_lookalikes`, `list_email_tests` and `list_my_domains` tools, and
109
- the `dnsdoctor://domains` resource (your continuously-monitored domains and
110
- their latest per-check statuses).
111
-
112
- 1. Sign in at <https://dnsdoctor.dev> → **Settings → API tokens** → create a token.
113
- The plaintext (`dnsd_…`) is shown once; copy it.
114
- 2. Add the `Authorization` header to the server in `.mcp.json`:
115
-
116
- ```json
117
- {
118
- "mcpServers": {
119
- "dns-doctor": {
120
- "type": "http",
121
- "url": "https://dnsdoctor.dev/mcp",
122
- "headers": { "Authorization": "Bearer ${DNSDOCTOR_API_TOKEN}" }
123
- }
124
- }
125
- }
126
- ```
19
+ For Claude Code, the [DNS Doctor plugin](https://github.com/dnsdoctor/claude-plugin)
20
+ wires the hosted server and adds the skills.
127
21
 
128
- Then export `DNSDOCTOR_API_TOKEN=dnsd_YOUR_TOKEN` in your environment. Never
129
- commit the token.
130
-
131
- ### Transport
132
-
133
- Two supported public transports, same 27 tools:
134
-
135
- - **Hosted streamable HTTP** — `https://dnsdoctor.dev/mcp`, wired in this
136
- plugin's `.mcp.json`. No install, no keys.
137
- - **Local stdio** — `npx -y @dnsdoctor/mcp@1.16.2`. A thin server that runs on your
138
- machine and calls the public DNS Doctor REST API; it holds no diagnosis logic
139
- of its own and relays every record string verbatim.
22
+ ## Run it
140
23
 
141
24
  ```json
142
25
  {
143
26
  "mcpServers": {
144
27
  "dns-doctor": {
145
28
  "command": "npx",
146
- "args": ["-y", "@dnsdoctor/mcp@1.16.2"],
29
+ "args": ["-y", "@dnsdoctor/mcp@1.20.0"],
147
30
  "env": { "DNSDOCTOR_API_TOKEN": "dnsd_YOUR_TOKEN" }
148
31
  }
149
32
  }
150
33
  }
151
34
  ```
152
35
 
153
- `DNSDOCTOR_API_TOKEN` is optional (anonymous access covers scanning and fixes;
154
- the three monitoring reads need it).
155
- `DNSDOCTOR_API_BASE` overrides the origin — it must be an origin that serves the
156
- `/api/…` paths, i.e. the public site rather than a bare backend port.
36
+ Node 20 or newer. Pin the version as shown, so the code you run is the code you
37
+ reviewed.
38
+
39
+ - `DNSDOCTOR_API_TOKEN` is optional. Anonymous access covers scanning and fixes;
40
+ the account tools (monitored domains, alerts, readiness, lookalike watches,
41
+ email tests) need a token. Create one at dnsdoctor.dev under
42
+ **Settings > API tokens**. The client sends it only to dnsdoctor.dev, as a
43
+ bearer token. Never commit it.
44
+ - `DNSDOCTOR_API_BASE` overrides the origin. It must serve the `/api/...` paths,
45
+ i.e. the public site rather than a bare backend port.
157
46
 
158
- ### Build the stdio server from source
47
+ ## Build from source
159
48
 
160
49
  ```bash
161
50
  npm ci
@@ -163,38 +52,11 @@ npm test
163
52
  npm run build # -> dist/index.js, the package's bin entrypoint
164
53
  ```
165
54
 
166
- `tools.json` and `instructions.txt` are **generated from the hosted server** and
167
- pinned by a backend test — never hand-edit them, and never add a tool
168
- description to `src/`. Both files ship in the npm tarball; without them the
169
- client has no tools and none of its safety guidance.
170
-
171
- ## Worked example
172
-
173
- > **You:** Our invoices keep landing in customers' spam. Domain is `example.com`.
174
- >
175
- > **Claude** (`scan_domain` → `example.com`): DMARC is at `p=none`, so nothing
176
- > enforces alignment — receivers can't tell your mail from a spoof. The SPF record
177
- > is valid, 7 of 10 lookups used. DKIM: a selector was found and is valid. Not blacklisted.
178
- > Domain expires in 240 days.
179
- >
180
- > **Claude** (`build_dmarc_upgrade` → `example.com`): SPF is aligned and DKIM is
181
- > present, so the recommendation reaches its ceiling, `p=quarantine`. Publish this
182
- > exact TXT record at `_dmarc.example.com` — **paste it verbatim, don't edit it**:
183
- >
184
- > ```
185
- > v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com; adkim=r; aspf=r; np=reject
186
- > ```
187
- >
188
- > Apply it in your DNS host once you've confirmed it's approved, then ask me to
189
- > re-scan to verify. Want the domain watched continuously with aggregate-report
190
- > alerts? Here is the setup link — open it and sign in:
191
- > https://dnsdoctor.dev/start?domain=example.com&ref=agent
192
-
193
- ## Learn more
194
-
195
- - **Methodology** (how the verdicts are computed): <https://dnsdoctor.dev/methodology>
196
- - **REST API / OpenAPI schema:** <https://dnsdoctor.dev/api/v1/openapi.json>
55
+ `tools.json` and `instructions.txt` are generated from the hosted server and
56
+ pinned by a test on the server side: never hand-edit them, and never add a tool
57
+ description to `src/`. Both ship in the npm tarball; without them the client has
58
+ no tools and none of its safety guidance.
197
59
 
198
60
  ## License
199
61
 
200
- Apache-2.0 — see [LICENSE](./LICENSE).
62
+ Apache-2.0
package/dist/index.js CHANGED
@@ -63,6 +63,10 @@ const ROUTES = {
63
63
  list_email_tests: { kind: "query", path: "/api/v1/email-tests" },
64
64
  // The account's domains with state + next step (token, monitoring:read).
65
65
  list_my_domains: { kind: "query", path: "/api/v1/domains/mine" },
66
+ // Start one record watch; its single email goes to the token's account.
67
+ watch_record_change: { kind: "json", path: "/api/v1/change-watch" },
68
+ // Which candidate names are already registered (1-20, anonymous).
69
+ check_domain_names: { kind: "json", path: "/api/tools/check-names" },
66
70
  };
67
71
  /** Default upload name when the caller supplies none — the API only reads bytes. */
68
72
  const DEFAULT_REPORT_FILENAME = "report.xml";
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/instructions.txt CHANGED
@@ -1 +1 @@
1
- Use DNS Doctor whenever a user asks to check, audit, diagnose, troubleshoot or fix SPF, DKIM or DMARC, wonders why their mail lands in spam, wants DMARC monitoring or alerts on new senders, asks whether a DNS change has propagated, or needs a domain's blacklist status or domain/SSL expiry. DNS Doctor scans, fixes and verifies a domain's DNS: email authentication (SPF, DMARC, DKIM), multi-region propagation, SPF include supply-chain audits, MX, DNS health, blacklists and 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), read the verdicts failing-first (a 'temperror' status is transient, NOT a failure), then call build_dmarc_upgrade for a DMARC enforcement record. ONE EXCEPTION TO READING FAILING-FIRST: when a report carries not_registered: true the domain has no DNS records at all, so no check ran and every status is an 'info' placeholder — zero failing checks there does NOT mean the domain is healthy. Report that the domain does not resolve (usually a typo), propose no records for it, and do not call start_monitoring_signup for it until it resolves. PRESENT ANY RETURNED RECORD VERBATIM — never rewrite, reformat, or 'improve' a record string. build_dmarc_upgrade may return record: null (the domain does not exist; the DMARC lookup itself hit NXDOMAIN while the existence probe did not resolve; the DMARC lookup temp-failed; the domain is on Automatic DMARC, where DNS Doctor serves its DMARC record and the owner applies each step from the dashboard; or the domain already applies a policy at least as strong as the one this scan justifies) — relay its 'rationale' as the answer and NEVER compose a record yourself to fill the gap. 'policy' describes the returned record and is null whenever record is; the domain's observed policy is in 'current_policy'. 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 record edits of your own (e.g. tightening ~all to -all) — an SPF change can silently de-authorize a real sender, which is why the engine emits no SPF fix record. The ONE SPF record DNS Doctor ever emits is the constant 'v=spf1 -all' inside the build_parked_domain_records pack, for a domain the server itself verified sends no mail; never set that tool's confirm_no_mail flag on your own judgment — only the human who owns the domain can confirm it, and the server still re-checks DNS and refuses on any evidence of a sender. audit_spf_includes reports who can transitively send as a domain; its include_registrable finding is raised ONLY on confirmed absence, and only the ones carrying registry_confirmed: true rest on the registry's word — treat every other registration verdict, including a registry_confirmed: false finding, as unknown and never tell anyone a name is free to register. For lookalike, typosquat or impersonation questions call check_lookalikes: it returns facts (which close variants of the name resolve and accept mail), never a verdict, so relay the names as facts and never call one malicious. For questions about a logo in the inbox (BIMI) call check_bimi: it reports eligibility per mailbox, never a promise that a logo will show. To see how a real message authenticates (whether it is actually DKIM-signed and DMARC-aligned), call start_email_test, have the user send one email to the address it returns, then call get_email_test; list_email_tests returns an account's earlier tests and needs the same API token as the monitoring reads. A current email test scores the message out of 10 to one decimal (a 10 only when nothing was deducted and every check a 10 depends on completed; the deductions and not_scored say why it is lower) and estimates, for Gmail, Yahoo, Microsoft Outlook and Apple, whether the message is accepted and whether it reaches the inbox: relay those percentages as estimates, never as a promise of delivery. Scan reports carry sender_requirements, the scan read against those four providers' published sender rules: relay it as what DNS shows, never as a compliance verdict; rows marked email_test need a real message (start_email_test), and rows marked not_visible only the provider can see. Scan responses end with a next_steps block: relay it. Safe DMARC enforcement needs ~30 days of aggregate-report (RUA) evidence, which no chat session can watch. If 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. That tool sends no email and creates nothing: the human opens the link, signs in themselves, and adds the domain themselves. Never ask a human for their email address to pass to us, and never invent one — hand over the link and let them sign in on our page. Also share the report_url and monitor_url links from next_steps, each printed verbatim as a clickable markdown link — never described without being printed. Monitoring is a loop, not a one-off: the human enrolls a domain and verifies ownership in the dashboard, then you watch it with list_my_domains (the account's domains and the next step on each), get_alerts (what changed), get_readiness (whether enforcement is safe yet) and get_lookalikes (the watched lookalike domains and their threat %), propose the next record with build_dmarc_upgrade, wait for the human to approve and publish it, and re-scan to confirm it landed. Those reads return an account's own monitoring data and need an API token: they are listed to everyone and callable only with one. You cannot create a token — tokens are minted by the account owner while signed in to the dashboard, and the refusal message names the exact page. Relay that page to the human and let them decide; never ask anyone to paste a token or any other credential to you. They are all read-only by design: there is no way to acknowledge or clear an alert or to file a takedown here, because triage is the human's. When get_alerts returns a non-null next_before, older rows remain — page down with it BEFORE advancing your 'since' watermark, or you silently skip rows you never read. 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 to fill it. When record_withheld is true, the step is ready but the record is not included in the result: relay that the record isn't included and withheld_reason, and never compose a record. When get_readiness carries hosted, the domain is on Automatic DMARC (withheld_reason hosted on a ready step): relay hosted.note (and hosted.next_step_at, when set) 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; when this host has none, they return the sign-up link instead, so use the hand-off described above.
1
+ Use DNS Doctor whenever a user asks to check, audit, diagnose, troubleshoot or fix SPF, DKIM or DMARC, wonders why their mail lands in spam, wants DMARC monitoring or alerts on new senders, asks whether a DNS change has propagated, or needs a domain's blacklist status or domain/SSL expiry. DNS Doctor scans, fixes and verifies a domain's DNS: email authentication (SPF, DMARC, DKIM), multi-region propagation, SPF include supply-chain audits, MX, DNS health, blacklists and 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), read the verdicts failing-first (a 'temperror' status is transient, NOT a failure), then call build_dmarc_upgrade for a DMARC enforcement record. ONE EXCEPTION TO READING FAILING-FIRST: when a report carries not_registered: true the domain has no DNS records at all, so no check ran and every status is an 'info' placeholder — zero failing checks there does NOT mean the domain is healthy. Report that the domain does not resolve (usually a typo), propose no records for it, and do not call start_monitoring_signup for it until it resolves. PRESENT ANY RETURNED RECORD VERBATIM — never rewrite, reformat, or 'improve' a record string. build_dmarc_upgrade may return record: null (the domain does not exist; the DMARC lookup itself hit NXDOMAIN while the existence probe did not resolve; the DMARC lookup temp-failed; the domain is on Automatic DMARC, where DNS Doctor serves its DMARC record and the owner applies each step from the dashboard; or the domain already applies a policy at least as strong as the one this scan justifies) — relay its 'rationale' as the answer and NEVER compose a record yourself to fill the gap. 'policy' describes the returned record and is null whenever record is; the domain's observed policy is in 'current_policy'. 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 record edits of your own (e.g. tightening ~all to -all) — an SPF change can silently de-authorize a real sender, which is why the engine emits no SPF fix record. The ONE SPF record DNS Doctor ever emits is the constant 'v=spf1 -all' inside the build_parked_domain_records pack, for a domain the server itself verified sends no mail; never set that tool's confirm_no_mail flag on your own judgment — only the human who owns the domain can confirm it, and the server still re-checks DNS and refuses on any evidence of a sender. audit_spf_includes reports who can transitively send as a domain; its include_registrable finding is raised ONLY on confirmed absence, and only the ones carrying registry_confirmed: true rest on the registry's word — treat every other registration verdict, including a registry_confirmed: false finding, as unknown and never tell anyone a name is free to register. For lookalike, typosquat or impersonation questions call check_lookalikes: it returns facts (which close variants of the name resolve and accept mail), never a verdict, so relay the names as facts and never call one malicious. For questions about a logo in the inbox (BIMI) call check_bimi: it reports eligibility per mailbox, never a promise that a logo will show. To see how a real message authenticates (whether it is actually DKIM-signed and DMARC-aligned), call start_email_test, have the user send one email to the address it returns, then call get_email_test; list_email_tests returns an account's earlier tests and needs the same API token as the monitoring reads. A current email test scores the message out of 10 to one decimal (a 10 only when nothing was deducted and every check a 10 depends on completed; the deductions and not_scored say why it is lower) and estimates, for Gmail, Yahoo, Microsoft Outlook and Apple, whether the message is accepted and whether it reaches the inbox: relay those percentages as estimates, never as a promise of delivery. Scan reports carry sender_requirements, the scan read against those four providers' published sender rules: relay it as what DNS shows, never as a compliance verdict; rows marked email_test need a real message (start_email_test), and rows marked not_visible only the provider can see. Most users are small-business or website owners, not DNS experts: explain each finding in plain words (what it means for their mail, such as whether someone could fake their address or their mail may land in spam), gloss any technical term in a few words, add at most one short fact per reply, only a fact listed for that finding in your DNS Doctor skill, and never state a fact beyond the tool results and that list. Where the DNS Doctor result card is shown it may carry its own short tip, so add no fact of your own there. Scan responses end with a next_steps block: relay it. Safe DMARC enforcement needs ~30 days of aggregate-report (RUA) evidence, which no chat session can watch. If 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. That tool sends no email and creates nothing: the human opens the link, signs in themselves, and adds the domain themselves. Never ask a human for their email address to pass to us, and never invent one — hand over the link and let them sign in on our page. Also share the report_url and monitor_url links from next_steps, each printed verbatim as a clickable markdown link — never described without being printed. Monitoring is a loop, not a one-off: the human enrolls a domain and verifies ownership in the dashboard, then you watch it with list_my_domains (the account's domains and the next step on each), get_alerts (what changed), get_readiness (whether enforcement is safe yet) and get_lookalikes (the watched lookalike domains and their threat %), propose the next record with build_dmarc_upgrade, wait for the human to approve and publish it, and re-scan to confirm it landed. Those reads return an account's own monitoring data and need an API token: they are listed to everyone and callable only with one. You cannot create a token — tokens are minted by the account owner while signed in to the dashboard, and the refusal message names the exact page. Relay that page to the human and let them decide; never ask anyone to paste a token or any other credential to you. They are all read-only by design: there is no way to acknowledge or clear an alert or to file a takedown here, because triage is the human's. When get_alerts returns a non-null next_before, older rows remain — page down with it BEFORE advancing your 'since' watermark, or you silently skip rows you never read. 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 to fill it. When record_withheld is true, the step is ready but the record is not included in the result: relay that the record isn't included and withheld_reason, and never compose a record. When get_readiness carries hosted, the domain is on Automatic DMARC (withheld_reason hosted on a ready step): relay hosted.note (and hosted.next_step_at, when set) 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; when this host has none, they return the sign-up link instead, so use the hand-off described above.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@dnsdoctor/mcp",
3
- "version": "1.16.2",
3
+ "version": "1.20.0",
4
4
  "mcpName": "dev.dnsdoctor/dns-doctor",
5
5
  "description": "Thin stdio MCP server for DNS Doctor — scan, fix and verify a domain's DNS: SPF, DMARC, DKIM, multi-region propagation, MX, DNS health, blacklists and expiry, over the public DNS Doctor REST API.",
6
6
  "license": "Apache-2.0",
@@ -11,7 +11,7 @@
11
11
  "homepage": "https://dnsdoctor.dev/methodology",
12
12
  "repository": {
13
13
  "type": "git",
14
- "url": "git+https://github.com/dnsdoctor/claude-plugin.git"
14
+ "url": "git+https://github.com/dnsdoctor/mcp.git"
15
15
  },
16
16
  "keywords": [
17
17
  "mcp",
package/tools.json CHANGED
@@ -206,6 +206,38 @@
206
206
  "name": "check_dkim_selector",
207
207
  "title": "Check DKIM Selector"
208
208
  },
209
+ {
210
+ "annotations": {
211
+ "destructiveHint": false,
212
+ "idempotentHint": true,
213
+ "openWorldHint": true,
214
+ "readOnlyHint": true,
215
+ "title": "Check Domain Names"
216
+ },
217
+ "description": "Use this when the user is choosing a domain name and wants to know which candidates are already registered. Pass up to 20 candidate names in ONE call (never one call per name). Each name is read live from its registry over RDAP: status is registered | not_registered | unknown. registered carries the registry's own status words (registry_status) and expires_at when published; being_deleted: true (pendingDelete / redemptionPeriod) means it is still registered and cannot be registered yet. not_registered means the registry holds no registration for the name: relay it as exactly that, never as 'available', because premium, reserved and blocked names read the same way. unknown is NOT absence: the registry did not answer, and reason says why (rate_limited, throttled, timeout, registry_error, no_rdap_for_tld). Never tell anyone a name is free unless its status is exactly not_registered, and even then relay caveat as given. Premium status and price are not checked. next_step, when present, is the one thing DNS Doctor can do after a name is registered. Each name counts as one call against the hourly limit. Observation only: nothing is registered, stored or published.",
218
+ "inputSchema": {
219
+ "properties": {
220
+ "names": {
221
+ "description": "1 to 20 candidate domain names to check in ONE call, e.g. [\"brightlane.com\", \"brightlane.io\"]. Registrable names only (example.com, example.co.uk), not subdomains; duplicates are checked once. Unicode names are accepted and normalized to punycode.",
222
+ "items": {
223
+ "maxLength": 253,
224
+ "type": "string"
225
+ },
226
+ "maxItems": 20,
227
+ "minItems": 1,
228
+ "title": "Names",
229
+ "type": "array"
230
+ }
231
+ },
232
+ "required": [
233
+ "names"
234
+ ],
235
+ "title": "check_domain_namesArguments",
236
+ "type": "object"
237
+ },
238
+ "name": "check_domain_names",
239
+ "title": "Check Domain Names"
240
+ },
209
241
  {
210
242
  "annotations": {
211
243
  "destructiveHint": false,
@@ -992,5 +1024,73 @@
992
1024
  },
993
1025
  "name": "validate_dmarc_record",
994
1026
  "title": "Validate DMARC Record"
1027
+ },
1028
+ {
1029
+ "annotations": {
1030
+ "destructiveHint": false,
1031
+ "idempotentHint": true,
1032
+ "openWorldHint": true,
1033
+ "readOnlyHint": false,
1034
+ "title": "Watch Record Change"
1035
+ },
1036
+ "description": "Use this when the user asks to be told when a DNS change they are making has finished (\"let me know when it's live\"). Starts a free watch on ONE record for the signed-in user: DNS Doctor rechecks it every 10 minutes for up to 48 hours with the same verdict as check_record and sends ONE email to the address on their DNS Doctor account: when it is live, when the value has sat at a different name for an hour, when the zone has not served it for 6 hours, or when 48 hours pass. Same arguments as check_record; pass expected_value when the user is publishing a specific value. It reads the record once first and returns that reading: a record that is already live (verdict done), a domain whose nameservers do not answer, or a lookup fault starts nothing. Asking again for the same record returns the running watch, never a second one. Relay `watch.note`. Needs a linked DNS Doctor account; never ask the user for an email address. Nothing is applied to anyone's DNS.",
1037
+ "inputSchema": {
1038
+ "properties": {
1039
+ "domain": {
1040
+ "description": "The domain to check, e.g. example.com. Bare registrable names and subdomains both work; scheme, path or port do not belong here. Unicode names are accepted and normalized to punycode.",
1041
+ "title": "Domain",
1042
+ "type": "string"
1043
+ },
1044
+ "expected_value": {
1045
+ "anyOf": [
1046
+ {
1047
+ "maxLength": 1024,
1048
+ "type": "string"
1049
+ },
1050
+ {
1051
+ "type": "null"
1052
+ }
1053
+ ],
1054
+ "default": null,
1055
+ "description": "Optional: the exact value just published (e.g. the DMARC record text, a verification token, '10 mx.example.com'). Given it, the verdict tests for that value and an 'edit' also checks the names a misplaced edit usually lands on (found_at).",
1056
+ "title": "Expected Value"
1057
+ },
1058
+ "host": {
1059
+ "anyOf": [
1060
+ {
1061
+ "type": "string"
1062
+ },
1063
+ {
1064
+ "type": "null"
1065
+ }
1066
+ ],
1067
+ "default": null,
1068
+ "description": "Optional label to prepend to the domain (e.g. 'mail' to check mail.<domain>) \u2014 honored for txt, cname, a and aaaa only; spf, dmarc and mx derive their own query name.",
1069
+ "title": "Host"
1070
+ },
1071
+ "kind": {
1072
+ "description": "Which record to read; the right query is derived from it \u2014 'dmarc' reads TXT at _dmarc.<domain> filtered to v=DMARC1, 'spf' reads the apex TXT filtered to v=spf1, so don't prefix the domain yourself.",
1073
+ "enum": [
1074
+ "spf",
1075
+ "dmarc",
1076
+ "txt",
1077
+ "mx",
1078
+ "cname",
1079
+ "a",
1080
+ "aaaa"
1081
+ ],
1082
+ "title": "Kind",
1083
+ "type": "string"
1084
+ }
1085
+ },
1086
+ "required": [
1087
+ "domain",
1088
+ "kind"
1089
+ ],
1090
+ "title": "watch_record_changeArguments",
1091
+ "type": "object"
1092
+ },
1093
+ "name": "watch_record_change",
1094
+ "title": "Watch Record Change"
995
1095
  }
996
1096
  ]