Skip to main content
Use this when you need to track progress of long-running operations. MCP servers can report progress during operations. The client receives these updates through a progress handler.

Progress Handler

Set a handler when creating the client:
The handler receives three parameters:

Handler Parameters

float
Current progress value
float | None
Expected total value (may be None if unknown)
str | None
Optional status message

Per-Call Handler

Override the client-level handler for specific tool calls: