Skip to content

Align Server Card with server.json compatibility#2443

Merged
dsp-ant merged 1 commit intosep/mcp-server-cardsfrom
tadasant/server-card-edits
Mar 26, 2026
Merged

Align Server Card with server.json compatibility#2443
dsp-ant merged 1 commit intosep/mcp-server-cardsfrom
tadasant/server-card-edits

Conversation

@tadasant
Copy link
Copy Markdown
Member

@tadasant tadasant commented Mar 23, 2026

Building on #2127

  • description → required: Matches the existing server.json schema where description is in the required array. Avoids an unnecessary divergence.
  • capabilities → optional: Since server.json is being redefined in terms of the Server Card shape, making capabilities required would break all existing server.json files that don't have it. Optional keeps the superset relationship clean.
  • Remove MCP Resource endpoint: The mcp://server-card.json resource requires an established MCP connection, which defeats the purpose of pre-connection discovery. Removed in favor of focusing on .well-known for remote servers.
  • Remove Registry endpoint section: The registry already serves server.json — no need to spec a separate mechanism here.
  • Clarify local server path: Added note that local/stdio servers should use server.json + the MCP Registry rather than Server Cards.

- Make description required to match server.json schema
- Make capabilities optional to avoid breaking existing server.json files
- Remove MCP Resource endpoint (mcp://server-card.json) — discovery
  should happen pre-connection via .well-known, not post-connection
- Remove registry endpoint section — registry already serves server.json
- Clarify that local/stdio servers use server.json + Registry path

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copy link
Copy Markdown
Member

@dsp-ant dsp-ant left a comment

Choose a reason for hiding this comment

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

thank you

@dsp-ant dsp-ant merged commit 63c7f5a into sep/mcp-server-cards Mar 26, 2026
13 of 14 checks passed
@dsp-ant dsp-ant deleted the tadasant/server-card-edits branch March 26, 2026 13:34
Copy link
Copy Markdown
Contributor

@SamMorrowDrums SamMorrowDrums left a comment

Choose a reason for hiding this comment

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

A bit late but thanks for this @tadasant

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

Labels

enhancement New feature or request SEP

Projects

Status: No status

Development

Successfully merging this pull request may close these issues.

4 participants