SEP-1686: Tasks by maxisbey · Pull Request #1645 · modelcontextprotocol/python-sdk

@felixweinberger linked an issue

Nov 20, 2025

that may be closed by this pull request

@maxisbey maxisbey changed the title SEP-1686: Tasks MCP SEP-1686: Tasks

Nov 20, 2025

chrisguidry added a commit to PrefectHQ/fastmcp that referenced this pull request

Nov 20, 2025
Analyzed the official SEP-1686 specification against both the MCP SDK's draft implementation (PR #1645) and FastMCP's current shims. Made corrections to match the spec exactly.

**Key changes:**

1. **Removed `error` field** - Spec only defines `statusMessage` for error details. Changed all handlers to use `statusMessage` instead of separate `error` field.

2. **Removed non-spec status values** - Spec defines exactly 5 statuses: `working`, `input_required`, `completed`, `failed`, `cancelled`. Removed FastMCP's `"submitted"` and `"unknown"` extensions.

3. **Non-existent tasks raise errors** - Aligned with SDK behavior: `tasks/get` for non-existent/deleted tasks raises `ValueError` (JSON-RPC error) instead of returning synthetic `status="unknown"`.

4. **Test updates** - Fixed 12+ tests expecting removed statuses. Changed assertions to expect JSON-RPC errors for not-found scenarios.

**What stayed the same:**

- Client already sends both `task=` (spec-compliant) and `_meta=` (SDK compatibility)
- Server monkeypatches work correctly for request params
- `createdAt` as ISO 8601 string matches spec (SDK uses datetime but serializes same)
- `ttl` field naming confirmed correct in both spec and SDK

All 3270 tests passing. FastMCP is now fully aligned with SEP-1686 final specification.

Related: modelcontextprotocol/python-sdk#1645

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

@maxisbey maxisbey marked this pull request as ready for review

November 25, 2025 10:44

felixweinberger

felixweinberger

@maxisbey

@maxisbey

@maxisbey

@maxisbey

@maxisbey

@maxisbey

@maxisbey

@maxisbey

- Move task handler protocols to experimental/task_handlers.py
- Add build_client_tasks_capability() helper to auto-build ClientTasksCapability from handlers
- ClientSession now automatically infers tasks capability from provided handlers
- Add Resolver class for async result handling in task message queues
- Refactor result_handler to use Resolver pattern
- Add test for auto-built capabilities from handlers
- Replace 6 individual task handler parameters with single
  `experimental_task_handlers: ExperimentalTaskHandlers` (keyword-only)
- ExperimentalTaskHandlers dataclass groups all handlers and provides:
  - `build_capability()` - auto-builds ClientTasksCapability from handlers
  - `handles_request()` - checks if request is task-related
  - `handle_request()` - dispatches to appropriate handler
- Simplify ClientSession._received_request by delegating task requests
- Update tests to use new ExperimentalTaskHandlers API
This commit adds working examples for the Tasks SEP demonstrating
elicitation and sampling flows, along with supporting infrastructure
changes.

Examples:
- simple-task-interactive server: Exposes confirm_delete (elicitation)
  and write_haiku (sampling) tools that run as tasks
- simple-task-interactive-client: Connects to server, handles callbacks,
  and demonstrates the correct task result retrieval pattern

Key changes:
- Move call_tool_as_task() from ClientSession to
  session.experimental.call_tool_as_task() for API consistency
- Add comprehensive tests mirroring the example patterns
- Add server-side print outputs for visibility into task execution

The critical insight: clients must call get_task_result() to receive
elicitation/sampling requests - simply polling get_task() will not
trigger the callbacks.
Update ToolExecution.taskSupport values per the latest MCP tasks spec:
- "never" → "forbidden"
- "always" → "required"
- "optional" unchanged

Add typed constants TASK_FORBIDDEN, TASK_OPTIONAL, TASK_REQUIRED for
consistent usage throughout the codebase instead of hardcoded strings.

Update all examples, tests, and documentation to use the new terminology.

@maxisbey

This addresses two critical spec compliance gaps:

1. Add `lastUpdatedAt` field to Task model
   - Required by spec: ISO 8601 timestamp updated on every status change
   - Added to Task model in types.py
   - Initialized alongside createdAt in create_task_state()
   - Updated in InMemoryTaskStore.update_task() on any change
   - Included in all Task responses and notifications

2. Add related-task metadata to tasks/result response
   - Per spec: tasks/result MUST include _meta with
     io.modelcontextprotocol/related-task containing the taskId
   - Required because result structure doesn't contain task ID
   - Merges with any existing _meta from stored result
Move all task-related capability checking logic into
mcp/shared/experimental/tasks/capabilities.py to keep tasks code
isolated from core session code.

Changes:
- Create capabilities.py with check_tasks_capability() and require_* helpers
- Update ServerSession to import and use the shared function
- Update ServerTaskContext to use require_* helpers instead of inline checks
- Add missing capability checks to ExperimentalServerSessionFeatures

This improves code organization and fixes a bug where
session.experimental.elicit_as_task() wasn't checking capabilities.
- Add test_capabilities.py with unit tests for all capability checking functions
- Add tests for elicit_as_task and create_message_as_task without handler
- Add scenario 4 sampling test (task-augmented tool call + task-augmented sampling)
- Replace sleep-based polling with event-based synchronization for faster, deterministic tests
- Simplify for/else patterns in test code
- Add additional check_tasks_capability edge case tests

Test coverage improved to 99.94% with 0 missing statements.
This refactoring ensures all sampling and elicitation code paths use
consistent validation and support the same features.

Sampling changes:
- Add shared validation module (mcp/server/validation.py) with
  validate_sampling_tools() and validate_tool_use_result_messages()
- Add tools and tool_choice parameters to all sampling methods:
  - _build_create_message_request()
  - ExperimentalServerSessionFeatures.create_message_as_task()
  - ServerTaskContext.create_message()
  - ServerTaskContext.create_message_as_task()
- Refactor ServerSession.create_message() to use shared validation

Elicitation changes:
- Rename _build_elicit_request to _build_elicit_form_request for clarity
- Add _build_elicit_url_request() for URL mode elicitation
- Add ServerTaskContext.elicit_url() so URL elicitation can be used
  from inside task-augmented tool calls (e.g., for OAuth flows)

This fixes a gap where task-augmented code paths were missing:
- tools/tool_choice parameters for sampling
- URL mode for elicitation
- Add tests for validation.py (check_sampling_tools_capability,
  validate_sampling_tools, validate_tool_use_result_messages)
- Add flow test for elicit_url() in ServerTaskContext
- Add pragma no cover comments to defensive _meta checks in builder
  methods (model_dump never includes _meta with current types)
- Fix test code to use assertions instead of conditional branches
- Add pragma no branch to polling loops in test scenarios
Extract tool-specific logic into separate handler functions, keeping
the call_tool decorator handler simple - it just dispatches based on
tool name and returns an error for unknown tools.
- Remove section header comments from test files
- Move all inline imports to top of files
- Replace hardcoded error codes (-32600) with INVALID_REQUEST constant
- Replace arbitrary sleeps with polling loops for deterministic tests
- Add pragma no branch to polling conditions that always succeed on first try
…vents

- Remove redundant '# Should not raise' comments in test_capabilities.py
- Remove redundant '# No handler' comments in test_server_task_context.py
- Replace arbitrary sleeps with deterministic event-based synchronization
  in test_task_result_handler.py (poll for wait events before proceeding)

@felixweinberger

Completely rewrote the experimental tasks documentation to cover the new
simplified API and advanced features:

tasks.md (Overview):
- Clear task lifecycle diagram
- Bidirectional flow explanation (client↔server)
- Key concepts (metadata, store, capabilities)
- Quick example with new enable_tasks() + run_task() API

tasks-server.md (Server Guide):
- Quick start with enable_tasks() + run_task()
- Tool declaration (TASK_REQUIRED/OPTIONAL/FORBIDDEN)
- Status updates and progress
- Elicitation within tasks (form and URL modes)
- Sampling within tasks
- Cancellation support
- Custom task stores
- HTTP transport example
- Testing patterns
- Best practices

tasks-client.md (Client Guide):
- Quick start with poll_task() iterator
- Handling input_required status
- Elicitation and sampling callbacks
- Client as task receiver (advanced)
- Client-side task handlers
- Error handling patterns
- Complete working examples
- Update TaskSession references to ServerTaskContext
- Update task_execution() to run_task()
- Fix result.taskSupport.taskId to result.task.taskId
Replace NotImplementedError with pass since task requests are handled
earlier by _task_handlers. The catch-all satisfies pyright's exhaustiveness
check while making it clear these cases are intentionally handled elsewhere.

@maxisbey

felixweinberger

@maxisbey

- Remove taskId from CancelledNotificationParams (removed in spec PR #1833)
- Update requestId docstring with MUST/MUST NOT requirements from spec
- Add missing docstrings for TaskMetadata, RelatedTaskMetadata.taskId,
  and Task.pollInterval to match schema.ts

felixweinberger

@maxisbey

- Remove set_task_result_handler wrapper method and its test
- Remove internal comment block for request builders
- Mark add_response_router as experimental in docstring
- Add experimental tasks documentation link to README
- Add comment explaining why experimental field uses Any type
  (circular import: mcp.server.__init__ -> fastmcp -> context)

@maxisbey

Rename variables in the two demo sections to be more descriptive and
avoid reusing the same names, making the example easier to follow.

felixweinberger

@maxisbey maxisbey deleted the maxisbey/SEP-1686_Tasks branch

November 28, 2025 18:51

rbehal added a commit to gumloop/gumloop-mcp that referenced this pull request

Dec 10, 2025
* Add regression test for stateless request memory cleanup (modelcontextprotocol#1140)

* Implement RFC9728 - Support WWW-Authenticate header by MCP client (modelcontextprotocol#1071)

* Add streamable HTTP starlette example to Python SDK docs (modelcontextprotocol#1111)

* fix markdown error in README in main (modelcontextprotocol#1147)

* README - replace code snippets with examples - add lowlevel to snippets (modelcontextprotocol#1150)

* README - replace code snippets with examples - streamable http (modelcontextprotocol#1155)

* chore: don't allow users to create issues outside the templates (modelcontextprotocol#1163)

* Tests(cli): Add coverage for helper functions (modelcontextprotocol#635)

* Docs: Update CallToolResult parsing in README (modelcontextprotocol#812)

Co-authored-by: Felix Weinberger <fweinberger@anthropic.com>

* docs: add pre-commit install guide on CONTRIBUTING.md (modelcontextprotocol#995)

Co-authored-by: Felix Weinberger <fweinberger@anthropic.com>

* fix flaky fix-test_streamablehttp_client_resumption test (modelcontextprotocol#1166)

* README - replace code snippets with examples -- auth examples (modelcontextprotocol#1164)

* Support falling back to OIDC metadata for auth (modelcontextprotocol#1061)

* Add CODEOWNERS file for sdk (modelcontextprotocol#1169)

* fix flaky test test_88_random_error (modelcontextprotocol#1171)

* Make sure `RequestId` is not coerced as `int` (modelcontextprotocol#1178)

* Fix: Replace threading.Lock with anyio.Lock for Ray deployment compatibility (modelcontextprotocol#1151)

* fix: fix OAuth flow request object handling (modelcontextprotocol#1174)

* update codeowners group (modelcontextprotocol#1191)

* fix: perform auth server metadata discovery fallbacks on any 4xx (modelcontextprotocol#1193)

* server: skip duplicate response on CancelledError (modelcontextprotocol#1153)

Co-authored-by: ihrpr <inna@anthropic.com>

* Unpack settings in FastMCP (modelcontextprotocol#1198)

* chore: Remove unused prompt_manager.py file (modelcontextprotocol#1229)

Co-authored-by: Tapan Chugh <tapanc@cs.washington.edu>

* Improved supported for ProtectedResourceMetadata (modelcontextprotocol#1235)

Co-authored-by: Paul Carleton <paulcarletonjr@gmail.com>

* chore: Remove unused variable notification_options (modelcontextprotocol#1238)

* Improve README around the Context object (modelcontextprotocol#1203)

* fix: allow to pass `list[str]` to `token_endpoint_auth_signing_alg_values_supported` (modelcontextprotocol#1226)

* Remove strict validation on `response_modes_supported` member of `OAuthMetadata` (modelcontextprotocol#1243)

* Add pyright strict mode on the whole project (modelcontextprotocol#1254)

* Consistent casing for default headers Accept and Content-Type (modelcontextprotocol#1263)

* Update dependencies and fix type issues (modelcontextprotocol#1268)

Co-authored-by: Marcelo Trylesinski <marcelotryle@gmail.com>

* fix: prevent async generator cleanup errors in StreamableHTTP transport (modelcontextprotocol#1271)

Co-authored-by: David Soria Parra <167242713+dsp-ant@users.noreply.github.com>

* chore: uncomment .idea/ in .gitignore (modelcontextprotocol#1287)

Co-authored-by: Claude <noreply@anthropic.com>

* docs: clarify streamable_http_path configuration when mounting servers (modelcontextprotocol#1172)

* feat: Add CORS configuration for browser-based MCP clients (modelcontextprotocol#1059)

Co-authored-by: Marcelo Trylesinski <marcelotryle@gmail.com>
Co-authored-by: Felix Weinberger <fweinberger@anthropic.com>

* Added Audio to FastMCP (modelcontextprotocol#1130)

* fix: avoid uncessary retries in OAuth authenticated requests (modelcontextprotocol#1206)

Co-authored-by: Felix Weinberger <fweinberger@anthropic.com>

* Add PATHEXT to default STDIO env vars in windows (modelcontextprotocol#1256)

* fix: error too many values to unpack (expected 2) (modelcontextprotocol#1279)

Signed-off-by: San Nguyen <vinhsannguyen91@gmail.com>
Co-authored-by: Felix Weinberger <fweinberger@anthropic.com>
Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>

* SDK Parity: Avoid Parsing Server Response for non-JsonRPCMessage Requests (modelcontextprotocol#1290)

* types: Setting default value for method: Literal (modelcontextprotocol#1292)

* changes structured temperature to not deadly (modelcontextprotocol#1328)

* Update simple-resource example to use non-deprecated read_resource return type (modelcontextprotocol#1331)

Co-authored-by: Claude <noreply@anthropic.com>

* docs: Update README to include link to API docs for modelcontextprotocol#1329 (modelcontextprotocol#1330)

* Allow ping requests before initialization (modelcontextprotocol#1312)

* Python lint: Ruff rules for pylint and code complexity (modelcontextprotocol#525)

* Fix context injection for resources and prompts (modelcontextprotocol#1336)

* fix(fastmcp): propagate mimeType in resource template list (modelcontextprotocol#1186)

Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>

* fix: allow elicitations accepted without content (modelcontextprotocol#1285)

Co-authored-by: Olivier Schiavo <olivier.schiavo@wengo.com>

* Use --frozen in pre-commit config (modelcontextprotocol#1375)

* Return HTTP 403 for invalid Origin headers (modelcontextprotocol#1353)

* Add test for ProtectedResourceMetadataParsing (modelcontextprotocol#1236)

Co-authored-by: Paul Carleton <paulcarletonjr@gmail.com>
Co-authored-by: Marcelo Trylesinski <marcelotryle@gmail.com>
Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>

* Fastmcp logging progress example (modelcontextprotocol#1270)

Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>

* feat: add paginated list decorators for prompts, resources, and tools (modelcontextprotocol#1286)

Co-authored-by: Claude <noreply@anthropic.com>

* Remove "unconditionally" from conditional description (modelcontextprotocol#1289)

* Use streamable-http consistently in examples (modelcontextprotocol#1389)

* feat: Add SDK support for SEP-1034 default values in elicitation schemas (modelcontextprotocol#1337)

Co-authored-by: Tapan Chugh <tapanc@cs.washington.edu>
Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>

* Implementation of SEP 973 - Additional metadata + icons support (modelcontextprotocol#1357)

* Add error log for client stdio (modelcontextprotocol#924)

Co-authored-by: Your Name <youremail@yourdomain.com>
Co-authored-by: Marcelo Trylesinski <marcelotryle@gmail.com>
Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>

* Accept additional response_types values from OAuth servers (modelcontextprotocol#1323)

* Issue 1379 patch - Fix MCP server OAuth not working with Visual Studio Code and others with extra grant_types (modelcontextprotocol#1380)

* Add comprehensive Unicode tests for streamable HTTP transport (modelcontextprotocol#1381)

* Update Icon.sizes to use string array format (modelcontextprotocol#1411)

* Delete CODEOWNERS to eliminate notification overload (modelcontextprotocol#1413)

* fix: fix the system message in simple-chatbot example (modelcontextprotocol#1394)

* fix: improve misleading warning for progress callback exceptions (modelcontextprotocol#775)

* fix: catch and rethrow SSEError during SSE connection establishment (modelcontextprotocol#975)

Co-authored-by: zhangchuanhui <zhangchal@digitalchina.com>
Co-authored-by: Felix Weinberger <fweinberger@anthropic.com>

* Add icons support for ResourceTemplate (modelcontextprotocol#1412)

* Add documentation structure (modelcontextprotocol#1425)

* Add documentation about testing (modelcontextprotocol#1426)

* Improve OAuth protected resource metadata URL construction per RFC 9728 (modelcontextprotocol#1407)

* feat: add ability to remove tools (modelcontextprotocol#1322)

Co-authored-by: David Soria Parra <167242713+dsp-ant@users.noreply.github.com>
Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>
Co-authored-by: Max Isbey <224885523+maxisbey@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>

* Update README to link to Python SDK documentation (modelcontextprotocol#1430)

* fix: update CLAUDE.md to remove auto-addition of reviewers. (modelcontextprotocol#1431)

* [client] Implement MCP OAuth scope selection and step-up authorization (modelcontextprotocol#1324)

* Handles message type Exception in lowlevel/server.py _handle_message function. Mentioned as TODO on line 528. (modelcontextprotocol#786)

Co-authored-by: Felix Weinberger <fweinberger@anthropic.com>
Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>

* Fix workspace configuration error with structured_output_lowlevel.py  (modelcontextprotocol#1471)

Co-authored-by: lorenss-m <saeclmusic@gmail.com>

* fix: Remove unnecessary constructor from ResourceServerSettings (modelcontextprotocol#1424)

Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>

* feat: add resource annotations support to FastMCP (modelcontextprotocol#1468)

* fix: send params as empty object for list methods without cursor (modelcontextprotocol#1453)

* fix: Set the Server session initialization state immediately after respond… (modelcontextprotocol#1478)

Co-authored-by: Max Isbey <224885523+maxisbey@users.noreply.github.com>

* feat: add tool metadata in FastMCP.tool decorator (modelcontextprotocol#1463)

Co-authored-by: Max Isbey <224885523+maxisbey@users.noreply.github.com>

* Make client examples workspaces to reflect package code (modelcontextprotocol#1466)

* Expose RequestParams._meta in ClientSession.call_tool (modelcontextprotocol#1231)

Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>

* Allow CallToolResult to be returned directly to support _meta field for OpenAI Apps (modelcontextprotocol#1459)

Co-authored-by: Max Isbey <224885523+maxisbey@users.noreply.github.com>

* fix: uv CVE-2025-62518 astral-tokio-tar issue GHSA-j5gw-2vrg-8fgx (modelcontextprotocol#1505)

* fix: use proper dependency resolution in CI (modelcontextprotocol#1507)

* Upgrade GitHub Actions (modelcontextprotocol#1473)

* test: use errno.ENOENT for command not found assertion (modelcontextprotocol#1498)

* Replace deprecated dev-dependencies with dependency-groups (modelcontextprotocol#1488)

Co-authored-by: Felix Weinberger <fweinberger@anthropic.com>
Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>

* update uv to 0.9.5 (modelcontextprotocol#1510)

* Relax Accept header requirement for JSON-only responses (modelcontextprotocol#1500)

* fix: replace deprecated dev-dependencies in examples/clients (modelcontextprotocol#1518)

* fix: Update spec links to new modelcontextprotocol.io location (modelcontextprotocol#1491)

* fix: Replace fixed sleep with active server readiness check in SSE tests (modelcontextprotocol#1526)

* fix: Replace arbitrary sleeps with active server readiness checks in tests (modelcontextprotocol#1527)

Co-authored-by: Claude <noreply@anthropic.com>

* Fix flaky timeout test in test_88_random_error (modelcontextprotocol#1525)

* fix: Replace remaining manual server polling with wait_for_server helper (modelcontextprotocol#1529)

* Implement RFC 7523 JWT flows (modelcontextprotocol#1247)

Co-authored-by: Yann Jouanin <yann.jouanin@valueandco.com>

* Fix pyright error and replace wildcard import with explicit imports (modelcontextprotocol#1532)

* Fix auth client example URL handling for oauth provider (modelcontextprotocol#1549)

* docs: use article "an" before "MCP" instead of "a" (modelcontextprotocol#1558)

* Update Starlette to 0.49.1 in uv.lock (modelcontextprotocol#1559)

* Fix typo in `ClientSessionGroup` doc string (modelcontextprotocol#1572)

* Implement SEP-985: OAuth Protected Resource Metadata discovery fallback (modelcontextprotocol#1548)

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Paul Carleton <paulc@anthropic.com>

* Add --frozen flag to uv run commands in Claude config (modelcontextprotocol#1583)

* Add get_server_capabilities() to ClientSession (modelcontextprotocol#1588)

* Add everything-server for comprehensive MCP conformance testing (modelcontextprotocol#1587)

* Get baseline 100% clean coverage (modelcontextprotocol#1553)

* Add end-of-file-fixer pre-commit hook (modelcontextprotocol#1610)

* Add coverage baseline commit to git-blame-ignore (modelcontextprotocol#1613)

* Add SEP-1034 conformance test support to everything-server (modelcontextprotocol#1604)

Co-authored-by: Max Isbey <224885523+maxisbey@users.noreply.github.com>

* refactor: extract OAuth helper functions and simplify provider state (modelcontextprotocol#1586)

* Add client_id_metadata_document_supported to OAuthMetadata (modelcontextprotocol#1603)

* Fix OAuth discovery fallback and URL ordering (modelcontextprotocol#1624)

* Refactor `func_metadata()` implementation (modelcontextprotocol#1496)

* Fix CI highest resolution test to actually test highest versions (modelcontextprotocol#1609)

* feat: Pass through and expose additional parameters in `ClientSessionGroup.call_tool` and `.connect_to_server` (modelcontextprotocol#1576)

* fix get_client_metadata_scopes on 401 (modelcontextprotocol#1631)

Co-authored-by: Max Isbey <224885523+maxisbey@users.noreply.github.com>

* chore: Lazy import `jsonschema` library (modelcontextprotocol#1596)

Co-authored-by: Max Isbey <224885523+maxisbey@users.noreply.github.com>

* docs: Update examples to use stateless HTTP with JSON responses (modelcontextprotocol#1499)

* Add tests for JSON Schema 2020-12 field preservation (SEP-1613) (modelcontextprotocol#1649)

* Add client_secret_basic authentication support (modelcontextprotocol#1334)

Co-authored-by: Paul Carleton <paulc@anthropic.com>

* Implement SEP-1577 - Sampling With Tools (modelcontextprotocol#1594)

Co-authored-by: Felix Weinberger <fweinberger@anthropic.com>
Co-authored-by: Claude <noreply@anthropic.com>

* SEP-1330: Elicitation Enum Schema Improvements and Standards Compliance (modelcontextprotocol#1246)

Co-authored-by: Tapan Chugh <tapanc@cs.washington.edu>
Co-authored-by: Felix Weinberger <fweinberger@anthropic.com>
Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>

* [auth][conformance] add conformance auth client (modelcontextprotocol#1640)

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>

* Implement SEP-986: Tool name validation (modelcontextprotocol#1655)

* fix: url for spec (modelcontextprotocol#1659)

* feat: implement SEP-991 URL-based client ID (CIMD) support (modelcontextprotocol#1652)

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>

* Update doc string on custom_route (modelcontextprotocol#1660)

* Implement SEP-1036: URL mode elicitation for secure out-of-band interactions (modelcontextprotocol#1580)

Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>
Co-authored-by: Felix Weinberger <fweinberger@anthropic.com>

* Skip empty SSE data to avoid parsing errors (modelcontextprotocol#1670)

* SEP-1686: Tasks (modelcontextprotocol#1645)

* Add on_session_created callback option (modelcontextprotocol#1710)

* Add SSE polling support (SEP-1699) (modelcontextprotocol#1654)

* Support client_credentials flow with JWT and Basic auth (modelcontextprotocol#1663)

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>

* feat: backwards-compatible create_message overloads for SEP-1577 (modelcontextprotocol#1713)

* Merge commit from fork

* Auto-enable DNS rebinding protection for localhost servers

When a FastMCP server is created with host="127.0.0.1" or "localhost"
and no explicit transport_security is provided, automatically enable
DNS rebinding protection. Both 127.0.0.1 and localhost are allowed
as valid hosts/origins since clients may use either to connect.

* Add tests for auto DNS rebinding protection on localhost

Tests verify that:
- Protection auto-enables for host=127.0.0.1
- Protection auto-enables for host=localhost
- Both 127.0.0.1 and localhost are in allowed hosts/origins
- Protection does NOT auto-enable for other hosts (e.g., 0.0.0.0)
- Explicit transport_security settings are not overridden

* Add IPv6 localhost (::1) support for DNS rebinding protection

Extend auto-enable DNS rebinding protection to also cover IPv6
localhost. When host="::1", protection is now auto-enabled with
appropriate allowed hosts ([::1]:*) and origins (http://[::1]:*).

* Fix import ordering in test file

* chore: update LATEST_PROTOCOL_VERSION to 2025-11-25 (modelcontextprotocol#1715)

* fix: add lifespan context manager to StreamableHTTP mounting examples (modelcontextprotocol#1669)

Co-authored-by: TheMailmans <tyler@example.com>
Co-authored-by: Marcelo Trylesinski <marcelotryle@gmail.com>

* fix: handle ClosedResourceError in StreamableHTTP message router (modelcontextprotocol#1384)

Co-authored-by: Max Isbey <224885523+maxisbey@users.noreply.github.com>
Co-authored-by: Marcelo Trylesinski <marcelotryle@gmail.com>

* fix: skip priming events and close_sse_stream for old protocol versions (modelcontextprotocol#1719)

* refactor(auth): remove unused _register_client method (modelcontextprotocol#1748)

* [MCP-266] Add tests for Gumloop server extensions

* Fix uv workspace config for gumloop-mcp package name

* Sync with upstream MCP SDK and fix merge conflicts

* Fix tool cache timing and missing properties check in server.py

* Fix coverage and add proper type annotations for Gumloop extensions

* Version up

* Skip README code example tests (Gumloop README has no code snippets)

* Support gumloop and mcp outptuschema

* Add publish tools to dev dependencies and update README for uv

---------

Signed-off-by: San Nguyen <vinhsannguyen91@gmail.com>
Co-authored-by: Felix Weinberger <3823880+felixweinberger@users.noreply.github.com>
Co-authored-by: yurikunash <143175350+yurikunash@users.noreply.github.com>
Co-authored-by: Pamela Fox <pamela.fox@gmail.com>
Co-authored-by: Inna Harper <inna.hrpr@gmail.com>
Co-authored-by: Marcelo Trylesinski <marcelotryle@gmail.com>
Co-authored-by: Ian Davenport <49379192+davenpi@users.noreply.github.com>
Co-authored-by: Dagang Wei <functicons@gmail.com>
Co-authored-by: Felix Weinberger <fweinberger@anthropic.com>
Co-authored-by: Stanley Law <stanleylkal@gmail.com>
Co-authored-by: Luca Chang <131398524+LucaButBoring@users.noreply.github.com>
Co-authored-by: leweng <leweng@nvidia.com>
Co-authored-by: Clare Liguori <liguori@amazon.com>
Co-authored-by: lukacf <luka@peltarion.com>
Co-authored-by: ihrpr <inna@anthropic.com>
Co-authored-by: Tapan Chugh <chugh.tapan@gmail.com>
Co-authored-by: Tapan Chugh <tapanc@cs.washington.edu>
Co-authored-by: Yann Jouanin <4557670+yannj-fr@users.noreply.github.com>
Co-authored-by: Paul Carleton <paulcarletonjr@gmail.com>
Co-authored-by: Sreenath Somarajapuram <somarajapuram@gmail.com>
Co-authored-by: Omer Korner <omerkorner@gmail.com>
Co-authored-by: joesavage-silabs <159480754+joesavage-silabs@users.noreply.github.com>
Co-authored-by: Gregory L <gregory.linford@mistral.ai>
Co-authored-by: David Soria Parra <167242713+dsp-ant@users.noreply.github.com>
Co-authored-by: Moustapha Ebnou <155577789+mous222@users.noreply.github.com>
Co-authored-by: Max Isbey <224885523+maxisbey@users.noreply.github.com>
Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Jerome <jerome@anthropic.com>
Co-authored-by: xavier <84836280+dragonier23@users.noreply.github.com>
Co-authored-by: keurcien <keurcien.luu@gmail.com>
Co-authored-by: Tim Esler <tim.esler@gmail.com>
Co-authored-by: San Nguyen <22189661+sandangel@users.noreply.github.com>
Co-authored-by: Justin Wang <89049861+justin-yi-wang@users.noreply.github.com>
Co-authored-by: jess <jessachandler@gmail.com>
Co-authored-by: Peter Alexander <pja@anthropic.com>
Co-authored-by: Reid Geyer <12072650+reidg44@users.noreply.github.com>
Co-authored-by: Eleftheria Stein-Kousathana <eleftheria.kousathana@gmail.com>
Co-authored-by: Christian Clauss <cclauss@me.com>
Co-authored-by: pchoudhury22 <pchoudhury22@apple.com>
Co-authored-by: owengo <owengo@users.noreply.github.com>
Co-authored-by: Olivier Schiavo <olivier.schiavo@wengo.com>
Co-authored-by: Steve Billings <billings.steve@gmail.com>
Co-authored-by: Mike Salvatore <mike.s.salvatore@gmail.com>
Co-authored-by: pengwa <pengwa@microsoft.com>
Co-authored-by: Your Name <youremail@yourdomain.com>
Co-authored-by: Jon Shea <jonshea@jonshea.com>
Co-authored-by: automaton82 <terrence.sheflin@gmail.com>
Co-authored-by: Yukuan Jia <jiayukuan@huawei.com>
Co-authored-by: Lorenzo <lorenzo_cesconeto@hotmail.com>
Co-authored-by: ZhangChuanhui <57099533+zhangch-ss@users.noreply.github.com>
Co-authored-by: zhangchuanhui <zhangchal@digitalchina.com>
Co-authored-by: Marcus Shu <46469249+shulkx@users.noreply.github.com>
Co-authored-by: Brandon Wu <49291449+brandonspark@users.noreply.github.com>
Co-authored-by: Dogacan Colak <dogacancolak@gmail.com>
Co-authored-by: AishwaryaKalloli <30429206+AishwaryaKalloli@users.noreply.github.com>
Co-authored-by: lorenss-m <saeclmusic@gmail.com>
Co-authored-by: Rocky Haotian Du <2712479005@qq.com>
Co-authored-by: Fenn Bailey <fennb@users.noreply.github.com>
Co-authored-by: daamitt <147169947+daamitt@users.noreply.github.com>
Co-authored-by: Mat Leonard <137834585+mat-octave@users.noreply.github.com>
Co-authored-by: Samuel Felipe Chenatti <samuel.chenatti@gmail.com>
Co-authored-by: Brandon Shar <6599653+BrandonShar@users.noreply.github.com>
Co-authored-by: mingo007 <maoqiming1@huawei.com>
Co-authored-by: adam jones <domdomegg+git@gmail.com>
Co-authored-by: Yann Jouanin <yann.jouanin@valueandco.com>
Co-authored-by: Koichi ITO <koic.ito@gmail.com>
Co-authored-by: Cole Murray <colemurray.cs@gmail.com>
Co-authored-by: inaku <63503085+inaku-Gyan@users.noreply.github.com>
Co-authored-by: Chris Coutinho <12901868+cbcoutinho@users.noreply.github.com>
Co-authored-by: Paul Carleton <paulc@anthropic.com>
Co-authored-by: Camila Rondinini <camila@anthropic.com>
Co-authored-by: Victorien <65306057+Viicos@users.noreply.github.com>
Co-authored-by: Andrii Blyzniuk <bliznyuk.andrey@gmail.com>
Co-authored-by: Liang Wu <18244712+wuliang229@users.noreply.github.com>
Co-authored-by: adam jones <adamj+git@anthropic.com>
Co-authored-by: Olivier Chafik <ochafik@anthropic.com>
Co-authored-by: Tyler Mailman <themailmaninbox@gmail.com>
Co-authored-by: TheMailmans <tyler@example.com>
Co-authored-by: Edison <Edison.A.N@hotmail.com>
Co-authored-by: dvlpjrs <dvlp.jrs@gmail.com>

This was referenced

Feb 27, 2026