Skip to main content

​
fastmcp.server.tasks.handlers

SEP-1686 task execution handlers. Handles queuing tool/prompt/resource executions to Docket as background tasks.

​
Functions

​
submit_to_docket 

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