add docs

Author: bhosmer-ant

docs/specification/draft/changelog.mdx

@@ -21,6 +21,7 @@ the previous revision, [2025-03-26](/specification/2025-03-26).
 5. Added support for **[elicitation](client/elicitation)**, enabling servers to request additional
    information from users during interactions.
    (PR [#382](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/382))
+6. Added support for **[linked resources](http://localhost:3001/specification/draft/server/tools#linked-resources)** in tool call results. (PR [#603](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/603))
 
 ## Other schema changes
 

docs/specification/draft/server/tools.mdx

@@ -233,21 +233,32 @@ Tool results may contain [**structured**](#structured-content) or **unstructured
 #### Linked Resources
 
 [Resources](/specification/draft/server/resources) **MAY** be linked, to provide additional context
-or data, behind a URI that can be subscribed to or fetched again by the client later:
+or data, behind a URI that can be subscribed to or fetched by the client:
 
+```json
+{
+  "type": "linked_resource",
+  "uri": "file:///project/src/main.rs",
+  "name": "main.rs",
+  "description": "Primary application entry point",
+  "mimeType": "text/x-rust"
+}
+```
+
+<Info>Linked resources returned by tools are not guaranteed to appear in the results of a `resources/list` request.</Info>
 
 #### Embedded Resources
 
 [Resources](/specification/draft/server/resources) **MAY** be embedded, to provide additional context
-or data, behind a URI that can be subscribed to or fetched again by the client later:
+or data, along with a URI that can be subscribed to or fetched again by the client later:
 
 ```json
 {
   "type": "resource",
   "resource": {
-    "uri": "resource://example",
-    "mimeType": "text/plain",
-    "text": "Resource content"
+    "uri": "file:///project/src/main.rs",
+    "mimeType": "text/x-rust",
+    "text": "fn main() {\n    println!(\"Hello world!\");\n}"
   }
 }
 ```

schema/draft/schema.ts

@@ -646,7 +646,7 @@ export interface PromptMessage {
  *
  */
 export interface LinkedResource extends Resource {
-  type: "linkedresource";
+  type: "linked_resource";
 }
 
 /**