mcp/experimental: add ServerCard convenience helper (SEP-2127)#1024
Draft
SamMorrowDrums wants to merge 5 commits into
Draft
mcp/experimental: add ServerCard convenience helper (SEP-2127)#1024SamMorrowDrums wants to merge 5 commits into
SamMorrowDrums wants to merge 5 commits into
Conversation
This was referenced Jun 25, 2026
Open
piyushbag
approved these changes
Jun 28, 2026
piyushbag
left a comment
piyushbag
left a comment
Contributor
There was a problem hiding this comment.
Nice to see SEP-2127 isolated under mcp/experimental/servercard rather than touching core mcp.
Local check on this branch:
go test ./mcp/experimental/servercard/... -count=1
All pass. Validation coverage for version ranges, ETag/If-None-Match, and discovery headers looks solid.
Please rebase onto current main before merge (branch is behind). No other concerns from my side on the experimental API shape.
tadasant
reviewed
Jul 20, 2026
Adds experimental Server Card types and helpers for SEP-2127, including building a card from implementation metadata and serving it with discovery headers. Co-authored-by: Copilot <[email protected]>
Co-authored-by: Copilot <[email protected]>
SamMorrowDrums
force-pushed
the
experimental-server-card
branch
from
July 20, 2026 20:43
ef93f97 to
d4fcacc
Compare
Validate nested input formats, icon themes, URIs, Unicode lengths, and exact versions. Avoid caching handler error responses. Co-authored-by: Copilot App <[email protected]> Copilot-Session: 38f143e1-c0ff-47a9-ae4d-fd6ea9a5b7fd
Document building, serving, and publishing Server Cards with the Go SDK, including AI Catalog context, security guidance, and checked examples. Co-authored-by: Copilot App <[email protected]> Copilot-Session: 38f143e1-c0ff-47a9-ae4d-fd6ea9a5b7fd
…er-guidance docs(servercard): add developer guidance and validation fixes
olgasafonova
added a commit
to olgasafonova/mcp-servercard-go
that referenced
this pull request
Jul 24, 2026
The bead assumed SEP-2127 had stalled. PR #2127 is still open and
CHANGES_REQUESTED, which reads as stalled, but the work moved elsewhere:
- PR #2893 merged 26-06-2026, refactoring SEP-2127 from Standards Track
to an Extensions Track charter that delegates the wire format to
experimental-ext-server-card
- .well-known was dropped as the card location; it is now
GET <streamable-http-url>/server-card
- modelcontextprotocol/go-sdk#1024 adds an official
mcp/experimental/servercard package, challenging this repo's
"reference implementation for Go" framing
So servercard.WellKnownPath, WellKnownPathFor() and the application/json
content type in handler.go are all divergences from normative text. The
card struct in card.go is still correct.
The one production adopter has already migrated: gateway.pipeworx.io
301s from the old path to /mcp/server-card (verified live).
54 claims tagged: 87% HIGH, 11% MEDIUM, 2% LOW.
Co-Authored-By: Claude Opus 4.8 <[email protected]>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Draft Go reference implementation for SEP-2127 MCP Server Cards.
This adds an experimental
mcp/experimental/servercardpackage that ports the server-side convenience helper from modelcontextprotocol/python-sdk#2951 for building a static Server Card frommcp.Implementationmetadata and serving it with the discovery CORS/cache headers.Tracking / coordination
guglielmoc/SEP-2133_extensions_frameworkThis is opened as a draft because it is a nontrivial experimental API and should be promoted after WG review / proposal soak.
Validation
go vet ./...go build ./...go test ./...Adds strong ETag generation plus If-None-Match conditional-request handling for Server Cards; see Discovery: recommend ETag + conditional requests (If-None-Match/304) as a SHOULD for card/catalog endpoints experimental-ext-server-card#33.