blackveil-dns 2.12.1 → 3.100.1

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.
Files changed (640) hide show
  1. package/LICENSE +1 -1
  2. package/README.md +237 -62
  3. package/dist/cli.js +1098 -0
  4. package/dist/cli.js.map +1 -0
  5. package/dist/index.js +10011 -2433
  6. package/dist/index.js.map +1 -1
  7. package/dist/stdio.js +33244 -9766
  8. package/dist/stdio.js.map +1 -1
  9. package/package.json +101 -21
  10. package/.claude/settings.json +0 -61
  11. package/.cursorrules +0 -1
  12. package/.devcontainer/Dockerfile +0 -17
  13. package/.devcontainer/devcontainer.json +0 -18
  14. package/.editorconfig +0 -12
  15. package/.gitattributes +0 -24
  16. package/.githooks/blocked-patterns +0 -13
  17. package/.githooks/pre-commit +0 -127
  18. package/.github/CODEOWNERS +0 -11
  19. package/.github/ISSUE_TEMPLATE/bug_report.yml +0 -99
  20. package/.github/ISSUE_TEMPLATE/config.yml +0 -11
  21. package/.github/ISSUE_TEMPLATE/feature_request.yml +0 -51
  22. package/.github/PULL_REQUEST_TEMPLATE.md +0 -30
  23. package/.github/copilot-instructions.md +0 -73
  24. package/.github/dependabot.yml +0 -22
  25. package/.github/instructions/scan-orchestration.instructions.md +0 -56
  26. package/.github/instructions/schemas.instructions.md +0 -52
  27. package/.github/instructions/security.instructions.md +0 -77
  28. package/.github/instructions/tests.instructions.md +0 -31
  29. package/.github/instructions/tools.instructions.md +0 -55
  30. package/.github/workflows/auto-deploy-main.yml.disabled +0 -145
  31. package/.github/workflows/ci-contract.yml +0 -47
  32. package/.github/workflows/ci.yml +0 -53
  33. package/.github/workflows/deploy-hook.yml +0 -113
  34. package/.github/workflows/dns-security.yml +0 -32
  35. package/.github/workflows/publish.yml +0 -275
  36. package/.github/workflows/repo-hygiene.yml +0 -121
  37. package/.github/workflows/security.yml +0 -62
  38. package/.github/workflows/triage-issues.yml +0 -82
  39. package/.gitleaks.toml +0 -190
  40. package/.intent/.gitignore +0 -5
  41. package/.intent/config.json +0 -88
  42. package/.nvmrc +0 -1
  43. package/.phase2-queue/baseline.txt +0 -1
  44. package/.prettierrc +0 -6
  45. package/CHANGELOG.md +0 -793
  46. package/CLAUDE.md +0 -580
  47. package/CODE_OF_CONDUCT.md +0 -133
  48. package/CONTRIBUTING.md +0 -63
  49. package/SECURITY.md +0 -66
  50. package/SUPPORT.md +0 -17
  51. package/assets/brave-score.png +0 -0
  52. package/assets/bv-logo-full.png +0 -0
  53. package/assets/bv-logo-mark.png +0 -0
  54. package/assets/our-listing-final.png +0 -0
  55. package/assets/smithery-listing.png +0 -0
  56. package/assets/smithery-score-2.png +0 -0
  57. package/assets/smithery-score-hover.png +0 -0
  58. package/assets/smithery-score.png +0 -0
  59. package/assets/supabase-score.png +0 -0
  60. package/conductor/index.md +0 -1
  61. package/conductor/registrar-commercial-models.md +0 -64
  62. package/crates/bv-wasm-core/Cargo.lock +0 -177
  63. package/crates/bv-wasm-core/Cargo.toml +0 -12
  64. package/crates/bv-wasm-core/src/compact.rs +0 -60
  65. package/crates/bv-wasm-core/src/lib.rs +0 -116
  66. package/crates/bv-wasm-core/src/permissions.rs +0 -106
  67. package/dist/index.d.ts +0 -500
  68. package/dist/stdio.d.ts +0 -12
  69. package/docs/client-setup.md +0 -587
  70. package/docs/scoring.md +0 -245
  71. package/docs/style-guide.md +0 -69
  72. package/docs/tenant-Capacity-and-Discovery-Design.md +0 -267
  73. package/docs/tenant-Scalable-Architecture-Design.md +0 -639
  74. package/docs/tenant-ops-runbook.md +0 -191
  75. package/docs/troubleshooting.md +0 -392
  76. package/eslint.config.mjs +0 -21
  77. package/examples/slack-discord-webhook/README.md +0 -38
  78. package/examples/slack-discord-webhook/worker.ts +0 -133
  79. package/examples/slack-discord-webhook/wrangler.toml +0 -11
  80. package/extensions/vscode/.vscodeignore +0 -2
  81. package/extensions/vscode/CHANGELOG.md +0 -8
  82. package/extensions/vscode/LICENSE +0 -76
  83. package/extensions/vscode/README.md +0 -105
  84. package/extensions/vscode/icon.png +0 -0
  85. package/extensions/vscode/package.json +0 -49
  86. package/packages/dns-checks/LICENSE +0 -76
  87. package/packages/dns-checks/README.md +0 -61
  88. package/packages/dns-checks/package.json +0 -39
  89. package/packages/dns-checks/src/__tests__/check-utils.test.ts +0 -188
  90. package/packages/dns-checks/src/__tests__/checks/check-dkim.test.ts +0 -54
  91. package/packages/dns-checks/src/__tests__/checks/check-dmarc.test.ts +0 -70
  92. package/packages/dns-checks/src/__tests__/checks/check-dnssec.test.ts +0 -56
  93. package/packages/dns-checks/src/__tests__/checks/check-remaining.test.ts +0 -244
  94. package/packages/dns-checks/src/__tests__/checks/check-spf.test.ts +0 -114
  95. package/packages/dns-checks/src/__tests__/scoring/generic-engine.spec.ts +0 -858
  96. package/packages/dns-checks/src/__tests__/scoring/score-determinism.spec.ts +0 -73
  97. package/packages/dns-checks/src/__tests__/scoring/scoring-config.spec.ts +0 -194
  98. package/packages/dns-checks/src/__tests__/scoring/scoring-engine.spec.ts +0 -137
  99. package/packages/dns-checks/src/__tests__/scoring/scoring-model.spec.ts +0 -46
  100. package/packages/dns-checks/src/__tests__/scoring/scoring-profiles.spec.ts +0 -316
  101. package/packages/dns-checks/src/__tests__/scoring-schemas.test.ts +0 -307
  102. package/packages/dns-checks/src/check-utils.ts +0 -44
  103. package/packages/dns-checks/src/checks/caa-analysis.ts +0 -126
  104. package/packages/dns-checks/src/checks/check-bimi.ts +0 -305
  105. package/packages/dns-checks/src/checks/check-caa.ts +0 -63
  106. package/packages/dns-checks/src/checks/check-dane-https.ts +0 -88
  107. package/packages/dns-checks/src/checks/check-dane.ts +0 -110
  108. package/packages/dns-checks/src/checks/check-dkim.ts +0 -261
  109. package/packages/dns-checks/src/checks/check-dmarc.ts +0 -370
  110. package/packages/dns-checks/src/checks/check-dnssec.ts +0 -131
  111. package/packages/dns-checks/src/checks/check-http-security.ts +0 -187
  112. package/packages/dns-checks/src/checks/check-mta-sts.ts +0 -195
  113. package/packages/dns-checks/src/checks/check-mx.ts +0 -130
  114. package/packages/dns-checks/src/checks/check-ns.ts +0 -133
  115. package/packages/dns-checks/src/checks/check-spf.ts +0 -271
  116. package/packages/dns-checks/src/checks/check-ssl.ts +0 -95
  117. package/packages/dns-checks/src/checks/check-subdomailing.ts +0 -77
  118. package/packages/dns-checks/src/checks/check-subdomain-takeover.ts +0 -45
  119. package/packages/dns-checks/src/checks/check-svcb-https.ts +0 -246
  120. package/packages/dns-checks/src/checks/check-tlsrpt.ts +0 -112
  121. package/packages/dns-checks/src/checks/dane-analysis.ts +0 -203
  122. package/packages/dns-checks/src/checks/dkim-analysis.ts +0 -102
  123. package/packages/dns-checks/src/checks/dmarc-utils.ts +0 -126
  124. package/packages/dns-checks/src/checks/dnssec-analysis.ts +0 -237
  125. package/packages/dns-checks/src/checks/http-security-analysis.ts +0 -230
  126. package/packages/dns-checks/src/checks/index.ts +0 -36
  127. package/packages/dns-checks/src/checks/mta-sts-analysis.ts +0 -259
  128. package/packages/dns-checks/src/checks/mx-analysis.ts +0 -63
  129. package/packages/dns-checks/src/checks/ns-analysis.ts +0 -171
  130. package/packages/dns-checks/src/checks/spf-analysis.ts +0 -211
  131. package/packages/dns-checks/src/checks/spf-trust-surface.ts +0 -141
  132. package/packages/dns-checks/src/checks/ssl-analysis.ts +0 -111
  133. package/packages/dns-checks/src/checks/subdomailing-analysis.ts +0 -262
  134. package/packages/dns-checks/src/checks/subdomain-takeover-analysis.ts +0 -217
  135. package/packages/dns-checks/src/index.ts +0 -73
  136. package/packages/dns-checks/src/schemas/scoring.ts +0 -52
  137. package/packages/dns-checks/src/scoring/config.ts +0 -346
  138. package/packages/dns-checks/src/scoring/engine.ts +0 -293
  139. package/packages/dns-checks/src/scoring/generic.ts +0 -317
  140. package/packages/dns-checks/src/scoring/index.ts +0 -56
  141. package/packages/dns-checks/src/scoring/model.ts +0 -133
  142. package/packages/dns-checks/src/scoring/profiles.ts +0 -332
  143. package/packages/dns-checks/src/types.ts +0 -172
  144. package/packages/dns-checks/tsconfig.json +0 -15
  145. package/packages/dns-checks/tsup.config.ts +0 -14
  146. package/packages/dns-checks/vitest.config.ts +0 -8
  147. package/public/index.html +0 -45
  148. package/scripts/benchmark-doh.mjs +0 -216
  149. package/scripts/benchmark.sh +0 -151
  150. package/scripts/chaos/chaos-run.py +0 -393
  151. package/scripts/chaos/chaos-test-clients.py +0 -884
  152. package/scripts/chaos/chaos-test-msp.py +0 -745
  153. package/scripts/chaos/chaos-test-v205.py +0 -829
  154. package/scripts/chaos/chaos-test-v210.py +0 -2038
  155. package/scripts/chaos/chaos-test-wasm.py +0 -65
  156. package/scripts/chaos/chaos-test.py +0 -952
  157. package/scripts/chaos/score-stability-test.py +0 -298
  158. package/scripts/chaos/tenant-chaos-v3.py +0 -119
  159. package/scripts/context-usage-test.py +0 -281
  160. package/scripts/conversation-sim.py +0 -421
  161. package/scripts/deploy-private.mjs +0 -22
  162. package/scripts/generate-report.sh +0 -42
  163. package/scripts/inject-private-config.cjs +0 -41
  164. package/scripts/maintenance/dispatch_all.sh +0 -26
  165. package/scripts/maintenance/fix_wrangler.py +0 -32
  166. package/scripts/maintenance/run_rescan_prod.py +0 -34
  167. package/scripts/maintenance/run_sync_batches.py +0 -56
  168. package/scripts/maintenance/run_sync_test.py +0 -27
  169. package/scripts/maintenance/run_test_msg.py +0 -22
  170. package/scripts/maintenance/test_analytics_stream.js +0 -3
  171. package/scripts/maintenance/update_wrangler.cjs +0 -22
  172. package/scripts/maintenance/update_wrangler.js +0 -22
  173. package/scripts/maintenance/validate-internal-deps.mjs +0 -49
  174. package/scripts/oauth/README.md +0 -101
  175. package/scripts/oauth/prod-probe.py +0 -329
  176. package/scripts/output-usage-test.py +0 -221
  177. package/scripts/pressure-chaos-test.mjs +0 -481
  178. package/scripts/tenants/add_consumer.js +0 -17
  179. package/scripts/tenants/calibrate.mjs +0 -206
  180. package/scripts/tenants/provision-tenant.mjs +0 -578
  181. package/scripts/tenants/register_domains.py +0 -27
  182. package/scripts/tenants/sql/register_0.sql +0 -1
  183. package/scripts/tenants/sql/register_1.sql +0 -1
  184. package/scripts/tenants/sql/register_2.sql +0 -1
  185. package/scripts/tenants/sql/register_3.sql +0 -1
  186. package/scripts/tenants/sql/register_4.sql +0 -1
  187. package/scripts/tenants/sql/register_5.sql +0 -1
  188. package/scripts/tenants/sql/register_6.sql +0 -1
  189. package/scripts/tenants/sql/register_7.sql +0 -1
  190. package/scripts/tenants/sql/register_8.sql +0 -1
  191. package/scripts/tenants/sql/register_9.sql +0 -1
  192. package/scripts/tranco-deep-2026-04-05_12h42m.json +0 -47002
  193. package/scripts/tranco-deep-scan.mjs +0 -307
  194. package/scripts/tranco-scan-2026-04-05_12h14m.json +0 -6002
  195. package/scripts/tranco-scan-2026-04-06_02h49m.json +0 -602
  196. package/scripts/tranco-scan-2026-04-07_13h30m.json +0 -1202
  197. package/scripts/tranco-scan.mjs +0 -253
  198. package/scripts/trial-key.mjs +0 -346
  199. package/server.json +0 -35
  200. package/smithery.yaml +0 -13
  201. package/src/handlers/prompts.ts +0 -279
  202. package/src/handlers/resources.ts +0 -283
  203. package/src/handlers/tool-args.ts +0 -150
  204. package/src/handlers/tool-execution.ts +0 -107
  205. package/src/handlers/tool-formatters.ts +0 -94
  206. package/src/handlers/tool-schemas.ts +0 -9
  207. package/src/handlers/tools.ts +0 -529
  208. package/src/index.ts +0 -794
  209. package/src/internal.ts +0 -666
  210. package/src/lib/adaptive-weights.ts +0 -246
  211. package/src/lib/alerting.ts +0 -103
  212. package/src/lib/analytics-engine.ts +0 -33
  213. package/src/lib/analytics-queries.ts +0 -399
  214. package/src/lib/analytics.ts +0 -310
  215. package/src/lib/audit.ts +0 -56
  216. package/src/lib/auth.ts +0 -52
  217. package/src/lib/badge.ts +0 -94
  218. package/src/lib/cache.ts +0 -310
  219. package/src/lib/category-interactions.ts +0 -154
  220. package/src/lib/circuit-breaker.ts +0 -101
  221. package/src/lib/client-detection.ts +0 -31
  222. package/src/lib/config.ts +0 -370
  223. package/src/lib/context-profiles.ts +0 -16
  224. package/src/lib/db/schema.ts +0 -77
  225. package/src/lib/dns-multi-resolver.ts +0 -218
  226. package/src/lib/dns-query-adapter.ts +0 -18
  227. package/src/lib/dns-records.ts +0 -233
  228. package/src/lib/dns-transport.ts +0 -237
  229. package/src/lib/dns-types.ts +0 -91
  230. package/src/lib/dns.ts +0 -27
  231. package/src/lib/fuzzing-counter.ts +0 -79
  232. package/src/lib/fuzzing-detector.ts +0 -115
  233. package/src/lib/hooks/analytics-stream.ts +0 -28
  234. package/src/lib/ip-utils.ts +0 -70
  235. package/src/lib/json-rpc.ts +0 -67
  236. package/src/lib/legacy-sse.ts +0 -185
  237. package/src/lib/log.ts +0 -113
  238. package/src/lib/output-sanitize.ts +0 -40
  239. package/src/lib/profile-accumulator.ts +0 -830
  240. package/src/lib/provider-signature-source.ts +0 -191
  241. package/src/lib/provider-signatures.ts +0 -134
  242. package/src/lib/public-suffix.ts +0 -131
  243. package/src/lib/quota-coordinator.ts +0 -446
  244. package/src/lib/rate-limiter-memory.ts +0 -163
  245. package/src/lib/rate-limiter.ts +0 -528
  246. package/src/lib/safe-fetch.ts +0 -42
  247. package/src/lib/sanitize.ts +0 -245
  248. package/src/lib/scoring-config.ts +0 -36
  249. package/src/lib/scoring-engine.ts +0 -15
  250. package/src/lib/scoring-model.ts +0 -26
  251. package/src/lib/scoring.ts +0 -58
  252. package/src/lib/semaphore.ts +0 -101
  253. package/src/lib/server-version.ts +0 -4
  254. package/src/lib/session-memory.ts +0 -177
  255. package/src/lib/session.ts +0 -295
  256. package/src/lib/sse.ts +0 -174
  257. package/src/lib/tier-auth.ts +0 -237
  258. package/src/lib/trial-keys.ts +0 -217
  259. package/src/mcp/dispatch.ts +0 -222
  260. package/src/mcp/execute.ts +0 -680
  261. package/src/mcp/request.ts +0 -152
  262. package/src/mcp/route-gates.ts +0 -119
  263. package/src/oauth/authorize.ts +0 -268
  264. package/src/oauth/discovery.ts +0 -48
  265. package/src/oauth/entitlements.ts +0 -77
  266. package/src/oauth/jwt.ts +0 -142
  267. package/src/oauth/register.ts +0 -72
  268. package/src/oauth/storage.ts +0 -66
  269. package/src/oauth/token.ts +0 -171
  270. package/src/package.ts +0 -59
  271. package/src/scheduled.ts +0 -310
  272. package/src/schemas/alerting.ts +0 -49
  273. package/src/schemas/audit.ts +0 -39
  274. package/src/schemas/auth.ts +0 -27
  275. package/src/schemas/dns.ts +0 -49
  276. package/src/schemas/internal.ts +0 -26
  277. package/src/schemas/json-rpc.ts +0 -20
  278. package/src/schemas/oauth.ts +0 -120
  279. package/src/schemas/primitives.ts +0 -58
  280. package/src/schemas/session.ts +0 -9
  281. package/src/schemas/tenant-alerts.ts +0 -118
  282. package/src/schemas/tenant-internal.ts +0 -143
  283. package/src/schemas/tool-args.ts +0 -270
  284. package/src/schemas/tool-definitions.ts +0 -452
  285. package/src/stdio.ts +0 -183
  286. package/src/tenants/adapters/tenant-d1.ts +0 -51
  287. package/src/tenants/adapters/tenant-kv.ts +0 -64
  288. package/src/tenants/adapters/tenant-r2.ts +0 -69
  289. package/src/tenants/alerts/diff.ts +0 -201
  290. package/src/tenants/alerts/index.ts +0 -12
  291. package/src/tenants/alerts/webhook.ts +0 -141
  292. package/src/tenants/analytics-stream.ts +0 -26
  293. package/src/tenants/audit.ts +0 -123
  294. package/src/tenants/db/drizzle.registry.config.ts +0 -18
  295. package/src/tenants/db/drizzle.tenant.config.ts +0 -21
  296. package/src/tenants/db/index.ts +0 -19
  297. package/src/tenants/db/migrations/registry/0000_minor_skaar.sql +0 -46
  298. package/src/tenants/db/migrations/registry/0001_wet_warhawk.sql +0 -23
  299. package/src/tenants/db/migrations/registry/0002_big_speedball.sql +0 -17
  300. package/src/tenants/db/migrations/registry/meta/0000_snapshot.json +0 -330
  301. package/src/tenants/db/migrations/registry/meta/0001_snapshot.json +0 -498
  302. package/src/tenants/db/migrations/registry/meta/0002_snapshot.json +0 -624
  303. package/src/tenants/db/migrations/registry/meta/_journal.json +0 -27
  304. package/src/tenants/db/migrations/tenant/0000_clear_clea.sql +0 -54
  305. package/src/tenants/db/migrations/tenant/0001_clumsy_master_mold.sql +0 -3
  306. package/src/tenants/db/migrations/tenant/meta/0000_snapshot.json +0 -375
  307. package/src/tenants/db/migrations/tenant/meta/0001_snapshot.json +0 -397
  308. package/src/tenants/db/migrations/tenant/meta/_journal.json +0 -20
  309. package/src/tenants/db/schema/registry.ts +0 -154
  310. package/src/tenants/db/schema/tenant.ts +0 -106
  311. package/src/tenants/discovery/dkim-key-reuse.ts +0 -250
  312. package/src/tenants/discovery/dmarc-rua-miner.ts +0 -186
  313. package/src/tenants/discovery/index.ts +0 -31
  314. package/src/tenants/discovery/ns-correlator.ts +0 -155
  315. package/src/tenants/discovery/san-correlator.ts +0 -212
  316. package/src/tenants/dns-fingerprint.ts +0 -313
  317. package/src/tenants/monitoring/index.ts +0 -17
  318. package/src/tenants/per-tenant-rate-limit.ts +0 -148
  319. package/src/tenants/queue-consumer.ts +0 -375
  320. package/src/tenants/routes.ts +0 -1014
  321. package/src/tenants/scheduled-handlers.ts +0 -550
  322. package/src/tenants/tenant-resolver.ts +0 -143
  323. package/src/tools/analyze-drift.ts +0 -235
  324. package/src/tools/assess-spoofability.ts +0 -224
  325. package/src/tools/batch-scan.ts +0 -163
  326. package/src/tools/caa-analysis.ts +0 -72
  327. package/src/tools/check-bimi.ts +0 -30
  328. package/src/tools/check-caa.ts +0 -23
  329. package/src/tools/check-cymru-asn.ts +0 -175
  330. package/src/tools/check-dane-https.ts +0 -29
  331. package/src/tools/check-dane.ts +0 -29
  332. package/src/tools/check-dbl.ts +0 -251
  333. package/src/tools/check-dkim.ts +0 -98
  334. package/src/tools/check-dmarc.ts +0 -25
  335. package/src/tools/check-dnssec-chain.ts +0 -284
  336. package/src/tools/check-dnssec.ts +0 -171
  337. package/src/tools/check-fast-flux.ts +0 -168
  338. package/src/tools/check-http-security.ts +0 -339
  339. package/src/tools/check-lookalikes.ts +0 -379
  340. package/src/tools/check-mta-sts.ts +0 -24
  341. package/src/tools/check-mx-reputation.ts +0 -174
  342. package/src/tools/check-mx.ts +0 -117
  343. package/src/tools/check-ns.ts +0 -30
  344. package/src/tools/check-nsec-walkability.ts +0 -173
  345. package/src/tools/check-rbl.ts +0 -235
  346. package/src/tools/check-rdap-lookup.ts +0 -333
  347. package/src/tools/check-resolver-consistency.ts +0 -151
  348. package/src/tools/check-shadow-domains.ts +0 -517
  349. package/src/tools/check-spf.ts +0 -48
  350. package/src/tools/check-srv.ts +0 -75
  351. package/src/tools/check-ssl.ts +0 -18
  352. package/src/tools/check-subdomailing.ts +0 -22
  353. package/src/tools/check-subdomain-takeover.ts +0 -24
  354. package/src/tools/check-svcb-https.ts +0 -22
  355. package/src/tools/check-tlsrpt.ts +0 -23
  356. package/src/tools/check-txt-hygiene.ts +0 -364
  357. package/src/tools/check-zone-hygiene.ts +0 -154
  358. package/src/tools/compare-baseline.ts +0 -199
  359. package/src/tools/compare-domains.ts +0 -182
  360. package/src/tools/dane-analysis.ts +0 -172
  361. package/src/tools/discover-brand-domains.ts +0 -377
  362. package/src/tools/discover-subdomains.ts +0 -487
  363. package/src/tools/dkim-analysis.ts +0 -86
  364. package/src/tools/dmarc-utils.ts +0 -114
  365. package/src/tools/dnssec-analysis.ts +0 -123
  366. package/src/tools/explain-finding-data.ts +0 -766
  367. package/src/tools/explain-finding.ts +0 -181
  368. package/src/tools/generate-fix-plan.ts +0 -196
  369. package/src/tools/generate-records.ts +0 -412
  370. package/src/tools/generate-rollout-plan.ts +0 -342
  371. package/src/tools/http-security-analysis.ts +0 -192
  372. package/src/tools/intelligence.ts +0 -331
  373. package/src/tools/lookalike-analysis.ts +0 -176
  374. package/src/tools/map-compliance.ts +0 -243
  375. package/src/tools/map-supply-chain.ts +0 -458
  376. package/src/tools/mta-sts-analysis.ts +0 -250
  377. package/src/tools/mx-analysis.ts +0 -55
  378. package/src/tools/mx-reputation-analysis.ts +0 -205
  379. package/src/tools/ns-analysis.ts +0 -162
  380. package/src/tools/provider-guides.ts +0 -404
  381. package/src/tools/resolve-spf-chain.ts +0 -254
  382. package/src/tools/scan/format-report.ts +0 -248
  383. package/src/tools/scan/maturity-staging.ts +0 -166
  384. package/src/tools/scan/post-processing.ts +0 -270
  385. package/src/tools/scan-domain.ts +0 -664
  386. package/src/tools/simulate-attack-paths.ts +0 -513
  387. package/src/tools/spf-analysis.ts +0 -203
  388. package/src/tools/spf-trust-surface.ts +0 -138
  389. package/src/tools/srv-analysis.ts +0 -118
  390. package/src/tools/ssl-analysis.ts +0 -102
  391. package/src/tools/subdomain-takeover-analysis.ts +0 -202
  392. package/src/tools/txt-hygiene-analysis.ts +0 -87
  393. package/src/tools/validate-fix.ts +0 -219
  394. package/src/tools/zone-hygiene-analysis.ts +0 -217
  395. package/src/types/env.d.ts +0 -6
  396. package/test/.!52131!.DS_Store +0 -0
  397. package/test/adaptive-weights.spec.ts +0 -359
  398. package/test/alerting.spec.ts +0 -91
  399. package/test/analytics-ip-hash.spec.ts +0 -90
  400. package/test/analytics-queries.spec.ts +0 -197
  401. package/test/analytics-stream.spec.ts +0 -32
  402. package/test/analytics.spec.ts +0 -205
  403. package/test/analyze-drift.spec.ts +0 -82
  404. package/test/assess-spoofability.spec.ts +0 -186
  405. package/test/audit.spec.ts +0 -250
  406. package/test/audits/fuzzing-config.audit.test.ts +0 -76
  407. package/test/audits/no-tracked-secrets.audit.test.ts +0 -166
  408. package/test/audits/oauth-readiness-gate.audit.test.ts +0 -83
  409. package/test/audits/tenant-capacity-readiness.audit.test.ts +0 -92
  410. package/test/audits/tenant-scale-quota.audit.test.ts +0 -35
  411. package/test/audits/tool-quota-coverage.audit.test.ts +0 -41
  412. package/test/audits/workflow-secret-check.audit.test.ts +0 -79
  413. package/test/auth.spec.ts +0 -94
  414. package/test/badge.spec.ts +0 -112
  415. package/test/batch-scan.spec.ts +0 -141
  416. package/test/caa-analysis.spec.ts +0 -24
  417. package/test/cache.spec.ts +0 -421
  418. package/test/category-interactions.spec.ts +0 -172
  419. package/test/chaos/fuzzing-degradation.chaos.test.ts +0 -50
  420. package/test/chaos/invariants.spec.ts +0 -181
  421. package/test/chaos/oauth-misconfiguration.chaos.test.ts +0 -132
  422. package/test/chaos/tenant-cron.chaos.test.ts +0 -276
  423. package/test/chaos/tenant-queue.chaos.test.ts +0 -272
  424. package/test/check-bimi.spec.ts +0 -160
  425. package/test/check-caa.spec.ts +0 -144
  426. package/test/check-cymru-asn.spec.ts +0 -239
  427. package/test/check-dane-https.spec.ts +0 -203
  428. package/test/check-dane.spec.ts +0 -234
  429. package/test/check-dbl.spec.ts +0 -214
  430. package/test/check-dkim.spec.ts +0 -413
  431. package/test/check-dmarc.spec.ts +0 -377
  432. package/test/check-dnssec-catch.spec.ts +0 -48
  433. package/test/check-dnssec-chain.spec.ts +0 -196
  434. package/test/check-dnssec.spec.ts +0 -271
  435. package/test/check-fast-flux.spec.ts +0 -201
  436. package/test/check-http-security.spec.ts +0 -420
  437. package/test/check-lookalikes.spec.ts +0 -860
  438. package/test/check-mta-sts.spec.ts +0 -196
  439. package/test/check-mx-reputation.spec.ts +0 -395
  440. package/test/check-mx.spec.ts +0 -183
  441. package/test/check-ns.spec.ts +0 -172
  442. package/test/check-nsec-walkability.spec.ts +0 -107
  443. package/test/check-rbl.spec.ts +0 -283
  444. package/test/check-rdap-lookup.spec.ts +0 -235
  445. package/test/check-resolver-consistency.spec.ts +0 -117
  446. package/test/check-shadow-domains.spec.ts +0 -883
  447. package/test/check-spf.spec.ts +0 -399
  448. package/test/check-srv.spec.ts +0 -160
  449. package/test/check-ssl.spec.ts +0 -192
  450. package/test/check-subdomailing.spec.ts +0 -308
  451. package/test/check-subdomain-takeover.spec.ts +0 -366
  452. package/test/check-svcb-https.spec.ts +0 -247
  453. package/test/check-tlsrpt.spec.ts +0 -70
  454. package/test/check-txt-hygiene.spec.ts +0 -414
  455. package/test/check-zone-hygiene.spec.ts +0 -234
  456. package/test/circuit-breaker.spec.ts +0 -171
  457. package/test/client-detection.spec.ts +0 -73
  458. package/test/compare-baseline.spec.ts +0 -221
  459. package/test/compare-domains.spec.ts +0 -46
  460. package/test/config.spec.ts +0 -216
  461. package/test/context-profiles.spec.ts +0 -215
  462. package/test/contracts/fuzzing-alert.contract.test.ts +0 -58
  463. package/test/contracts/oauth-tier.contract.test.ts +0 -53
  464. package/test/contracts/tenant-alerts.contract.test.ts +0 -79
  465. package/test/dane-analysis.spec.ts +0 -165
  466. package/test/data/batch_test.json +0 -1
  467. package/test/data/domains.json +0 -26976
  468. package/test/data/rescan_batch.json +0 -1
  469. package/test/data/sync_test.json +0 -1
  470. package/test/data/temp_sync_batch.json +0 -1
  471. package/test/discover-brand-domains.spec.ts +0 -215
  472. package/test/discover-subdomains.spec.ts +0 -382
  473. package/test/dispatch-reinitialize.spec.ts +0 -101
  474. package/test/dkim-analysis.spec.ts +0 -48
  475. package/test/dmarc-utils.spec.ts +0 -27
  476. package/test/dns-multi-resolver.spec.ts +0 -109
  477. package/test/dns-records-new.spec.ts +0 -244
  478. package/test/dns-records.spec.ts +0 -20
  479. package/test/dns-semaphore.spec.ts +0 -184
  480. package/test/dns-transport.spec.ts +0 -669
  481. package/test/dns.spec.ts +0 -118
  482. package/test/dnssec-analysis.spec.ts +0 -48
  483. package/test/env.d.ts +0 -3
  484. package/test/explain-finding.spec.ts +0 -578
  485. package/test/format-report.spec.ts +0 -273
  486. package/test/format-scan-report.spec.ts +0 -160
  487. package/test/freemium-limits.spec.ts +0 -102
  488. package/test/freemium-model.spec.ts +0 -143
  489. package/test/fuzzing-alert-dedup.test.ts +0 -82
  490. package/test/fuzzing-counter.integration.test.ts +0 -75
  491. package/test/fuzzing-detector.test.ts +0 -87
  492. package/test/fuzzing-e2e.integration.test.ts +0 -114
  493. package/test/generate-discovery-report.spec.ts +0 -337
  494. package/test/generate-fix-plan.spec.ts +0 -219
  495. package/test/generate-records.spec.ts +0 -241
  496. package/test/generate-rollout-plan.spec.ts +0 -261
  497. package/test/handlers-prompts.spec.ts +0 -96
  498. package/test/handlers-resources.spec.ts +0 -85
  499. package/test/handlers-tools.spec.ts +0 -1042
  500. package/test/helpers/dns-mock.ts +0 -155
  501. package/test/http-security-analysis.spec.ts +0 -242
  502. package/test/index.spec.ts +0 -1721
  503. package/test/intelligence.spec.ts +0 -217
  504. package/test/internal-guard.spec.ts +0 -34
  505. package/test/internal-tools-analytics-auth.test.ts +0 -102
  506. package/test/internal-tools-call-body-limit.test.ts +0 -45
  507. package/test/internal-trial-keys-auth.spec.ts +0 -99
  508. package/test/internal.spec.ts +0 -411
  509. package/test/ip-utils.spec.ts +0 -127
  510. package/test/kv-fallback-logging.spec.ts +0 -220
  511. package/test/legacy-session-validation.spec.ts +0 -113
  512. package/test/legacy-sse.spec.ts +0 -140
  513. package/test/log-cf-ip-redaction.test.ts +0 -30
  514. package/test/log.spec.ts +0 -189
  515. package/test/lookalike-analysis.spec.ts +0 -67
  516. package/test/map-compliance.spec.ts +0 -284
  517. package/test/map-supply-chain.spec.ts +0 -584
  518. package/test/maturity-staging.spec.ts +0 -312
  519. package/test/mcp-dispatch.spec.ts +0 -123
  520. package/test/mcp-execute.spec.ts +0 -1259
  521. package/test/mcp-request.spec.ts +0 -115
  522. package/test/mcp-route-gates.spec.ts +0 -88
  523. package/test/mta-sts-analysis.spec.ts +0 -74
  524. package/test/mx-analysis.spec.ts +0 -32
  525. package/test/mx-reputation-analysis.spec.ts +0 -116
  526. package/test/ns-analysis.spec.ts +0 -49
  527. package/test/oauth/authorize-get.spec.ts +0 -170
  528. package/test/oauth/authorize-post.spec.ts +0 -286
  529. package/test/oauth/authorize-zod-leak.test.ts +0 -40
  530. package/test/oauth/bearer-jwt.spec.ts +0 -152
  531. package/test/oauth/discovery.spec.ts +0 -51
  532. package/test/oauth/e2e.spec.ts +0 -141
  533. package/test/oauth/entitlements.spec.ts +0 -110
  534. package/test/oauth/internal-grant.spec.ts +0 -183
  535. package/test/oauth/jwt.spec.ts +0 -91
  536. package/test/oauth/pkce.spec.ts +0 -57
  537. package/test/oauth/register.spec.ts +0 -79
  538. package/test/oauth/storage.spec.ts +0 -74
  539. package/test/oauth/token.spec.ts +0 -270
  540. package/test/output-sanitize.spec.ts +0 -450
  541. package/test/package-api.spec.ts +0 -35
  542. package/test/profile-accumulator.spec.ts +0 -567
  543. package/test/provider-guides.spec.ts +0 -74
  544. package/test/provider-signature-source.spec.ts +0 -68
  545. package/test/provider-signatures.spec.ts +0 -112
  546. package/test/public-suffix.spec.ts +0 -197
  547. package/test/queue-consumer-analytics.spec.ts +0 -65
  548. package/test/quota-coordinator.spec.ts +0 -74
  549. package/test/rate-limit-chaos.spec.ts +0 -529
  550. package/test/rate-limiter-kv-reset.test.ts +0 -62
  551. package/test/rate-limiter-memory.spec.ts +0 -31
  552. package/test/rate-limiter-ttl.spec.ts +0 -100
  553. package/test/rate-limiter.spec.ts +0 -491
  554. package/test/resolve-spf-chain.spec.ts +0 -183
  555. package/test/safe-fetch.test.ts +0 -45
  556. package/test/sanitize.spec.ts +0 -233
  557. package/test/scan-domain-cache-status.test.ts +0 -128
  558. package/test/scan-domain-provider-inference.spec.ts +0 -93
  559. package/test/scan-domain-safe-check.spec.ts +0 -91
  560. package/test/scan-domain.spec.ts +0 -1063
  561. package/test/scan-post-processing.spec.ts +0 -663
  562. package/test/scheduled.spec.ts +0 -104
  563. package/test/schemas/audit.test.ts +0 -140
  564. package/test/schemas/auth.spec.ts +0 -36
  565. package/test/schemas/dns.spec.ts +0 -48
  566. package/test/schemas/internal.spec.ts +0 -50
  567. package/test/schemas/json-rpc.spec.ts +0 -63
  568. package/test/schemas/oauth.spec.ts +0 -104
  569. package/test/schemas/primitives.spec.ts +0 -131
  570. package/test/schemas/session.spec.ts +0 -21
  571. package/test/schemas/tenant-alerts.test.ts +0 -126
  572. package/test/schemas/tenant-internal.test.ts +0 -128
  573. package/test/schemas/tool-args.spec.ts +0 -166
  574. package/test/schemas/tool-definitions.spec.ts +0 -67
  575. package/test/scoring-config-cached.spec.ts +0 -63
  576. package/test/scoring-config.spec.ts +0 -177
  577. package/test/scoring-determinism.spec.ts +0 -162
  578. package/test/scoring-engine.spec.ts +0 -134
  579. package/test/scoring-model.spec.ts +0 -44
  580. package/test/scoring-profiles.spec.ts +0 -235
  581. package/test/scoring.spec.ts +0 -197
  582. package/test/security-hardening.spec.ts +0 -58
  583. package/test/session-degradation-event.spec.ts +0 -66
  584. package/test/session-keepalive.spec.ts +0 -347
  585. package/test/session-kv-failure-logging.spec.ts +0 -99
  586. package/test/session-memory.spec.ts +0 -111
  587. package/test/session-recovery.spec.ts +0 -260
  588. package/test/session.spec.ts +0 -266
  589. package/test/simulate-attack-paths.spec.ts +0 -888
  590. package/test/spf-analysis.spec.ts +0 -29
  591. package/test/spf-trust-surface.spec.ts +0 -62
  592. package/test/srv-analysis.spec.ts +0 -151
  593. package/test/sse.spec.ts +0 -44
  594. package/test/ssl-analysis.spec.ts +0 -27
  595. package/test/stdio.spec.ts +0 -71
  596. package/test/streaming-sse.spec.ts +0 -419
  597. package/test/subdomain-takeover-analysis.spec.ts +0 -104
  598. package/test/tenants/alerts/diff.test.ts +0 -127
  599. package/test/tenants/alerts/webhook.test.ts +0 -129
  600. package/test/tenants/audit.test.ts +0 -220
  601. package/test/tenants/cron.integration.test.ts +0 -117
  602. package/test/tenants/db/registry-schema.spec.ts +0 -254
  603. package/test/tenants/db/tenant-schema.spec.ts +0 -202
  604. package/test/tenants/discovery/dkim-key-reuse.test.ts +0 -213
  605. package/test/tenants/discovery/dmarc-rua-miner.test.ts +0 -179
  606. package/test/tenants/discovery/ns-correlator.test.ts +0 -186
  607. package/test/tenants/discovery/san-correlator.test.ts +0 -128
  608. package/test/tenants/discovery-route.integration.test.ts +0 -135
  609. package/test/tenants/dns-fingerprint.test.ts +0 -321
  610. package/test/tenants/hammer-stress.integration.test.ts +0 -136
  611. package/test/tenants/per-tenant-rate-limit.test.ts +0 -119
  612. package/test/tenants/phase6-fingerprint.integration.test.ts +0 -147
  613. package/test/tenants/provision-tenant.test.ts +0 -351
  614. package/test/tenants/queue-consumer.integration.test.ts +0 -355
  615. package/test/tenants/queue-producer.integration.test.ts +0 -219
  616. package/test/tenants/routes.integration.test.ts +0 -783
  617. package/test/tenants/scheduled-handlers.integration.test.ts +0 -713
  618. package/test/tenants/tenant-d1.spec.ts +0 -78
  619. package/test/tenants/tenant-kv.spec.ts +0 -104
  620. package/test/tenants/tenant-r2.spec.ts +0 -103
  621. package/test/tier-auth-jwt-enum.test.ts +0 -55
  622. package/test/tier-auth-owner-jwt-ip.test.ts +0 -80
  623. package/test/tier-auth.spec.ts +0 -191
  624. package/test/tool-args.spec.ts +0 -101
  625. package/test/tool-execution.spec.ts +0 -421
  626. package/test/tool-formatters.spec.ts +0 -84
  627. package/test/tool-metadata.spec.ts +0 -25
  628. package/test/tool-schemas.spec.ts +0 -113
  629. package/test/trial-keys.spec.ts +0 -367
  630. package/test/tsconfig.json +0 -8
  631. package/test/txt-hygiene-analysis.spec.ts +0 -118
  632. package/test/validate-fix.spec.ts +0 -71
  633. package/test/validate-outbound-url.test.ts +0 -63
  634. package/test/wasm-integration.test.ts +0 -32
  635. package/test/zone-hygiene-analysis.spec.ts +0 -172
  636. package/tsconfig.json +0 -40
  637. package/tsup.config.ts +0 -42
  638. package/vitest.config.mts +0 -33
  639. package/wrangler.jsonc +0 -70
  640. package/wrangler.private.example.jsonc +0 -31
package/LICENSE CHANGED
@@ -4,7 +4,7 @@ Parameters
4
4
 
5
5
  Licensor: BLACKVEIL Security
6
6
  Licensed Work: Blackveil DNS
7
- The Licensed Work is (c) 2025-2026 BLACKVEIL Security
7
+ The Licensed Work is (c) 2023-2026 BLACKVEIL Security
8
8
  Additional Use Grant: You may make non-commercial use of the Licensed Work.
9
9
  "Non-commercial use" means use that is not intended for
10
10
  or directed toward commercial advantage or monetary
package/README.md CHANGED
@@ -4,17 +4,16 @@
4
4
 
5
5
  **Know where you stand.**
6
6
 
7
- Open-source DNS & email security scanner for Claude, Cursor, VS Code, and MCP clients across Streamable HTTP, stdio, and legacy HTTP+SSE.
7
+ Source-available DNS & email security scanner for Claude, Cursor, VS Code, and MCP clients across Streamable HTTP, stdio, and legacy HTTP+SSE.
8
8
 
9
9
  [![GitHub stars](https://img.shields.io/github/stars/MadaBurns/bv-mcp?style=flat&logo=github)](https://github.com/MadaBurns/bv-mcp/stargazers)
10
- [![npm version](https://img.shields.io/npm/v/blackveil-dns)](https://www.npmjs.com/package/blackveil-dns)
11
- [![npm downloads](https://img.shields.io/npm/dm/blackveil-dns)](https://www.npmjs.com/package/blackveil-dns)
12
- [![Tests](https://img.shields.io/badge/Tests-2610-brightgreen)](https://github.com/MadaBurns/bv-mcp/actions)
13
- [![Coverage](https://img.shields.io/badge/Coverage-~90%25-brightgreen)](https://github.com/MadaBurns/bv-mcp/actions)
10
+ [![MCP tools](https://img.shields.io/badge/MCP%20tools-81-brightgreen)](https://github.com/MadaBurns/bv-mcp/actions)
14
11
  [![BUSL-1.1 License](https://img.shields.io/badge/License-BUSL--1.1-blue.svg)](LICENSE)
15
- [![MCP](https://img.shields.io/badge/MCP-2025--03--26-blue)](https://modelcontextprotocol.io/)
12
+ [![MCP](https://img.shields.io/badge/MCP-2025--06--18-blue)](https://modelcontextprotocol.io/)
16
13
  [![Cloudflare Workers](https://img.shields.io/badge/Cloudflare%20Workers-F38020?logo=cloudflare&logoColor=white)](https://workers.cloudflare.com/)
17
- [![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
14
+ [![TypeScript](https://img.shields.io/badge/TypeScript-6.0-3178C6?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
15
+ [![Support on Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20us-FF5E5B?logo=ko-fi&logoColor=white)](https://ko-fi.com/madaburns)
16
+ [![MCP Queen operational grade](https://mcpqueen.com/badge/com.blackveilsecurity/dns.svg)](https://mcpqueen.com/s/com.blackveilsecurity/dns)
18
17
 
19
18
  ![DNS Security](https://dns-mcp.blackveilsecurity.com/badge/blackveilsecurity.com)
20
19
 
@@ -26,7 +25,7 @@ Open-source DNS & email security scanner for Claude, Cursor, VS Code, and MCP cl
26
25
 
27
26
  **Claude Desktop** (one-click install):
28
27
 
29
- Download the [Blackveil DNS extension](https://github.com/MadaBurns/bv-claude-dns/releases/latest/download/bv-claude-dns.mcpb) and open it — all 51 tools available instantly. [Verify your download](https://blackveilsecurity.com/extensions/claude-dns#install).
28
+ Download the [Blackveil DNS extension](https://github.com/MadaBurns/bv-claude-dns/releases/latest/download/bv-claude-dns.mcpb) and open it — the current 81-tool surface is available instantly. [Verify your download](https://blackveilsecurity.com/extensions/claude-dns#install).
30
29
 
31
30
  **Claude Code** (one command):
32
31
 
@@ -62,69 +61,162 @@ Transport support:
62
61
  - `Native stdio`: `blackveil-dns-mcp` CLI from the `blackveil-dns` npm package
63
62
  - `Legacy HTTP+SSE`: `GET /mcp/sse` bootstrap stream plus `POST /mcp/messages?sessionId=...`
64
63
 
64
+ For Streamable HTTP, clients should retain the `Mcp-Session-Id` returned by `initialize` and send it on every subsequent request, including notifications. Send the negotiated version in `MCP-Protocol-Version`; unsupported values are rejected with HTTP `400`, while expired or terminated sessions return `404` and require a fresh `initialize`.
65
+
65
66
  ---
66
67
 
67
68
  ## What you get
68
69
 
69
- - **80+ checks across 20 categories** — SPF, DMARC, DKIM, DNSSEC, SSL/TLS, MTA-STS, NS, CAA, MX, BIMI, TLS-RPT, subdomain takeover, lookalike domains, HTTP security headers, DANE, shadow domains, TXT hygiene, MX reputation, SRV, zone hygiene
70
+ - **81 MCP tools with 19 scoring categories** — SPF, DMARC, DKIM, DNSSEC, SSL/TLS, MTA-STS, NS, CAA, MX, BIMI, TLS-RPT, subdomain takeover, HTTP security headers, DANE, SVCB/HTTPS, DANE-HTTPS, subdomailing, reverse DNS (PTR/FCrDNS), and DNSKEY strength
70
71
  - **Maturity staging** — Stage 0-4 classification (Unprotected to Hardened) with score-based capping to prevent inflated labels
71
- - **Trust surface analysis** — detects shared SaaS platforms (Google, M365, SendGrid) and cross-references DMARC enforcement to determine real exposure
72
- - **Guided remediation** — `generate_fix_plan` produces provider-aware prioritized actions; record generators output ready-to-publish records; `validate_fix` confirms whether a fix was applied successfully
72
+ - **Trust surface analysis** — detects shared SaaS senders in SPF, both cataloged platforms (Google, M365, SendGrid) and uncataloged hosts identifiable by their `spf` delegation label, then cross-references DMARC enforcement to determine real exposure
73
+ - **Guided remediation** — `generate` (artifact=`fix_plan`) produces provider-aware prioritized actions; its record artifacts (`spf_record`, `dmarc_record`, `dkim_config`, `mta_sts_policy`, `rollout_plan`) output ready-to-publish records; `validate_fix` confirms whether a fix was applied successfully
73
74
  - **Supply chain mapping** — `map_supply_chain` correlates DNS signals to build a full third-party dependency graph with trust levels and risk signals
74
75
  - **Attack path simulation** — `simulate_attack_paths` enumerates specific paths (spoofing, takeover, hijack) with severity, steps, and mitigations
75
76
  - **Compliance mapping** — `map_compliance` maps scan findings to NIST 800-177, PCI DSS 4.0, SOC 2, and CIS Controls
76
77
  - **Self-tuning scoring** — adaptive weights adjust category importance based on patterns seen across scans via Durable Object telemetry
77
78
  - **Per-tier analytics** — usage tracking by auth tier with operator API for tier summaries, key-level usage, and daily digests
78
- - **Passive and read-only** — all checks use public Cloudflare DNS-over-HTTPS; no authorization required from the target
79
+ - **Read-only** — checks never modify a target and need no authorization from it. Most are passive lookups over public Cloudflare DNS-over-HTTPS; `check_authoritative_dns_infra` and `check_root_server_set` query authoritative and root nameservers directly over TCP/53, and for authenticated callers `check_authoritative_dns_infra` also tests whether a domain's nameservers refuse a zone transfer (no zone data is retrieved)
79
80
 
80
81
  ---
81
82
 
82
83
  ## Tools
83
84
 
84
85
  ```
85
- 52 MCP tools · 7 prompts · 6 resources
86
-
87
- Email Auth Infrastructure Brand & Threats Meta
88
- ──────────── ──────────────── ───────────────── ──────────────────────
89
- check_spf check_dnssec check_bimi scan_domain
90
- check_dmarc check_ns check_tlsrpt batch_scan
91
- check_dkim check_caa check_lookalikes compare_domains
92
- check_mta_sts check_ssl check_shadow_domains compare_baseline
93
- check_mx check_http_security explain_finding
94
- check_mx_reputation check_dane Intelligence
95
- check_subdomailing check_dane_https ────────────── Remediation
96
- check_svcb_https get_benchmark ──────────────
97
- DNS Hygiene check_srv get_provider_ generate_fix_plan
98
- ──────────── check_zone_hygiene insights generate_spf_record
99
- check_txt_hygiene check_resolver_ assess_spoofability generate_dmarc_record
100
- consistency map_supply_chain generate_dkim_config
101
- resolve_spf_chain generate_mta_sts_policy
102
- discover_subdomains generate_rollout_plan
103
- map_compliance validate_fix
104
- simulate_attack_paths
105
- analyze_drift
106
-
107
- Discovery
108
- ──────────────
109
- discover_brand_domains (Phase-4 brand portfolio aggregator)
110
-
111
- + check_subdomain_takeover (internal — runs inside scan_domain)
86
+ 81 MCP tools · 7 prompts · 6 resources
87
+
88
+ Email Auth Infrastructure Brand & Threats Meta
89
+ ───────────── ────────────── ─────────────── ───────────────
90
+ check_mx check_dnssec check_bimi scan_domain
91
+ check_spf check_ssl check_tlsrpt batch_scan
92
+ check_dmarc check_ns check_lookalikes compare_domains
93
+ check_dkim check_caa check_shadow_domains compare_baseline
94
+ check_mta_sts check_http_security explain_finding
95
+ check_subdomailing check_dane
96
+ check_mx_reputation check_dane_https DNS Hygiene Remediation
97
+ check_svcb_https ───────────── ───────────────
98
+ check_ptr check_txt_hygiene generate (one tool;
99
+ Intelligence check_srv artifact=fix_plan,
100
+ ───────────── check_zone_hygiene spf_record,
101
+ get_benchmark check_resolver_ Discovery dmarc_record,
102
+ get_domain_rank consistency ───────────── dkim_config,
103
+ get_provider_ discover_brand_ mta_sts_policy,
104
+ insights check_dbl domains rollout_plan)
105
+ assess_spoofability check_rbl brand_audit_single validate_fix
106
+ map_supply_chain cymru_asn brand_audit_batch_
107
+ analyze_drift rdap_lookup start
108
+ resolve_spf_chain check_nsec_ brand_audit_status
109
+ discover_subdomains walkability brand_audit_get_
110
+ map_compliance check_dnssec_chain report
111
+ prioritize_portfolio_
112
+ leads
113
+ simulate_attack_paths check_fast_flux list_brand_audit_watches
114
+ check_agent_discovery check_dnskey_strength
115
+ check_llms_txt check_authoritative_dns_infra
116
+ check_root_server_set register_brand_audit_watch
117
+ delete_brand_audit_watch
118
+
119
+ + check_subdomain_takeover (standalone tool + internal — runs inside scan_domain)
120
+ + check_authoritative_dns_infra and check_root_server_set (authoritative DNS infrastructure profile)
121
+ + batch_scan_start / batch_scan_status / batch_scan_findings
122
+ (async start → poll → fetch sibling of batch_scan)
123
+ + sge_quickscan (NZ Secure Government Email readiness for one domain)
124
+ + discover_brand_domains_start / discover_brand_domains_status / discover_brand_domains_findings
125
+ (async start → poll → fetch sibling of discover_brand_domains, for clients that time out on the ~24s sync call)
126
+
127
+ Operator-deploy only (BV_RECON binding; degrade to unprovisioned on self-hosted BUSL deployments):
128
+ + check_realtime_threat_feed — curated intel-gateway threat feed lookup
129
+ + scan_buckets_start — async cloud-bucket discovery scan (start → poll → findings)
130
+ + scan_buckets_status — poll status of a running bucket scan
131
+ + scan_buckets_findings — retrieve findings for a completed bucket scan
132
+ + osint_investigate_domain_start — async domain OSINT investigation (start → poll → report)
133
+ + osint_investigate_infrastructure_start — async deep-infrastructure OSINT (domain, IP, or org)
134
+ + osint_investigate_supply_chain_start — async supply-chain OSINT investigation
135
+ + osint_investigate_username_start — async username OSINT (owner/enterprise tier only)
136
+ + osint_investigate_email_start — async email OSINT (owner/enterprise tier only)
137
+ + osint_investigation_status — poll status of any running OSINT investigation
138
+ + osint_investigation_report — retrieve report for a completed OSINT investigation
139
+
140
+ Internal-only compatibility surface (withdrawn from public `tools/list`; the three active Microsoft 365 / Entra tools proxy through `BV_WEB` and degrade to unprovisioned without it):
141
+ + query_signins — query Microsoft Entra sign-in logs for a tenant
142
+ + query_ual — DEPRECATED tombstone; valid, authorized calls return query_ual_deprecated with no tenant-data access
143
+ + get_ca_policies — retrieve Conditional Access policies for an Entra tenant
144
+ + assess_coverage — assess Conditional Access coverage gaps for an Entra tenant
145
+ + map_registrar_products — map a domain's gaps to registrar brand-protection products
112
146
  ```
113
147
 
148
+ ### Tool discovery metadata (`_meta`)
149
+
150
+ `tools/list` returns every tool with server-specific discovery metadata under each tool's `_meta` (the MCP-sanctioned extension point), so a client can group or filter the surface without hard-coding tool names:
151
+
152
+ - `group` — functional group (`email_auth`, `infrastructure`, `brand_threats`, `dns_hygiene`, `intelligence`, `remediation`, `discovery`, `identity_secops`, `meta`).
153
+ - `tier` — scoring tier (`core` / `protective` / `hardening`); absent for non-scoring tools.
154
+ - `scanIncluded` — `true` when the tool runs inside `scan_domain`'s parallel audit.
155
+ - `recommended` — present (`true`) only on the curated **starter set** (`scan_domain`, `explain_finding`, `compare_baseline`); omitted otherwise. A client facing the full surface can lead with `tools.filter(t => t._meta.recommended)` to avoid overwhelming an LLM with all tools flat. Every tool is still listed — this is an additive signal, not a filter.
156
+
157
+ ### Authoritative DNS infrastructure
158
+
159
+ `check_authoritative_dns_infra` measures authoritative DNS infrastructure posture for a hostname over direct DNS-over-TCP/53 from a single vantage, via the `BV_INFRA_PROBE` service binding: TCP/53 reachability, the authoritative AA flag, recursion exposure, SOA serial consistency across nameservers, DNSKEY/RRSIG presence (not validation), IPv4/IPv6 answer parity, and unsupported-query handling. For authenticated callers only, it also runs a zone-transfer refusal test (first response only — no zone data is ever retrieved) and CHAOS `version.bind`/`id.server` disclosure. It does not measure, and reports as inconclusive: UDP/53 reachability, amplification, EDNS large-response/truncation, DNS cookies/RRL, BGP origin, RPKI, route-leak signals, anycast diversity, vantage latency, and RIR/RDAP.
160
+
161
+ `check_root_server_set` queries a rotating sample of 3 root servers per call and compares the priming NS set, glue, SOA serials, and cross-root consistency with the embedded official root hints, via `BV_INFRA_PROBE`.
162
+
163
+ Self-hosted or local deployments without `BV_INFRA_PROBE` still return structured partial results. The worker-only mode records the embedded root hints and marks every live-probe capability inconclusive rather than pretending it ran; both tools then withhold their verdict (`checkStatus: 'error'`, excluded from scoring) instead of grading reference data.
164
+
114
165
  ---
115
166
 
116
167
  ## Quality & Reliability
117
168
 
118
- The server is continuously validated using a **comprehensive chaos test suite** that covers all detected MCP client types:
169
+ The server classifies detected MCP clients by their default response format:
119
170
 
120
- - **Interactive clients**: `claude_mobile`, `claude_code`, `cursor`, `vscode`, `claude_desktop`, `windsurf` (auto-format: `compact`)
121
- - **Non-interactive clients**: `mcp_remote`, `blackveil_dns_action`, `bv_claude_dns_proxy`, `bv_load_test`, `unknown` (auto-format: `full`)
171
+ - **Interactive clients**: `claude_mobile`, `claude_code`, `cursor`, `vscode`, `claude_desktop`, `claude_connector`, `windsurf` (auto-format: `compact`)
172
+ - **Non-interactive clients**: `mcp_remote`, `blackveil_dns_action`, `bv_claude_dns_proxy`, `unknown` (auto-format: `full`)
122
173
 
123
174
  The `bv_load_test` class identifies internal load/chaos/tranco-scan traffic so it stays out of real-client analytics segments.
124
175
 
125
- The test suite ensures session stability, authentication precedence, and transport-specific edge cases across Streamable HTTP and Legacy SSE.
176
+ The comprehensive chaos suite validates session stability, authentication precedence, format negotiation, and transport-specific edge cases across Streamable HTTP and Legacy SSE for its supported client fixtures. Without an API key it exercises the public/free-tier path; with a valid key exported as `BV_API_KEY`, it covers Bearer authentication, legacy self-host `?api_key=` compatibility, authenticated SSE bootstrap, and authenticated batch behavior.
177
+
178
+ Run the client/session chaos suite locally: `python3 scripts/chaos/chaos-test-clients.py`.
179
+
180
+ Run repeat force-refresh scans to detect production scoring drift:
181
+
182
+ ```bash
183
+ BV_API_KEY=... python3 scripts/chaos/score-stability-test.py --count 20 --rounds 3 --concurrency 5
184
+ ```
185
+
186
+ The stability harness negotiates MCP protocol `2025-06-18`, accepts JSON and Streamable HTTP SSE responses, and exits non-zero on any transport/tool error or score/category drift. Use `--from <json-file>` with a JSON array of domains for a targeted provider-diversity sweep.
187
+
188
+ SSOT guardrails are enforced by focused audit tests:
126
189
 
127
- Run the chaos tests locally: `python3 scripts/chaos/chaos-test-clients.py`
190
+ - Tool counts and public resource copy are **generated** from the `TOOLS` registry, not hand-written — `npm run generate:tool-surface` rewrites every advertised count, and `npm run check:tool-surface` fails CI if any drifts. Counts advertised to clients use the **public** surface (`TOOLS` minus internal-only tools), so the number in the docs, the badge, the VS Code listing and the `resources/read` copy is the number `tools/list` actually returns.
191
+ - Domain-required validation is derived from each tool input schema.
192
+ - Scan timeout budgets are resolved from shared runtime config.
193
+ - WASM tool permissions are generated from MCP tool annotations.
194
+ - Public quota copy is checked against runtime quota config.
195
+
196
+ ### Version stamps in scan output
197
+
198
+ Every `scan_domain` / `batch_scan` result carries three reproducibility stamps. They are **three different namespaces** — do not compare them to each other, and do not read any of them as the npm package version unless it says so:
199
+
200
+ | Field | What it tracks | How often it moves |
201
+ | --- | --- | --- |
202
+ | `scoringModelVersion` | The scoring **policy**: category weights, profile weights, grade thresholds, severity penalties, the `passed`/missing-control rule, profile detection. | Only when a change alters scores or grades. Slowly — most releases do not touch it. |
203
+ | `dnsChecksPackageVersion` | The `@blackveil/dns-checks` **engine package** version bundled by the running build. | Every package release — code, new detections, bug fixes. |
204
+ | `scoringConfigHash` | Fingerprint of the **effective scoring configuration** that produced this result, including any `SCORING_CONFIG` override. | Whenever the effective config differs. |
205
+
206
+ `scoringModelVersion` is **independent of** `dnsChecksPackageVersion` and is normally **lower** — for example model `1.10.0` alongside package `1.18.0`. That is not a version gap, and it does not mean a consumer's vendored copy scores differently from the hosted service: the package advanced eight minors without changing scoring policy. Reading the model version as the package version has twice triggered a false "engine version gap" investigation, which is why both are now emitted side by side.
207
+
208
+ **When you publish or cite a score, record `scoringConfigHash`** — not either version number. It is the value that identifies the exact scoring configuration behind a result, so two scans carrying the same hash were graded under the same rules.
209
+
210
+ ### Status badge
211
+
212
+ `GET /badge/<domain>` returns an embeddable SVG — the badge at the top of this README is a live scan of our own domain. It needs no authentication and is subject to the same anonymous rate limits and daily caps as a public scan.
213
+
214
+ The badge shows the **same customer-facing letter** `scan_domain` reports — the NIST-aligned 6-band grade (A+ ≥95, A ≥90, B ≥80, C ≥70, D ≥60, F <60) — so a domain cannot show one grade on its badge and a different one in its report. Two further states are stated rather than papered over:
215
+
216
+ - **`<grade> partial`** — the scan was graded, but did not complete every check (a WAF challenge, a timeout, an unreachable host). The hover/aria title gives the exact coverage, e.g. `17 of 19 checks measured`. The grade and its colour are unchanged: coverage and posture are different axes.
217
+ - **`unknown`** — the domain could not be measured at all. The badge says so instead of substituting a letter, which would publish a failing grade nobody measured.
218
+
219
+ See [**docs/scoring.md**](docs/scoring.md) for the grade scales and the evidence rules behind them.
128
220
 
129
221
  ---
130
222
 
@@ -146,7 +238,7 @@ Run the chaos tests locally: `python3 scripts/chaos/chaos-test-clients.py`
146
238
  │
147
239
  ┌───▼──────────────────────┐
148
240
  │ Tool Handlers │
149
- │ 16 checks in parallel │
241
+ │ 19 scoring categories │
150
242
  └───┬──────────────────────┘
151
243
  │
152
244
  ┌───▼──────────────────────┐
@@ -161,35 +253,111 @@ Run the chaos tests locally: `python3 scripts/chaos/chaos-test-clients.py`
161
253
  ```
162
254
 
163
255
  - **Generic Scoring Engine**: Runtime-agnostic, string-keyed three-tier scoring with configurable weights
256
+ - **Infra Probe Binding**: Optional `BV_INFRA_PROBE` service binding supplies live DNS-over-TCP/53 authoritative DNS and root-server evidence for the authoritative DNS infrastructure profile
257
+ - **CT Index Binding**: Optional `BV_CERTSTREAM` service binding supplies Certificate Transparency names for `discover_subdomains` and SAN correlation. Operator deployments point it at the owned `bv-ct-index` sidecar (`packages/bv-ct-index`), a forward-only names index built from the public CT logs; source order stays binding, then crt.sh, then CertSpotter, then the last-known-good cache, so the direct sources remain the fallback. See [`docs/bv-ct-index-runbook.md`](docs/bv-ct-index-runbook.md)
164
258
  - **WASM Policy Engine**: High-performance permission and token checks via `bv-wasm-core`
165
259
  - **Reliable Sessions**: Hardened tombstone logic prevents race-condition revival of terminated sessions
260
+ - **Protocol Enforcement**: Unsupported MCP versions fail closed; notifications and SSE connections use the same session-validity rules as other post-initialize requests
261
+ - **Bounded Egress**: Public CT and target-HTML responses are streamed under byte ceilings before parsing or fingerprinting
262
+ - **Cryptographic Identifiers**: Session and brand-report identifiers use Web Crypto randomness
166
263
  - **Adaptive Scoring**: Durable Object telemetry adjusts weights based on real-world distributions
167
264
  - **Client Awareness**: Automatic response formatting (`compact` vs `full`) based on client `User-Agent`
168
265
 
266
+ ### Brand-discovery modes (`discover_brand_domains` / `brand_audit_*`)
267
+
268
+ The `discovery_mode` argument accepts two values:
269
+
270
+ - **`classic`** (the default everywhere this repo runs out-of-the-box) — the public, BUSL-licensed signal-sweep pipeline. Uses only public-internet data sources (DNS, RDAP, CT logs, MX/TXT inspection). This is the only mode supported for self-hosted deployments and the only mode the open test suite covers end-to-end.
271
+ - **`tiered`** — layers a portfolio-aware Tier 0 / infrastructure-graph Tier 1 / declared-evidence Tier 2 pipeline in front of the classic sweep. Tiered mode requires private BlackVeil-internal cross-Worker bindings (`BV_INFRA_GRAPH`, `BV_INTEL_GATEWAY`, `BV_ENTERPRISE`) that are **not packaged with the open distribution** — they live in BlackVeil's production deploy overlay (`.dev/wrangler.deploy.jsonc`) and call into proprietary Workers. Self-hosters cannot enable tiered mode without those bindings.
272
+
273
+ BlackVeil's hosted production at `dns-mcp.blackveilsecurity.com` flips its runtime default to `tiered` via the env var `BRAND_AUDIT_DISCOVERY_MODE_DEFAULT="tiered"` in the private overlay; the public schema default in `src/schemas/tool-args.ts` stays `'classic'` permanently so anyone building from `main` gets the BUSL-licensed behaviour unchanged. An explicit caller-supplied `discovery_mode` always wins over the env default.
274
+
169
275
  ---
170
276
 
171
277
  ## Client setup
172
278
 
173
- The free tier requires no authentication. Authenticated requests bypass per-IP rate limits and follow your tier's daily quota. Three authentication methods are supported:
279
+ The free tier requires no authentication. Authenticated requests bypass per-IP rate limits and follow your tier's daily quota. Hosted production supports:
174
280
 
175
281
  - **Header**: `Authorization: Bearer <KEY>`
176
- - **Query Param**: `?api_key=<KEY>` (for clients that can't send custom headers — Smithery, Claude Code)
282
+ - **Header (alternative)**: `X-API-Key: <KEY>` — for clients that cannot set `Authorization`. If both are sent, `Authorization: Bearer` wins.
177
283
  - **OAuth 2.1**: optional authorization-code flow with PKCE, enabled only when operators set `ENABLE_OAUTH=true`; owner-key consent is separately gated by `ENABLE_OWNER_OAUTH=true`.
178
284
 
285
+ The `?api_key=<KEY>` fallback is legacy/self-host compatibility only. BlackVeil hosted production sets `REJECT_QUERY_API_KEY=true`; clients that cannot send headers should use OAuth or an `mcp-remote` header bridge.
286
+
179
287
  For full hosted setup examples, stdio usage, OAuth setup, and legacy fallback endpoints, see [**docs/client-setup.md**](docs/client-setup.md).
180
288
 
181
289
  ---
182
290
 
291
+ ## CLI
292
+
293
+ This repository's root package ships a `blackveil` bin (`src/cli.ts`, built to `dist/cli.js`): a client for the hosted endpoint, not a local scanner. It calls `https://dns-mcp.blackveilsecurity.com/mcp` and works without a key; set `BLACKVEIL_API_KEY` to use a keyed tier's quota (keys are never accepted on the command line). `BLACKVEIL_MCP_URL` overrides the endpoint (HTTPS required except loopback).
294
+
295
+ ```bash
296
+ blackveil scan example.com --format json
297
+ blackveil check spf example.com
298
+ blackveil batch --file domains.txt --fail-below 70
299
+ blackveil policy example.com --policy policy.json
300
+ blackveil drift save example.com --out baseline.json
301
+ blackveil drift compare example.com --baseline baseline.json
302
+ blackveil evidence verify baseline.json
303
+ ```
304
+
305
+ Commands: `scan`, `check`, `batch`, `policy`, `drift save|compare`, `evidence verify`. Output formats (`--format`): `human` (default), `json`, `ndjson`, `evidence`; `--out <file>` writes to a file, `--fail-below <0-100>` or `--policy <file>` turns a scan into a pass/fail gate. Exit codes: `0` pass, `1` verified policy or integrity failure, `2` usage/input, `3` auth/quota/transport/tool error, `4` ungraded/inconclusive. `blackveil --help` prints the full usage (source of truth: `src/cli/command.ts`).
306
+
307
+ The npm package `blackveil-dns` is frozen at 2.13.0 (published 2026-05-12), and that artifact carries only the `blackveil-dns-mcp` stdio bin, not `blackveil`, so `npm i -g blackveil-dns` does not install this CLI. Publishing is closed by policy ([#719](https://github.com/MadaBurns/bv-mcp/issues/719), closed as not planned). Build from source (`npm ci && npm run build`) for the CLI, or use [blackveil-dns-action](https://github.com/MadaBurns/blackveil-dns-action) in CI; it calls the hosted endpoint and needs no npm package.
308
+
309
+ ---
310
+
311
+ ## REST / HTTP
312
+
313
+ The hosted engine is also reachable without MCP framing through BlackVeil's public API (pointer only; the API's own docs are authoritative):
314
+
315
+ - **Keyless single checks**: `POST https://www.blackveilsecurity.com/api/v1/tools/lookup` — OpenAPI spec at [`https://www.blackveilsecurity.com/openapi.json`](https://www.blackveilsecurity.com/openapi.json).
316
+ - **Keyed, metered full scan**: `POST https://www.blackveilsecurity.com/api/scan/v1/scan` with a tenant API key, on plans that include API access (see [Pricing](#pricing)).
317
+
318
+ ---
319
+
320
+ ## Operator configuration
321
+
322
+ These settings apply to operators running their own deployment. They are optional — self-hosted (BUSL) deployments fall back to privacy-preserving defaults when they are unset.
323
+
324
+ ### Detailed analytics capture
325
+
326
+ The public `/mcp` path writes a per-event access log enriched with geolocation and network identity. The write path, PII depth, and retention are operator-controlled:
327
+
328
+ | Binding / var | Type | Purpose |
329
+ | ------------------------- | ----- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
330
+ | `MCP_ANALYTICS_QUEUE` | Queue | **Operator-deploy only.** Batches access-log writes off the request path. Absent on self-hosts → inline-insert fallback (no reverse-DNS lookup). |
331
+ | `ANALYTICS_PII_LEVEL` | var | `coarse` (default) \| `standard` \| `full`. Controls access-log PII depth: `coarse` = country/region/ASN + hashed/masked IP; `standard` adds encrypted IP + city; `full` adds lat/long + reverse-DNS (PTR). |
332
+ | `ANALYTICS_RETENTION_DAYS` | var | Access-log retention window in days (default `90`, clamped `1`–`365`). Rows older than the window are pruned by the scheduled handler. |
333
+ | PTR third-party disclosure | — | At `ANALYTICS_PII_LEVEL=full`, caller-IP PTR lookups resolve through the configured DoH chain, whose final fallback is Google Public DNS — an external disclosure of caller-IP-derived queries that operators should weigh before enabling `full`. Per-subject erasure: `POST /internal/analytics/erase?key_hash=…\|ip_hash=…` (strict internal bearer; self-audited). |
334
+
335
+ ### Internal analytics endpoints
336
+
337
+ These live under the internal auth gate (`/internal/*`) and are called by bv-web, not the public surface:
338
+
339
+ | Endpoint | Source | Notes |
340
+ | --------------------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------- |
341
+ | `GET /internal/analytics/usage?days=&key_hash=` | D1 | Precise per-customer usage report. |
342
+ | `GET /internal/analytics/geo?days=` | Analytics Engine | Geographic rollup (country/region/city/ASN) for dashboards. |
343
+ | `GET /internal/analytics/forensics?days=&ip_hash=&key_hash=` | D1 | **STRICT-gated, operator-only.** Returns decrypted client IP + PTR for abuse investigation; every call writes a self-audit row. |
344
+
345
+ ---
346
+
183
347
  ## Pricing
184
348
 
185
- | | **Free** | **Pro** | **Enterprise** |
186
- |---|---|---|---|
187
- | **Price** | $0 | $39/mo | [Contact us](https://blackveilsecurity.com) |
188
- | **Scans/day** | 5 | 500 | 10,000+ |
189
- | **Checks/day** | 25 | 5,000 | Unlimited |
190
- | **Rate limit** | 50 req/min | None | None |
191
- | **API access** | Yes | Yes | Yes |
192
- | **MCP access** | Yes | Yes | Yes |
349
+ | | **Free** | **Developer** | **Enterprise** |
350
+ | -------------- | ---------------------------------------- | ---------------------------------------------------------- | ------------------------------------------- |
351
+ | **Price** | $0 | $39/mo (provisioned by BlackVeil, not self-serve checkout) | [Contact us](https://blackveilsecurity.com) |
352
+ | **Scans/day** | 25 (anonymous, per IP); 50 with a free key | 500 per tool | 10,000+ per tool |
353
+ | **Checks/day** | Tool-specific limits | Tool-specific limits | Contract limits |
354
+ | **Rate limit** | 50 req/min | None | None |
355
+ | **API access** | No | Yes | Yes |
356
+ | **MCP access** | Yes | Yes | Yes |
357
+
358
+ Free-tier daily limits depend on whether you send a key. Anonymous (no key): 25 `scan_domain` scans/day per IP, across at most 12 distinct domains/day. Free key: 50/day per tool. Free keys do not carry the REST scan API (see [REST / HTTP](#rest--http)); "API access" above means that keyed API. Limits are read from `TIER_DAILY_LIMITS`, `FREE_TOOL_DAILY_LIMITS` and `FREE_DISTINCT_DOMAIN_DAILY_LIMIT` in `src/lib/config.ts`.
359
+
360
+ Offensive/recon and multi-domain tools (subdomain discovery, attack-path simulation, lookalike/shadow-domain detection, fast-flux detection, supply-chain mapping, real-time threat feed, bucket/OSINT investigations, `batch_scan`, `compare_domains`, brand audits) require a paid plan (Developer tier or higher); free, unauthenticated, and agent-tier callers get an HTTP 403 upgrade-required response. Unauthenticated callers are additionally capped at 12 distinct domains per day (best-effort, fail-open). The OSINT/bucket status and report pollers stay free; the brand-audit and brand-discovery pollers (`brand_audit_status`, `brand_audit_get_report`, `discover_brand_domains_status`, `discover_brand_domains_findings`) have no unauthenticated allowance and return HTTP 429 without a key.
193
361
 
194
362
  ---
195
363
 
@@ -197,13 +365,13 @@ For full hosted setup examples, stdio usage, OAuth setup, and legacy fallback en
197
365
 
198
366
  These demonstrate core functionality — paste any of them into Claude with the Blackveil DNS connector enabled:
199
367
 
200
- | Prompt | What it does |
201
- |--------|-------------|
202
- | `Scan blackveilsecurity.com and tell me what needs fixing` | Full security audit — score, grade, prioritized findings |
203
- | `Compare the email security of google.com and microsoft.com` | Side-by-side comparison of two domains' postures |
204
- | `Generate a DMARC record for example.com with reject policy` | Produces a ready-to-publish DNS record |
205
- | `What attack paths exist for example.com?` | Enumerates spoofing, takeover, and hijack vectors |
206
- | `Map example.com's compliance against NIST 800-177` | Maps findings to compliance framework controls |
368
+ | Prompt | What it does |
369
+ | ------------------------------------------------------------ | -------------------------------------------------------- |
370
+ | `Scan blackveilsecurity.com and tell me what needs fixing` | Full security audit — score, grade, prioritized findings |
371
+ | `Compare the email security of google.com and microsoft.com` | Side-by-side comparison of two domains' postures |
372
+ | `Generate a DMARC record for example.com with reject policy` | Produces a ready-to-publish DNS record |
373
+ | `What attack paths exist for example.com?` | Enumerates spoofing, takeover, and hijack vectors |
374
+ | `Map example.com's compliance against NIST 800-177` | Maps findings to compliance framework controls |
207
375
 
208
376
  ---
209
377
 
@@ -212,6 +380,7 @@ These demonstrate core functionality — paste any of them into Claude with the
212
380
  - **Bug reports & feature requests:** [GitHub Issues](https://github.com/MadaBurns/bv-mcp/issues)
213
381
  - **Security vulnerabilities:** [security@blackveilsecurity.com](mailto:security@blackveilsecurity.com) (see [SECURITY.md](SECURITY.md))
214
382
  - **General questions:** [GitHub Discussions](https://github.com/MadaBurns/bv-mcp/discussions)
383
+ - **Support the project:** [Ko-fi](https://ko-fi.com/madaburns) — the hosted scanner is free to use; tips help keep it that way
215
384
 
216
385
  ---
217
386
 
@@ -223,6 +392,12 @@ If you discover a vulnerability in a third-party domain, please follow [coordina
223
392
 
224
393
  ---
225
394
 
395
+ ## Self-hosting and license
396
+
397
+ The supported self-host path is the stdio bin (`blackveil-dns-mcp`) for non-commercial use. The Cloudflare Worker configuration in this repository references BlackVeil-private bindings and is not a third-party deploy target. Under the [LICENSE](LICENSE) Additional Use Grant, providing the Licensed Work as a hosted service to third parties for a fee, or embedding it in a commercial product, is commercial use and needs a separate licence from BLACKVEIL. Commercial licences are available on request via [https://blackveilsecurity.com/contact](https://blackveilsecurity.com/contact).
398
+
399
+ ---
400
+
226
401
  <div align="center">
227
402
 
228
403
  Built and maintained by [**BLACKVEIL**](https://blackveilsecurity.com) — NZ-owned cybersecurity consultancy.