Mirascopev2
Lilypad

mcp

Class MCPClient

Mirascope wrapper around a MCP ClientSession.

It provides a way to get MCP results that are pre-converted into Mirascope-friendly types.

The underlying MCP ClientSession may be accessed by .session if needed.

Attributes

NameTypeDescription
sessionClientSessionAccess the underlying MCP ClientSession if needed.

Function list_tools

List all tools available on the MCP server.

Parameters

NameTypeDescription
selfAny-

Returns

TypeDescription
list[AsyncTool]A list of dynamically created `llm.Tool`s.

Function sse_client

Create a Mirascope MCPClient using sse.

Parameters

NameTypeDescription
urlstr-
list_roots_callback= NoneListRootsFnT | None-
read_timeout_seconds= Nonetimedelta | None-
sampling_callback= NoneSamplingFnT | None-
session= NoneClientSession | None-

Returns

TypeDescription
AsyncIterator[MCPClient]-

Function stdio_client

Create a Mirascope MCPClient using stdio.

Parameters

NameTypeDescription
server_parametersStdioServerParameters-
read_stream_exception_handler= None(Exception) => None | None-

Returns

TypeDescription
AsyncIterator[MCPClient]-

Function streamablehttp_client

Create a Mirascope MCPClient using StreamableHTTP.

Parameters

NameTypeDescription
urlstr-
headers= Nonedict[str, str] | None-
timeout= Nonefloat | timedelta | None-
sse_read_timeout= Nonefloat | timedelta | None-
terminate_on_close= Truebool-
httpx_client_factory= NoneMcpHttpClientFactory | None-
auth= Nonehttpx.Auth | None-

Returns

TypeDescription
AsyncIterator[MCPClient]-