You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/specification/draft/basic/utilities/tasks.mdx
+6-6Lines changed: 6 additions & 6 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ title: Tasks
8
8
9
9
<Note>
10
10
11
-
Tasks are newly-introduced in this version of the MCP specification and are currently considered **experimental**.
11
+
Tasks were introduced in version 2025-11-25 of the MCP specification and are currently considered **experimental**.
12
12
The design and behavior of tasks may evolve in future protocol versions.
13
13
14
14
</Note>
@@ -167,7 +167,7 @@ To create a task, requestors send a request with the `task` field included in th
167
167
}
168
168
```
169
169
170
-
When a receiver accepts a task-augmented request, it returns a `CreateTaskResult` containing task metadata. The response does not include the actual operation result. The actual result (e.g., tool result for `tools/call`) becomes available only through `tasks/result` after the task completes.
170
+
When a receiver accepts a task-augmented request, it returns a [`CreateTaskResult`](/specification/draft/schema#createtaskresult) containing task metadata. The response does not include the actual operation result. The actual result (e.g., tool result for `tools/call`) becomes available only through `tasks/result` after the task completes.
171
171
172
172
<Note>
173
173
@@ -219,7 +219,7 @@ Requestors **SHOULD** continue polling until the task reaches a terminal status
219
219
220
220
### Retrieving Task Results
221
221
222
-
After a task completes the operation result is retrieved via `tasks/result`. This is distinct from the initial `CreateTaskResult` response, which contains only task metadata. The result structure matches the original request type (e.g., `CallToolResult` for `tools/call`).
222
+
After a task completes the operation result is retrieved via [`tasks/result`](/specification/draft/schema#tasks%2Fresult). This is distinct from the initial `CreateTaskResult` response, which contains only task metadata. The result structure matches the original request type (e.g., `CallToolResult` for `tools/call`).
223
223
224
224
To retrieve the result of a completed task, requestors can send a `tasks/result` request:
225
225
@@ -261,7 +261,7 @@ To retrieve the result of a completed task, requestors can send a `tasks/result`
261
261
262
262
### Task Status Notification
263
263
264
-
When a task status changes, receivers **MAY** send a `notifications/tasks/status` notification to inform the requestor of the change. This notification includes the full task state.
264
+
When a task status changes, receivers **MAY** send a [`notifications/tasks/status`](/specification/draft/schema#notifications%2Ftasks%2Fstatus) notification to inform the requestor of the change. This notification includes the full task state.
265
265
266
266
**Notification:**
267
267
@@ -285,7 +285,7 @@ Requestors **MUST NOT** rely on receiving this notifications, as it is optional.
285
285
286
286
### Listing Tasks
287
287
288
-
To retrieve a list of tasks, requestors can send a `tasks/list` request. This operation supports pagination.
288
+
To retrieve a list of tasks, requestors can send a [`tasks/list`](/specification/draft/schema#tasks%2Flist) request. This operation supports pagination.
289
289
290
290
**Request:**
291
291
@@ -329,7 +329,7 @@ To retrieve a list of tasks, requestors can send a `tasks/list` request. This op
329
329
330
330
### Cancelling Tasks
331
331
332
-
To explicitly cancel a task, requestors can send a `tasks/cancel` request.
332
+
To explicitly cancel a task, requestors can send a [`tasks/cancel`](/specification/draft/schema#tasks%2Fcancel) request.
0 commit comments