Skip to content

docs: remove primitives from Server Card contents (fixes #10)#19

Merged
SamMorrowDrums merged 2 commits into
mainfrom
sammorrowdrums/fix-discovery-md-primitives
Jun 8, 2026
Merged

docs: remove primitives from Server Card contents (fixes #10)#19
SamMorrowDrums merged 2 commits into
mainfrom
sammorrowdrums/fix-discovery-md-primitives

Conversation

@SamMorrowDrums

Copy link
Copy Markdown
Collaborator

Fixes #10.

The "A Server Card includes:" list in docs/discovery.md listed:

  • Capabilities — Tools, resources, and prompts the server offers

This contradicts both:

  1. schema.ts (lines 12–26), which explicitly states Server Cards "do not enumerate primitives (tools, resources, prompts) — those remain subject to runtime listing via the protocol's standard list operations."
  2. SEP-2127's Security Considerations, which excludes primitive listings from Server Cards for security reasons.

As agreed by @SamMorrowDrums and @tadasant in the issue discussion, this PR removes the contradictory bullet. The intro paragraph above the list also referred to Server Cards describing a server's "identity, capabilities, and connection details" — that has been updated to "identity and connection details", and a short clarifying sentence has been added stating that Server Cards do not enumerate primitives, mirroring the language in schema.ts.

No changes to mediaType strings — that's #9, handled separately.

The 'A Server Card includes:' list in docs/discovery.md mentioned
'Capabilities — Tools, resources, and prompts the server offers',
which contradicts schema.ts and SEP-2127: Server Cards do not
enumerate primitives. Primitives remain subject to runtime listing
via the protocol's standard list operations.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@SamMorrowDrums SamMorrowDrums requested a review from tadasant June 5, 2026 21:20
tadasant
tadasant previously approved these changes Jun 7, 2026
dsp-ant
dsp-ant previously approved these changes Jun 8, 2026
…fix-discovery-md-primitives

# Conflicts:
#	docs/discovery.md
@SamMorrowDrums SamMorrowDrums dismissed stale reviews from dsp-ant and tadasant via ee1f187 June 8, 2026 11:02
@SamMorrowDrums SamMorrowDrums merged commit ad000df into main Jun 8, 2026
3 checks passed
@SamMorrowDrums SamMorrowDrums deleted the sammorrowdrums/fix-discovery-md-primitives branch June 8, 2026 11:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs/discovery.md lists tools/resources/prompts as Server Card contents, contradicting SEP-2127's exclusion of primitives

3 participants