Skip to content

Update guidance for use of Embedded Resources in CallToolResult #415

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
bhosmer-ant merged 8 commits into from
Jun 10, 2025
+9 −4
Merged

Update guidance for use of Embedded Resources in CallToolResult #415

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
8 commits
Select commit Hold shift + click to select a range
6e3211a
update wording for use of embedded resources within tools
evalstate Apr 25, 2025
724184b
make Resources links relative
evalstate Apr 25, 2025
029bb2b
Merge remote-tracking branch 'upstream/main' into fix/tool-resource-g…
evalstate Apr 28, 2025
968f09f
Added extra note on Custom URI schemes in resources section (as URI l…
evalstate Apr 28, 2025
a63672f
Update docs/specification/draft/server/resources.mdx
evalstate May 8, 2025
14d8913
revert language in existing spec, update guidance to MUST for RFC3986…
evalstate Jun 10, 2025
5d258bc
Merge branch 'main' into fix/tool-resource-guidance
evalstate Jun 10, 2025
2d4d723
update to fix the recent merge of lastmodified in resource.
evalstate Jun 10, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions docs/specification/draft/server/resources.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -326,6 +326,11 @@ otherwise have a standard MIME type.

Git version control integration.

### Custom URI Schemes

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

## Error Handling

Servers **SHOULD** return standard JSON-RPC errors for common failure cases:
Expand Down
4 changes: 2 additions & 2 deletions docs/specification/draft/server/tools.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -252,8 +252,8 @@ or data. In this case, the tool will return a URI that can be subscribed to or f

#### Embedded Resources

A tool **MAY** return embedded [Resource contents](/specification/draft/server/resources), to provide additional context
or data, along with a URI that can be subscribed to or fetched again by the client later:
[Resources](resources) **MAY** be embedded to provide additional context
or data using a suitable [URI scheme](./resources#common-uri-schemes). Servers that use embedded resources **SHOULD** implement the `resources` capability:

```json
{
Expand Down
4 changes: 2 additions & 2 deletions schema/draft/schema.json
View file
Open in desktop

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.