fastmcp.server.tasks.handlers

SEP-1686 task execution handlers.

Handles queuing tool/prompt/resource executions to Docket as background tasks.

Functions

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

submit_to_docket(task_type: Literal['tool', 'resource', 'template', 'prompt'], key: str, component: Tool | Resource | ResourceTemplate | Prompt, arguments: dict[str, Any] | None = None, task_meta: TaskMeta | None = None) -> mcp.types.CreateTaskResult

Submit any component to Docket for background execution (SEP-1686).

Unified handler for all component types. Called by component's internal methods (_run, _read, _render) when task metadata is present and mode allows.

Queues the component's method to Docket, stores raw return values, and converts to MCP types on retrieval.

Args:

• task_type: Component type for task key construction
• key: The component key as seen by MCP layer (with namespace prefix)
• component: The component instance (Tool, Resource, ResourceTemplate, Prompt)
• arguments: Arguments/params (None for Resource which has no args)
• task_meta: Task execution metadata. If task_meta.ttl is provided, it overrides the server default (docket.execution_ttl).

Returns:

• Task stub with proper Task object