Skip to content

Publish DNS-AID discovery records for rewrites.bio - #16

Draft
edmundmiller wants to merge 3 commits into
mainfrom
cursor/dns-aid-records-16d5
Draft

Publish DNS-AID discovery records for rewrites.bio#16
edmundmiller wants to merge 3 commits into
mainfrom
cursor/dns-aid-records-16d5

Conversation

@edmundmiller

Copy link
Copy Markdown
Contributor

Summary

Adds automation and operator documentation to publish DNS for AI Discovery (DNS-AID) records for rewrites.bio, fixing the failing checks.discoverability.dnsAid check on isitagentready.com.

The site already documents example records in netlify/dns-aid-records.example, but they are not live in DNS. Netlify DNS does not support SVCB/HTTPS record types, so publishing requires either migrating DNS to Cloudflare or delegating _agents.rewrites.bio to a provider that supports RFC 9460 records.

What changed

  • dns/records.json — canonical DNS-AID record definitions:
    • _index._agents (HTTPS) — discovery entrypoint
    • _mcp._agents (HTTPS) — WebMCP / MCP server card on homepage
    • _a2a._agents (SVCB) — agent content endpoint with experimental key65000 path param
  • scripts/publish-dns-aid.sh — publish (Cloudflare API), delegate (Netlify NS), enable DNSSEC, verify (DoH + isitagentready scan), and show zone-file output
  • dns/README.md — operator guide for Cloudflare migration vs _agents subdomain delegation
  • .github/workflows/publish-dns-aid.yml — manual workflow when CLOUDFLARE_API_TOKEN and CLOUDFLARE_ZONE_ID secrets are configured
  • Updated netlify/dns-aid-records.example and README.md

Operator action required (not in this PR)

DNS records cannot be committed to the Astro repo — they must be applied at the authoritative DNS provider:

  1. Recommended: Move rewrites.bio DNS to Cloudflare (or delegate _agents.rewrites.bio only — see dns/README.md).
  2. Run:
    export CLOUDFLARE_API_TOKEN=...
    export CLOUDFLARE_ZONE_ID=...
    ./scripts/publish-dns-aid.sh publish
    ./scripts/publish-dns-aid.sh dnssec
  3. Add DS records at the registrar/parent zone if needed.
  4. Verify: ./scripts/publish-dns-aid.sh verify → expect dnsAid: "pass" and dnssecValidated: true.

Test plan

  • ./scripts/publish-dns-aid.sh show renders expected zone-file records
  • ./scripts/publish-dns-aid.sh verify confirms current production state is fail (no records yet)
  • After DNS operator runs publish + dnssec, verify reports pass
Open in Web Open in Cursor 

Netlify DNS cannot create SVCB/HTTPS records required for DNS-AID agent
discovery. Add Cloudflare-oriented publish/verify scripts, machine-readable
record definitions (_index, _mcp, _a2a), a GitHub Actions workflow, and
operator docs covering full-zone migration or _agents subdomain delegation.

Co-authored-by: Edmund Miller <edmundmiller@users.noreply.github.com>
@netlify

netlify Bot commented Jun 16, 2026

Copy link
Copy Markdown

Deploy Preview for rewrites-bio ready!

Name Link
🔨 Latest commit 12bbbd3
🔍 Latest deploy log https://app.netlify.com/projects/rewrites-bio/deploys/6a319bbe7311150008a3e93d
😎 Deploy Preview https://deploy-preview-16--rewrites-bio.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

cursoragent and others added 2 commits June 16, 2026 18:53
…s-16d5

Co-authored-by: Edmund Miller <edmundmiller@users.noreply.github.com>
Co-authored-by: Edmund Miller <edmundmiller@users.noreply.github.com>

@ewels ewels left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Isn't this a one-off action to add the records, as shown in the example? Why do we need all this stuff?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants