feat: make the site discoverable and callable by AI agents by jnton · Pull Request #37 · yourselftoscience/yourselftoscience.org

jnton · 2026-07-27T19:04:31Z

Summary

Makes Yourself to Science openly discoverable, readable, and callable by AI systems across the emerging agent ecosystem while preserving the existing browser experience.

Implemented

Explicitly allows all crawlers and declares ai-train=yes, search=yes, and ai-input=yes.
Adds agent-useful RFC 8288 Link response headers and equivalent HTML <head> discovery links.
Adds Accept: text/markdown negotiation for the homepage, catalogue sections, and individual resource pages using the existing generated Markdown files.
Publishes an RFC 9727 API catalog and public health endpoint.
Publishes MCP discovery in both Server Card and current registry-manifest forms, pointing to the real authless MCP endpoint.
Publishes a callable A2A 1.0 JSON-RPC agent and matching Agent Card.
Publishes an Agent Skills Discovery v0.2.0 index and digest-verified SKILL.md.
Registers read-only catalogue tools through the current WebMCP API and the earlier compatibility API used by existing scanners.
Publishes honest auth.md documentation explaining that the public interfaces require no registration, OAuth, API key, account, or scope.
Adds explicit MIME types, CORS, caching, content signals, and WebMCP permissions.
Updates generated llms.txt so future builds continue advertising MCP, A2A, OpenAPI, skills, and discovery endpoints.
Updates generated OpenAPI 3.1 metadata to include the public health and A2A endpoints.
Rebuilds the /ai page as a complete human-readable directory of all open machine and agent interfaces.
Shares catalogue filtering, ranking, facets, and canonical record formatting across A2A and WebMCP to avoid divergent behavior.

Intentionally not fabricated

OAuth/OIDC metadata: the public APIs are authless and are not OAuth protected resources. Publishing an authorization server or protected-resource relationship would be false.
Web Bot Auth signing directory: this requires a real private signing key and signed outbound HTTP messages. A fake JWKS would reduce security rather than improve compatibility.
DNS-AID records: these must be added in the authoritative Cloudflare DNS zone, outside this repository. The code-side discovery endpoints are included here and ready to be referenced by DNS.

Primary new endpoints

/.well-known/api-catalog
/.well-known/mcp/server-card.json
/.well-known/mcp.json
/.well-known/agent-card.json
/.well-known/agent-skills/index.json
/auth.md
/api/a2a
/api/health

Validation

Branch is based directly on main and GitHub reports it mergeable.
SonarQube Cloud Quality Gate passes with zero security hotspots and 0.1% duplication on new code.
Agent Skill digest matches the raw SKILL.md bytes.
Cloudflare Pages preview deployment is used as the final Next.js production-build check.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

cloudflare-workers-and-pages · 2026-07-27T19:05:44Z

Deploying yourselftoscience-org with Cloudflare Pages

Latest commit:	`c32466d`
Status:	✅ Deploy successful!
Preview URL:	https://1bf626fd.yourselftoscience-org.pages.dev
Branch Preview URL:	https://feat-agent-readiness.yourselftoscience-org.pages.dev

View logs

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

…ment

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

sonarqubecloud · 2026-07-27T19:19:13Z

Quality Gate passed

Issues
4 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.1% Duplication on New Code

See analysis details on SonarQube Cloud

jnton added 17 commits July 27, 2026 20:54

feat(ai): explicitly allow all bots and content uses

d993258

feat(ai): advertise machine-readable agent entry points

287200a

feat(ai): negotiate generated Markdown for agent requests

40f3753

feat(ai): add public machine-readable health endpoint

240dedc

feat(ai): publish RFC 9727 API catalog

fa923cd

feat(ai): publish MCP Server Card with real tools

19f870f

feat(ai): publish current MCP discovery manifest

4e612c6

feat(ai): publish A2A Agent Card

1f36589

feat(ai): add public A2A JSON-RPC catalogue agent

9e1a613

feat(ai): publish catalogue Agent Skill

151e7f8

feat(ai): publish Agent Skills discovery index

8a1d1fe

feat(ai): document authless agent access in auth.md

1898b06

feat(ai): expose catalogue tools through current and legacy WebMCP

9a40a83

feat(ai): register WebMCP tools on every public page

c34b876

feat(ai): set discovery MIME types, CORS, and cache headers

8c658ae

fix(ai): explicitly allow top-level WebMCP tools

e5415dc

feat(ai): advertise MCP, A2A, discovery, and skills in llms.txt

ed0ee01

Copilot AI review requested due to automatic review settings July 27, 2026 19:04

Copilot AI reviewed Jul 27, 2026

fix(ai): avoid overriding Next.js variation headers

47bfbc6

Copilot AI review requested due to automatic review settings July 27, 2026 19:05

Copilot AI reviewed Jul 27, 2026

refactor(ai): share catalogue search logic across agent interfaces

60e6263

Copilot AI review requested due to automatic review settings July 27, 2026 19:07

Copilot AI reviewed Jul 27, 2026

refactor(ai): reuse shared catalogue agent utilities in A2A

869c824

Copilot AI review requested due to automatic review settings July 27, 2026 19:08

Copilot AI reviewed Jul 27, 2026

refactor(ai): reuse shared catalogue utilities in WebMCP

a272700

Copilot AI review requested due to automatic review settings July 27, 2026 19:08

Copilot AI reviewed Jul 27, 2026

feat(ai): include health and A2A in generated OpenAPI

f7eccbc

Copilot AI review requested due to automatic review settings July 27, 2026 19:10

Copilot AI reviewed Jul 27, 2026

feat(ai): expose agent discovery links in HTML head

c2deed9

Copilot AI review requested due to automatic review settings July 27, 2026 19:13

Copilot AI reviewed Jul 27, 2026

feat(ai): document all open agent interfaces on the AI page

c32466d

Copilot AI review requested due to automatic review settings July 27, 2026 19:14

Copilot AI reviewed Jul 27, 2026

refactor(ai): simplify catalogue filter and ranking branches

d28ecec

Copilot AI review requested due to automatic review settings July 27, 2026 19:17

Copilot AI reviewed Jul 27, 2026

refactor(ai): make WebMCP registration failures observable in develop…

a01d95c

…ment

Copilot AI review requested due to automatic review settings July 27, 2026 19:18

Copilot AI reviewed Jul 27, 2026

refactor(ai): split A2A validation and response construction

644b633

Copilot AI review requested due to automatic review settings July 27, 2026 19:18

Copilot AI reviewed Jul 27, 2026

Uh oh!

Uh oh!

Conversation

jnton commented Jul 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Implemented

Intentionally not fabricated

Primary new endpoints

Validation

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

cloudflare-workers-and-pages Bot commented Jul 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Deploying yourselftoscience-org with Cloudflare Pages

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Uh oh!

sonarqubecloud Bot commented Jul 27, 2026

Quality Gate passed

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

jnton commented Jul 27, 2026 •

edited

Loading

cloudflare-workers-and-pages Bot commented Jul 27, 2026 •

edited

Loading