| FazBrowse GitHub Viewer | Trending | | Home |
| Tools: [Download Repo ZIP] [Original HTTPS Page] |
Sorry, something went wrong.
Re-type SEP-2127 (MCP Server Cards) from Standards Track to Extensions Track and slim the body to a charter (SEP-1865 shape), delegating the detailed wire format to the experimental-ext-server-card repository. - Type -> Extensions Track; add Extension Identifier and Server Card Working Group attribution to the frontmatter (SEP-2663 conventions). - Add a top-of-file <Note> pointing to the extension repo as spec home. - Move out the Server Card schema, server.json schema, field tables, .well-known endpoint mechanics, full Security Implications, and IETF Registration; keep Abstract, Motivation, Rationale, a high-level Specification pointer, and a Security posture summary. - Replace the empty Reference Implementation section with a pointer to the incubation work; note the SDK reference implementation remains a Final-gating item. - Record open items: IANA registration, media-type and .well-known path convergence, and the discovery-doc primitives contradiction. - Regenerate docs/seps/index.mdx and docs/seps/2127-mcp-server-cards.mdx. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Replace Nick Cooper (@nickcoai) with Sam Morrow (@SamMorrowDrums) in the author and Extension Maintainers lines. Regenerate the rendered SEP doc. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
|
Updated authorship in e99ebf6: removed Nick Cooper (@nickcoai) and added Sam Morrow (@SamMorrowDrums) to both the Author(s) frontmatter and the Extension Maintainers list. Author line is now:
Regenerated the rendered SEP doc accordingly. |
Sorry, something went wrong.
Soften the high-level pointers that delegate discovery to the extension repo so they read 'discovery mechanics / discovery path / Discovery' rather than presuming a '.well-known' mechanism, which is not yet settled. The deliberate design-choice references (the 'Why .well-known?' rationale, RFC 5785 discussion, and the IANA-registration / path-spelling open items) are intentionally left as-is. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
The high-level Specification bullet asserted that Server Cards omit primitive listings; that decision may still change. Replace the detail with a pointer to the extension repo's schema.ts for the precise field set, keeping the charter agnostic on the contested question. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Cross-referenced the open issues in experimental-ext-server-card so the charter does not assert things the WG is still deciding: - Reference Implementation: cite python-sdk#2696 (open, in review) as the in-progress SDK reference impl instead of claiming none exists (#16). - Stop presenting .well-known as locked: add a discovery-mechanism open item for the .well-known-vs-GET-on-URL question (#12) and make the IANA registration conditional on that outcome. - Align the path/media-type open items with the reference impl's slash-form vote (#11) and the application/mcp-server-card+json direction (#9). - Add an auth-shape open item flagging the limited initial shape and the additive SEP-2742 auth fast-follow / forward-compat requirement (#13, #17). - Note that whether to add primitive listings is itself open (#10). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
A published SEP is frozen and not updated over time, so process-y and temporal notes (open questions, in-progress status) do not belong in the body. Remove the "Open Items" section and rephrase Reference Implementation to a non-temporal description of the incubation repo and python-sdk#2696. These tracking notes now live in the PR description instead. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
There was a problem hiding this comment.
Thanks for doing the conversion work
Sorry, something went wrong.
| Back | FazBrowse Home | New Git URL |
Builds on #2127
Refactors SEP-2127 (MCP Server Cards) from Standards Track to Extensions Track, slimming the body to a charter (SEP-1865 shape) that delegates the detailed wire format to modelcontextprotocol/experimental-ext-server-card. Implements the "Proposed refactor" in experimental-ext-server-card#15.
What changed
Line anchors below pin SEP-2127 to its PR-head SHA aa59517 and the extension repo to its current head ffe58b0, so they don't rot.
Translation / deletion audit
For every block removed from the SEP, where it now lives, an inline excerpt of the surviving copy, a permalink, and a verdict. TL;DR: the two schemas and field tables are fully translated (and stricter) in the repo; endpoint mechanics + security live in docs/discovery.md; the discovery mechanism itself is being revised (proposal to drop .well-known, #12), which also obsoletes the old IANA .well-known registration; the one security gap (DoS) is now filed as an extension-repo issue, and the primitives contradiction is tracked in #10.
1. ### MCP Server Card Schema + Field Descriptions — fully translated
Deleted: SEP-2127 L80–158 (schema + example) and L159–175 (field descriptions: $schema, name, version, description, title, websiteUrl, repository, icons, remotes, _meta).
Counterpart: schema.ts → interface ServerCard, generated schema.json, and examples/ServerCard/valid/.
The repo carries all ten fields plus validation constraints (length/pattern) the SEP described only in prose, so this is a strict superset of the deleted content. Verdict: fully translated — deletion is safe.
2. ### server.json Schema + Field Descriptions — fully translated
Deleted: SEP-2127 L176–248 (the server.json superset adding packages) and its field descriptions L249–255.
Counterpart: schema.ts → interface Server extends ServerCard with the Package / PackageTransport types (L228+) and examples/Server/valid/with-package.json.
The "strict superset adds packages" relationship the SEP described is exactly modeled by Server extends ServerCard. Verdict: fully translated — deletion is safe.
3. ### Endpoints / .well-known URI mechanics — translated to docs/discovery.md; discovery mechanism being revised (ext-repo #12)
Deleted: SEP-2127 L257–305 — the .well-known path, multi-server sub-path, HTTPS/CORS/caching requirements. (Alternatives — DNS- and header-based discovery, L306–310 — were kept in the SEP under Rationale → "Other Considered Discovery Mechanisms", as design rationale rather than wire format.)
Counterpart: docs/discovery.md carries the CORS block (L177–185), caching (L189–195), and HTTPS transport security (L197–200):
How the discovery mechanism is being handled. Rather than carry a .well-known path into the charter, we are going to propose dropping .well-known discovery for the single-server case entirely — letting an AI/MCP Catalog point to a Server Card hosted at any URI (e.g. a reserved GET <streamable-http-url>/server-card) instead of treating the card as site-wide .well-known metadata. That proposal is tracked in experimental-ext-server-card#12, which is the thread that will settle the canonical retrieval mechanism. The charter therefore delegates the path/mechanism to docs/discovery.md and does not hard-code .well-known, so it stays correct as #12 lands.
Because the .well-known approach is on its way out, the old SEP's IANA .well-known URI-suffix registration (deleted SEP L389–399, the former "IETF Registration" section) is intentionally not carried into the charter — registering a .well-known suffix only makes sense if .well-known survives, which #12 proposes it won't. (Whether to register a content media type is a separate question, tracked in #9.)
Verdict: endpoint mechanics translated to docs/discovery.md; the discovery mechanism — and with it the need for .well-known and any IANA registration of it — is being revised under #12.
4. ## Security Implications — partially translated; one gap (now filed), one contradiction (#10)
Deleted: SEP-2127 L354–384 — Information Disclosure, Primitive Information, CORS, Denial of Service, MITM. A condensed posture summary of all five was kept inline in the charter (SEP-1865 keeps a short Security Implications section + pointer), so nothing was dropped without a charter-level trace.
Counterparts in docs/discovery.md → Security Considerations:
Two caveats:
Verdict: posture translated + summarized inline; the DoS gap is now filed as an extension-repo issue; the primitives contradiction is tracked in #10.
5. ## IETF Registration — folded into §3 (obsoleted by the .well-known removal)
The deleted "IETF Registration" section (SEP-2127 L389–399) only existed to register the .well-known URI suffix with IANA. Since #12 proposes dropping .well-known discovery (see §3), that registration is no longer needed and is intentionally not carried into the charter. (Media-type registration is a separate, still-open question — #9.)
Notes