yera.tools.mcp.client

Client boundary for MCP Streamable HTTP servers.

Symbols

class MCPClient — Communicate with one MCP server over Streamable HTTP.

MCPClient

Communicate with one MCP server over Streamable HTTP.

Methods

list_tools — Return the tools advertised by the MCP server.
call_tool — Call a tool and return its raw MCP result.
start_tool — Start a tool call without waiting for a returned task.
get_task — Return the current state of one server-backed task.
update_task — Supply responses requested by an input-required task.
cancel_task — Request cooperative cancellation of one server-backed task.

MCPClient.list_tools

list_tools() → list[Tool]

Return the tools advertised by the MCP server.

MCPClient.call_tool

call_tool(
    name: str,
    arguments: Mapping[str, Any],
) → CallToolResult

Call a tool and return its raw MCP result.

MCPClient.start_tool

start_tool(
    name: str,
    arguments: Mapping[str, Any],
) → CallToolResult | CreateTaskResult

Start a tool call without waiting for a returned task.

Parameters

name
type: str

Exact tool name advertised by the MCP server.

arguments
type: Mapping[str, Any]

Validated values for the tool input schema.

Returns

type: CallToolResult | CreateTaskResult

An immediate tool result or the initial server-created task state.

MCPClient.get_task

get_task(
    task_id: str,
) → GetTaskResult

Return the current state of one server-backed task.

Parameters

task_id
type: str

Stable identifier minted by the MCP server.

Returns

type: GetTaskResult

Current task state and any status-specific payload.

MCPClient.update_task

update_task(
    task_id: str,
    input_responses: InputResponses,
) → TaskAcknowledgementResult

Supply responses requested by an input-required task.

Parameters

task_id
type: str

Stable identifier minted by the MCP server.

input_responses
type: InputResponses

Responses keyed by outstanding request identity.

Returns

type: TaskAcknowledgementResult

The server's update acknowledgement.

MCPClient.cancel_task

cancel_task(
    task_id: str,
) → TaskAcknowledgementResult

Request cooperative cancellation of one server-backed task.

Parameters

task_id
type: str

Stable identifier minted by the MCP server.

Returns

type: TaskAcknowledgementResult

The server's cancellation acknowledgement.