Repository navigation
Weekly research scan [2026-10-09] - #179
Conversation
MCP Server Cards (SEP-2127, Final 6 Oct) as the standard Layer 5 discovery mechanism; WebMCP declarative API removed from spec (PR #338) and Meta Ray-Ban Display added to implementation status (PR #325); AX is the New AEO (arXiv:2609.34951) as caveated directional evidence for Layers 1 and 3. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 8642907f41
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
| Standard mechanism (SEP-2127): publish an MCP Server Card and list it in | ||
| /.well-known/ai-catalog.json. The <link> below is a non-standard in-page | ||
| hint for agents already reading the DOM. --> |
There was a problem hiding this comment.
Update all MCP discovery guidance together
A repo-wide search shows that this new disclaimer conflicts with the primary implementation guidance: docs/implementation-guide.md:537-552 still calls the same application/mcp+json link “standardized,” and examples/agentic-browser-web-mcp.md:12-14 and examples/mcp-discovery-and-safety.md:10-12 still claim agents can use it for discovery. DRIFT.md:12-31 also remains stale and says the README and whitepaper have not yet been corrected. Consequently, readers following the guide or examples will still implement the undefined mechanism rather than Server Cards; update those artifacts and the living drift record as part of this correction.
AGENTS.md reference: AGENTS.md:L253-L261
Useful? React with 👍 / 👎.
Automated weekly research scan. Draft for human review. Do not merge without checking the Verification section.
Window covered: 2026-09-27 → 2026-10-09. The previous scan PR (#175) is still open as a draft. This branch is cut from
mainand does not include #175's changes. Its edits were placed outside #175's hunks so the two can merge in either order (see "Merge order" below).Findings
<link rel="alternate" type="application/mcp+json">. No MCP specification defines that element or media type. On 6 Oct 2026, SEP-2127 "MCP Server Cards" reached Final (Extensions Track) and standardized discovery a different way: a Server Card (application/mcp-server-card+json), listed in an AI Catalog at/.well-known/ai-catalog.json. The SEP considered DNS-based and header-based discovery and rejected both. HTML<link>discovery is not mentioned.toolname/tooldescription/toolautosubmitattributes on<form>. The spec now covers only imperativeregisterTool(). The declarative work continues only in an explainer, where schema synthesis and response handling are still TBD.implementation-status.mdon 29 Sept 2026 with "WebMCP for Web Apps is coming soon". It is off by default.Proposed edits (all in this diff)
<link>is the framework's own convention, describes SEP-2127, and recommends a Server Card plus an AI Catalog entry as the standard mechanism. The in-page<link>is kept as an optional, non-standard hint.<link>example: points to SEP-2127 as the standard mechanism. The<link>line itself is unchanged.Items that most need a human look
<link rel="alternate" type="application/mcp+json">recommendation (framework claim). It now has an official competitor. I did not remove or rewrite it. I added text that labels it non-standard and points to Server Cards as the standard route. Whether to keep it at all, demote it further, or replace the README example with anai-catalog.jsonsnippet is a framework decision. The same<link>pattern likely appears on bimodal.design (see the website issue).Verification
docs/discovery.mdinexperimental-ext-server-card. The 6 Oct merge date comes from the repo's closed-PR listing (GitHub API), which showsmerged_at2026-10-06. Refutation pass: an earlier search summary claimed the path was/.well-known/mcp/server-cards.json. That is wrong. The SEP defines only/.well-known/ai-catalog.json(catalog) and reserves<streamable-http-url>/server-card(card). Only the primary-source values are used. I also checked whether discovery.md defines any HTML<link>mechanism. It does not.registerTool()API. Declarative WebMCP is still being explored in the Declarative API Explainer." The live spec (header "9 October 2026") has no Declarative section. The attribute names and TBD status were read fromdeclarative-api-explainer.md.implementation-status.mdatmain. The 29 Sept date and the #325 reference come from the file's commit history (GitHub API).2026-07-28); A2A (still v1.0.1, 28 May); WAI-ARIA (editorial and chore commits only since 27 Sept); WCAG 3.0 (still the 10 Sept WD, which is in Weekly research scan [2026-09-27] #175); schema.org (v30.1 on 15 Sept, no release notes); OpenAPI 3.2.1 (10 Sept, outside the window, and the framework cites 3.x generically). WebMCP #339 (UnknownError → specific DOMException types) and #335 (typos) are editorial and were not proposed.Cut during the skeptic pass
Merge order
This branch is independent of #175. Its edits sit outside #175's hunks: whitepaper §5.1 after BenchJack (#175 inserts after CUA-Universe), §9 after the WebMCP Discovery paragraph, new reference items 6–7, and README references after "MCP Roadmap". Either order should merge cleanly. Once both are in, consider folding reference item 7 into item 2 and adding AX as a numbered research reference (#29 after #175's 26–28).
Settled conventions preserved
data-agent-*stays supplementary. Untouched.<link>vs. Server Card question is flagged above for decision rather than logged as drift.Checks
npm test: 155 passed, 7 suites.npm run lint/format:checkwere not run, because they are outside this routine's allowed command list. Prose was hand-wrapped at 80 columns to match the files, but a Prettier pass may still want to re-wrap.README.mdanddocs/whitepaper.mdtouched. No changes topackage.json,package-lock.json, or.github/workflows.🤖 Generated with Claude Code