Skip to content

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

Open
SamMorrowDrums wants to merge 1 commit into
mainfrom
sammorrowdrums/fix-discovery-md-primitives
Open

docs: remove primitives from Server Card contents (fixes #10)#19
SamMorrowDrums wants to merge 1 commit 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
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

1 participant