Skip to content

SEP-1577 - Sampling With Tools #1796

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 34 commits into from
Nov 14, 2025
+757 −19
Merged

SEP-1577 - Sampling With Tools #1796

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
34 commits
Select commit Hold shift + click to select a range
aa453ec
SEP-1577: Add tool calling support to sampling
ochafik Nov 7, 2025
4245edb
Refine SEP-1577 implementation: fix ToolResultContent.content and add…
ochafik Nov 11, 2025
a219250
Rename 'Tool Calling' to 'Tool Use' for consistency
ochafik Nov 11, 2025
b34c230
Rename section to 'Tools in Sampling' for clarity
ochafik Nov 11, 2025
4f6351d
Minimize security section diff by preserving original items
ochafik Nov 11, 2025
2b0a473
Simplify security considerations for tool use
ochafik Nov 11, 2025
102512e
nit
ochafik Nov 11, 2025
e942edc
address some comments
ochafik Nov 12, 2025
4126bd0
Resolve merge conflicts: SEP-1577 (sampling with tools) + SEP-1330 (e…
ochafik Nov 12, 2025
3a9c719
Update docs/specification/draft/client/sampling.mdx
ochafik Nov 12, 2025
5096d90
Update schema.json
ochafik Nov 12, 2025
32690e1
add sequence diagram
ochafik Nov 13, 2025
8e197eb
drop complexity of SamplingMessage, now can loosely contain tool_use …
ochafik Nov 13, 2025
fc75656
Merge branch 'main' into ochafik/sep-1577-sampling-with-tools
ochafik Nov 13, 2025
faaa358
Update sampling.mdx
ochafik Nov 13, 2025
c8de5e5
alternance: rephrased to before any other message.
ochafik Nov 13, 2025
e5595ff
When using tool use in sampling, messages **MUST** be properly balanc…
ochafik Nov 13, 2025
8940554
Update docs/specification/draft/client/sampling.mdx
localden Nov 14, 2025
375c666
Update docs/specification/draft/client/sampling.mdx
localden Nov 14, 2025
b3e0ea4
Update docs/specification/draft/client/sampling.mdx
localden Nov 14, 2025
2cc0499
Update docs/specification/draft/client/sampling.mdx
localden Nov 14, 2025
e2d291c
Update docs/specification/draft/client/sampling.mdx
localden Nov 14, 2025
efd0554
Update docs/specification/draft/client/sampling.mdx
localden Nov 14, 2025
174fe09
Merge branch 'main' into ochafik/sep-1577-sampling-with-tools
localden Nov 14, 2025
54c7071
Update formatting in sampling spec documentation
localden Nov 14, 2025
4e63bef
Merge branch 'ochafik/sep-1577-sampling-with-tools' of https://github…
localden Nov 14, 2025
2d63d04
Update sampling.mdx
localden Nov 14, 2025
ac55d00
Update schema.ts
localden Nov 14, 2025
dc31a96
Format tool use examples with code style
localden Nov 14, 2025
684c91c
Update schema.mdx
localden Nov 14, 2025
bdad356
added sampling error handling examples
ochafik Nov 14, 2025
fa33396
updated to SHOULD NOT send context w/o capability for consistency
ochafik Nov 14, 2025
958fadf
Merge branch 'main' into ochafik/sep-1577-sampling-with-tools
localden Nov 14, 2025
0fb876c
Update sampling.mdx
localden Nov 14, 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
7 changes: 4 additions & 3 deletions docs/specification/draft/changelog.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,9 +13,10 @@ the previous revision, [2025-06-18](/specification/2025-06-18).
2. Allow servers to expose icons as additional metadata for tools, resources, resource templates, and prompts ([SEP-973](https://github.com/modelcontextprotocol/modelcontextprotocol/issues/973)).
3. Enhance authorization flows with incremental scope consent via `WWW-Authenticate` ([SEP-835](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/835))
4. Provide guidance on tool names ([SEP-986](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/1603))
5. Add support for OAuth Client ID Metadata Documents as a recommended client registration mechanism ([SEP-991](https://github.com/modelcontextprotocol/modelcontextprotocol/issues/991), PR [#1296](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/1296))
6. Update `ElicitResult` and `EnumSchema` to use a more standards-based approach and support titled, untitled, single-select, and multi-select enums ([SEP-1330](https://github.com/modelcontextprotocol/modelcontextprotocol/issues/1330)).
7. Added support for [URL mode elicitation](/specification/draft/client/elicitation#url-elicitation-requests)([SEP-1036](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/887))
5. Update `ElicitResult` and `EnumSchema` to use a more standards-based approach and support titled, untitled, single-select, and multi-select enums ([SEP-1330](https://github.com/modelcontextprotocol/modelcontextprotocol/issues/1330)).
6. Added support for [URL mode elicitation](/specification/draft/client/elicitation#url-elicitation-requests)([SEP-1036](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/887))
7. Add tool calling support to sampling via `tools` and `toolChoice` parameters ([SEP-1577](https://github.com/modelcontextprotocol/modelcontextprotocol/issues/1577))
8. Add support for OAuth Client ID Metadata Documents as a recommended client registration mechanism ([SEP-991](https://github.com/modelcontextprotocol/modelcontextprotocol/issues/991), PR [#1296](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/1296))

## Minor changes

Expand Down
Loading
Loading