Skip to content

Commit a2a717e

Browse files
committed
docs: re-anchor tasks migration notes after the migration guide restructure
The restructured migration guide dropped the server extensions section this branch used to edit, so the feature prose now lives in the extensions and tasks pages. The migration guide's experimental Tasks section and the whats-new removal list now say the extension ships as the built-in Tasks extension instead of claiming it is unimplemented. The extensions page also points at TasksExtension as the shipped behavioural example next to advertise().
1 parent 4231a4e commit a2a717e

3 files changed

Lines changed: 5 additions & 2 deletions

File tree

docs/advanced/extensions.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -177,6 +177,9 @@ from mcp.client import advertise
177177
client = Client(mcp, extensions=[advertise("com.example/search")])
178178
```
179179

180+
For an extension with client-side behaviour, construct its object instead; the
181+
built-in example is `mcp.client.TasksExtension` ([Tasks](tasks.md)).
182+
180183
## Writing a client extension
181184

182185
Subclass `ClientExtension` and override only what you need. Three contribution

docs/migration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1568,7 +1568,7 @@ Behavior changes:
15681568

15691569
Tasks ([SEP-1686](https://github.com/modelcontextprotocol/modelcontextprotocol/issues/1686)) have been removed from the MCP specification and are no longer part of this SDK. The `mcp.client.experimental`, `mcp.server.experimental`, `mcp.shared.experimental`, and `mcp.server.lowlevel.experimental` modules have been removed, along with the `experimental` properties on `ClientSession`, `ServerSession`, `Server`, and `ServerRequestContext`. The corresponding `Task*` types remain in `mcp_types` as types-only definitions, except the `TaskExecutionMode` alias, whose literal is now inlined on `ToolExecution.task_support`.
15701570

1571-
Tasks have since returned as the built-in `Tasks` extension ([SEP-2663](https://modelcontextprotocol.io/seps/2663-tasks-extension.md)), with a different wire shape than the experimental SEP-1686 surface — see [Server extensions API](#server-extensions-api-sep-2133) above and [Tasks](advanced/tasks.md).
1571+
Tasks have since returned as the built-in `Tasks` extension ([SEP-2663](https://modelcontextprotocol.io/seps/2663-tasks-extension.md)), with a different wire shape than the experimental SEP-1686 surface. See [Extensions](advanced/extensions.md) and [Tasks](advanced/tasks.md) for the new design.
15721572

15731573
## Transports
15741574

docs/whats-new.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -144,7 +144,7 @@ The renames announce themselves. These do not:
144144
Each of these is a section in the **[Migration Guide](migration.md)**:
145145

146146
* The **WebSocket transport**, both sides, and the `mcp[ws]` extra. It was never part of the MCP specification.
147-
* The **experimental Tasks** API (`mcp.*.experimental`). 2026-07-28 moves tasks out of the core protocol and into an official extension ([SEP-2663](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2663)), which this SDK does not implement yet.
147+
* The **experimental Tasks** API (`mcp.*.experimental`). 2026-07-28 moves tasks out of the core protocol and into an official extension ([SEP-2663](https://github.com/modelcontextprotocol/modelcontextprotocol/pull/2663)), which this SDK ships as the built-in [Tasks](advanced/tasks.md) extension.
148148
* `mcp.types`, `mcp.shared.version`, and `mcp.shared.progress` as import paths.
149149
* The deprecated `streamablehttp_client` spelling, and the `get_session_id` callback from `streamable_http_client` (which now yields exactly two streams).
150150
* `McpError`, renamed **`MCPError`** with a direct `(code, message, data)` constructor.

0 commit comments

Comments
 (0)