yera.tools.mcp.client
Client boundary for MCP Streamable HTTP servers.
Symbols
MCPClient
Communicate with one MCP server over Streamable HTTP.
Methods
MCPClient.__init__
__init__(
url: str,
http_client: httpx2.AsyncClient | None = None,
) → NoneInitialize a client for one Streamable HTTP MCP endpoint.
Parameters
Absolute URL of the MCP server endpoint.
Shared asynchronous HTTP client, or None to let
the transport create one for each connection.
MCPClient.list_tools
list_tools() → list[Tool]Return the tools advertised by the MCP server.
Returns
Tool definitions returned by MCP discovery.
MCPClient.call_tool
call_tool(
name: str,
arguments: Mapping[str, Any],
) → CallToolResultCall a tool and return its raw MCP result.
Parameters
Exact tool name advertised by the MCP server.
Validated values for the tool input schema.
Returns
The unconverted MCP tool result.
MCPClient.start_tool
start_tool(
name: str,
arguments: Mapping[str, Any],
) → CallToolResult | CreateTaskResultStart a tool call without waiting for a returned task.
Parameters
Exact tool name advertised by the MCP server.
Validated values for the tool input schema.
Returns
An immediate tool result or the initial server-created task state.
Raises
If the server returns an unsupported task response.
MCPClient.get_task
get_task(
task_id: str,
) → GetTaskResultReturn the current state of one server-backed task.
Parameters
Stable identifier minted by the MCP server.
Returns
Current task state and any status-specific payload.
MCPClient.update_task
update_task(
task_id: str,
input_responses: InputResponses,
) → TaskAcknowledgementResultSupply responses requested by an input-required task.
Parameters
Stable identifier minted by the MCP server.
Responses keyed by outstanding request identity.
Returns
The server's update acknowledgement.
MCPClient.cancel_task
cancel_task(
task_id: str,
) → TaskAcknowledgementResultRequest cooperative cancellation of one server-backed task.
Parameters
Stable identifier minted by the MCP server.
Returns
The server's cancellation acknowledgement.