Skip to content

Commit 14d8913

Browse files
committed
revert language in existing spec, update guidance to MUST for RFC3986 compliance
1 parent a63672f commit 14d8913

File tree

3 files changed

+12
-11
lines changed

3 files changed

+12
-11
lines changed

docs/specification/2025-03-26/server/resources.mdx

Lines changed: 1 addition & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ For example, applications could:
2121
- Allow the user to search through and filter available resources
2222
- Implement automatic context inclusion, based on heuristics or the AI model's selection
2323

24-
![Example of resource context picker](resource-picker.png)
24+
![Example of resource context picker](/specification/2025-03-26/server/resource-picker.png)
2525

2626
However, implementations are free to expose resources through any interface pattern that
2727
suits their needs—the protocol itself does not mandate any specific user
@@ -324,11 +324,6 @@ otherwise have a standard MIME type.
324324

325325
Git version control integration.
326326

327-
### Custom URI Schemes
328-
329-
Custom URI schemes SHOULD be in accordance with [RFC3986](https://datatracker.ietf.org/doc/html/rfc3986),
330-
taking the above guidance in to account.
331-
332327
## Error Handling
333328

334329
Servers **SHOULD** return standard JSON-RPC errors for common failure cases:

docs/specification/2025-03-26/server/tools.mdx

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -20,6 +20,7 @@ suits their needs—the protocol itself does not mandate any specific user
2020
interaction model.
2121

2222
<Warning>
23+
2324
For trust & safety and security, there **SHOULD** always
2425
be a human in the loop with the ability to deny tool invocations.
2526

@@ -29,6 +30,7 @@ Applications **SHOULD**:
2930
- Insert clear visual indicators when tools are invoked
3031
- Present confirmation prompts to the user for operations, to ensure a human is in the
3132
loop
33+
3234
</Warning>
3335

3436
## Capabilities
@@ -183,8 +185,12 @@ A tool definition includes:
183185
- `inputSchema`: JSON Schema defining expected parameters
184186
- `annotations`: optional properties describing tool behavior
185187

186-
<Warning>For trust & safety and security, clients **MUST** consider
187-
tool annotations to be untrusted unless they come from trusted servers.</Warning>
188+
<Warning>
189+
190+
For trust & safety and security, clients **MUST** consider
191+
tool annotations to be untrusted unless they come from trusted servers.
192+
193+
</Warning>
188194

189195
### Tool Result
190196

@@ -221,8 +227,8 @@ Tool results can contain multiple content items of different types:
221227

222228
#### Embedded Resources
223229

224-
[Resources](resources) **MAY** be embedded to provide additional context
225-
or data using a suitable [URI scheme](./resources#common-uri-schemes). Servers that use embedded resources **SHOULD** implement the `resources` capability:
230+
[Resources](/specification/2025-03-26/server/resources) **MAY** be embedded, to provide additional context
231+
or data, behind a URI that can be subscribed to or fetched again by the client later:
226232

227233
```json
228234
{

docs/specification/draft/server/resources.mdx

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -326,7 +326,7 @@ Git version control integration.
326326

327327
### Custom URI Schemes
328328

329-
Custom URI schemes **SHOULD** be in accordance with [RFC3986](https://datatracker.ietf.org/doc/html/rfc3986),
329+
Custom URI schemes **MUST** be in accordance with [RFC3986](https://datatracker.ietf.org/doc/html/rfc3986),
330330
taking the above guidance in to account.
331331

332332
## Error Handling

0 commit comments

Comments
 (0)