Introduces the initial draft of the Model Context Protocol (MCP) specification for 2025-11-25, including architecture, basic protocol overview, authorization, lifecycle, security best practices, transports, utilities, client and server features, changelog, and schema files. This update provides comprehensive documentation and schema definitions for the new protocol version.

Changed the JSON schema version from draft/2020-12 to draft-07 and replaced all instances of "$defs" with "definitions". Updated all internal $ref pointers accordingly and fixed documentation links to reference the correct specification version. This improves compatibility and aligns with draft-07 conventions.

Fixed internal documentation links in CompleteRequestParams, ElicitRequestFormParams, and ElicitRequestURLParams to reference /specification/2025-11-25/basic/index instead of the draft path. This ensures links point to the correct versioned specification for improved navigation and accuracy.

Changed internal documentation links to reference the correct 2025-11-25 specification paths. The schema.mdx file was significantly condensed, removing detailed type/interface documentation and leaving only category headers for JSON-RPC, Common Types, and Content.

Replaced references to '/specification/draft/' with '/specification/2025-11-25/' throughout documentation files to ensure all internal links point to the correct versioned specification. This improves navigation accuracy and maintains consistency as the documentation evolves.

Changed documentation links for the _meta field in multiple interfaces to reference the 2025-11-25 specification instead of the draft version. This ensures consistency and accuracy with the current schema version.

Added comprehensive interface and type alias documentation for JSON-RPC, common types, and content blocks. This update provides explicit definitions and descriptions for objects such as JSONRPCError, JSONRPCMessage, Annotations, Icon, ContentBlock, and more, improving clarity and usability for implementers.

Replaces outdated 'draft' and schema links with references to the 2025-11-25 version throughout the basic specification docs. Ensures all internal and external documentation URLs point to the correct versioned resources for consistency and accuracy.

Reformatted the Base Protocol Card component to use multiline props for improved readability and consistency with other Card components.

Improved table alignment in lifecycle.mdx, updated Card component formatting in server/index.mdx, and clarified annotation note formatting in server/tools.mdx for better readability and consistency.

Sync changes into spec

Sync changes to release PR

Improves clarity and consistency in the MCP protocol documentation. Updates include refined descriptions for authorization client information prompts, result and error response handling, stdio and HTTP transport session headers, and resource template discovery. Also enhances annotation notes in tool results for better readability.

Adjusted line breaks in the Note block to enhance clarity and maintain consistent formatting in the documentation.

Co-authored-by: Paul Carleton <paulcarletonjr@gmail.com>

Update all Protocol Revision info boxes from "draft" to "2025-11-25" to correctly reflect the specification version.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>