fastmcp.server.tasks.requests

SEP-1686 task request handlers.

Handles MCP task protocol requests: tasks/get, tasks/result, tasks/list, tasks/cancel. These handlers query and manage existing tasks (contrast with handlers.py which creates tasks).

This module requires fastmcp[tasks] (pydocket). It is only imported when docket is available.

Functions

tasks_get_handler ^{<a href="https://github.com/PrefectHQ/fastmcp/blob/main/src/fastmcp/server/tasks/requests.py#L135" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a>}

tasks_get_handler(server: FastMCP, params: dict[str, Any]) -> GetTaskResult

Handle MCP 'tasks/get' request (SEP-1686).

Args:

• server: FastMCP server instance
• params: Request params containing taskId

Returns:

• Task status response with spec-compliant fields

tasks_result_handler ^{<a href="https://github.com/PrefectHQ/fastmcp/blob/main/src/fastmcp/server/tasks/requests.py#L220" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a>}

tasks_result_handler(server: FastMCP, params: dict[str, Any]) -> Any

Handle MCP 'tasks/result' request (SEP-1686).

Converts raw task return values to MCP types based on task type.

Args:

• server: FastMCP server instance
• params: Request params containing taskId

Returns:

• MCP result (CallToolResult, GetPromptResult, or ReadResourceResult)

tasks_list_handler ^{<a href="https://github.com/PrefectHQ/fastmcp/blob/main/src/fastmcp/server/tasks/requests.py#L401" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a>}

tasks_list_handler(server: FastMCP, params: dict[str, Any]) -> ListTasksResult

Handle MCP 'tasks/list' request (SEP-1686).

Note: With client-side tracking, this returns minimal info.

Args:

• server: FastMCP server instance
• params: Request params (cursor, limit)

Returns:

• Response with tasks list and pagination

tasks_cancel_handler ^{<a href="https://github.com/PrefectHQ/fastmcp/blob/main/src/fastmcp/server/tasks/requests.py#L419" target="_blank"><Icon icon="github" style="width: 14px; height: 14px;" /></a>}

tasks_cancel_handler(server: FastMCP, params: dict[str, Any]) -> CancelTaskResult

Handle MCP 'tasks/cancel' request (SEP-1686).

Cancels a running task, transitioning it to cancelled state.

Args:

• server: FastMCP server instance
• params: Request params containing taskId

Returns:

• Task status response showing cancelled state