From 379a7718863dd1d03da2edfd1a06de16d7ffa721 Mon Sep 17 00:00:00 2001 From: "Sam (via Claude Code)" Date: Fri, 26 Jun 2026 22:26:03 +0000 Subject: [PATCH] docs(handshake): drop references to the MCP initialization handshake MCP is moving to stateless-by-default via SEP-2575, which removes the mandatory initialization handshake. Reword the Server Card docs and schema doc-comment so they no longer describe themselves in terms of the handshake / lifecycle initialization step. - README: a Server Card lets clients discover and connect to a server (drop "before initialization") - docs/discovery.md: discovery answers _where_ to connect before any protocol exchange (drop "complements the lifecycle handshake") - schema.ts: supportedProtocolVersions lets clients select a compatible protocol version "before connecting" (drop "before initialization"); schema.json regenerated from schema.ts Wording/schema-comment cleanup only; no schema fields change. Co-Authored-By: Claude Opus 4.8 --- README.md | 2 +- docs/discovery.md | 4 ++-- schema.json | 2 +- schema.ts | 2 +- 4 files changed, 5 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 86d41d8..235cff3 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ > #### **Status:** Experimental. This work is for prototyping and feedback only, and is not an accepted or official MCP extension. -This repository defines a TypeScript source-of-truth and generated JSON Schema for **MCP Server Cards**. Server Cards are a static metadata document that describes a remote MCP server enough for clients to discover and connect to it before initialization. +This repository defines a TypeScript source-of-truth and generated JSON Schema for **MCP Server Cards**. Server Cards are a static metadata document that describes a remote MCP server enough for clients to discover and connect to it. It tracks [SEP-2127](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2127) and is intended to be lifted directly into the main spec when Server Cards graduate (see [Graduation plan](#graduation-plan) below). diff --git a/docs/discovery.md b/docs/discovery.md index 8838b39..8d9a772 100644 --- a/docs/discovery.md +++ b/docs/discovery.md @@ -3,8 +3,8 @@ **Protocol Revision**: draft MCP defines a discovery mechanism that enables clients to find available MCP servers on a -domain without prior configuration. This mechanism complements the lifecycle handshake by -answering _where_ to connect, before the protocol establishes _how_ to communicate. +domain without prior configuration. This mechanism answers _where_ to connect, before any +protocol exchange establishes _how_ to communicate. ## MCP Catalog diff --git a/schema.json b/schema.json index 4223b55..a93de94 100644 --- a/schema.json +++ b/schema.json @@ -141,7 +141,7 @@ "type": "array" }, "supportedProtocolVersions": { - "description": "MCP protocol versions actively supported by this remote endpoint. Allows\nclients to negotiate a compatible protocol version before initialization.", + "description": "MCP protocol versions actively supported by this remote endpoint. Allows\nclients to select a compatible protocol version before connecting.", "items": { "type": "string" }, diff --git a/schema.ts b/schema.ts index a786c72..20f168d 100644 --- a/schema.ts +++ b/schema.ts @@ -197,7 +197,7 @@ export interface Remote { /** * MCP protocol versions actively supported by this remote endpoint. Allows - * clients to negotiate a compatible protocol version before initialization. + * clients to select a compatible protocol version before connecting. */ supportedProtocolVersions?: string[]; }