Merge remote-tracking branch 'upstream/main' into feature/resource-size

Author: evalstate

.gitignore

@@ -1 +1,2 @@
 node_modules/
+.DS_Store

docs/.DS_Store

@@ -16,6 +16,8 @@ This specification defines the authoritative protocol requirements, based on the
 
 For implementation guides and examples, visit [modelcontextprotocol.io](https://modelcontextprotocol.io).
 
+The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in [BCP 14](https://datatracker.ietf.org/doc/html/bcp14) [[RFC2119](https://datatracker.ietf.org/doc/html/rfc2119)] [[RFC8174](https://datatracker.ietf.org/doc/html/rfc8174)] when, and only when, they appear in all capitals, as shown here.
+
 ## Overview
 
 MCP provides a standardized way for applications to:

docs/_index.md

@@ -107,7 +107,7 @@ After successful initialization, the client **MUST** send an `initialized` notif
 ```json
 {
   "jsonrpc": "2.0",
-  "method": "initialized"
+  "method": "notifications/initialized"
 }
 ```
 

docs/specification/_index.md

@@ -67,7 +67,7 @@ To retrieve roots, servers send a `roots/list` request:
 
 ### Root List Changes
 
-When roots change, clients that support `listChanged` MUST send a notification:
+When roots change, clients that support `listChanged` **MUST** send a notification:
 
 ```json
 {
@@ -128,7 +128,7 @@ Example roots for different use cases:
 
 ## Error Handling
 
-Clients SHOULD return standard JSON-RPC errors for common failure cases:
+Clients **SHOULD** return standard JSON-RPC errors for common failure cases:
 
 - Client does not support roots: `-32601` (Method not found)
 - Internal errors: `-32603`

docs/specification/basic/lifecycle.md

@@ -187,7 +187,7 @@ Image content allows including visual information in messages:
   "mimeType": "image/png"
 }
 ```
-The image data MUST be base64-encoded and include a valid MIME type. This enables multi-modal interactions where visual context is important.
+The image data **MUST** be base64-encoded and include a valid MIME type. This enables multi-modal interactions where visual context is important.
 
 #### Embedded Resources
 Embedded resources allow referencing server-side resources directly in messages:
@@ -202,7 +202,7 @@ Embedded resources allow referencing server-side resources directly in messages:
 }
 ```
 
-Resources can contain either text or binary (blob) data and MUST include:
+Resources can contain either text or binary (blob) data and **MUST** include:
 - A valid resource URI
 - The appropriate MIME type
 - Either text content or base64-encoded blob data
@@ -211,7 +211,7 @@ Embedded resources enable prompts to seamlessly incorporate server-managed conte
 
 ## Error Handling
 
-Servers SHOULD return standard JSON-RPC errors for common failure cases:
+Servers **SHOULD** return standard JSON-RPC errors for common failure cases:
 
 - Invalid prompt name: `-32602` (Invalid params)
 - Missing required arguments: `-32602` (Invalid params)

docs/specification/client/roots.md

@@ -294,7 +294,7 @@ Git version control integration.
 
 ## Error Handling
 
-Servers SHOULD return standard JSON-RPC errors for common failure cases:
+Servers **SHOULD** return standard JSON-RPC errors for common failure cases:
 
 - Resource not found: `-32002`
 - Internal errors: `-32603`

docs/specification/server/prompts.md

@@ -199,6 +199,9 @@
                 {
                     "$ref": "#/definitions/ListResourcesRequest"
                 },
+                {
+                    "$ref": "#/definitions/ListResourceTemplatesRequest"
+                },
                 {
                     "$ref": "#/definitions/ReadResourceRequest"
                 },
@@ -1839,6 +1842,9 @@
                 {
                     "$ref": "#/definitions/ListResourcesResult"
                 },
+                {
+                    "$ref": "#/definitions/ListResourceTemplatesResult"
+                },
                 {
                     "$ref": "#/definitions/ReadResourceResult"
                 },
@@ -1988,6 +1994,12 @@
                             },
                             "type": "object"
                         },
+                        "required": {
+                            "items": {
+                                "type": "string"
+                            },
+                            "type": "array"
+                        },
                         "type": {
                             "const": "object",
                             "type": "string"

docs/specification/server/resources.md

@@ -702,6 +702,7 @@ export interface Tool {
   inputSchema: {
     type: "object";
     properties?: { [key: string]: object };
+    required?: string[];
   };
 }
 
@@ -1078,6 +1079,7 @@ export type ClientRequest =
   | GetPromptRequest
   | ListPromptsRequest
   | ListResourcesRequest
+  | ListResourceTemplatesRequest
   | ReadResourceRequest
   | SubscribeRequest
   | UnsubscribeRequest
@@ -1114,6 +1116,7 @@ export type ServerResult =
   | GetPromptResult
   | ListPromptsResult
   | ListResourcesResult
+  | ListResourceTemplatesResult
   | ReadResourceResult
   | CallToolResult
   | ListToolsResult;