̺iU=SrSSKJr SSKrSSKrSSKJrJr SSKJ r SSK J r SSK J r JrJrJrJrJrJrJrJrJr SSKJr S S KJrJrJrJr S S K J!r!J"r"J#r#J$r$J%r%J&r& SSK'J(r( S SK)J*r+ /SQr,\-"1Sk5r."SS\/5r0"SS\15r2S%Sjr3S&Sjr4"SS\55r6SS.S'Sjjr7SS.S(Sjjr8SS.S)Sjjr9SS.S*Sjjr:S+S jr;S,S!jrg!\ar\"S 5\eSrCff=f)/aGHelpers for integrating MCP (Model Context Protocol) SDK types with the Anthropic SDK. These helpers reduce boilerplate when converting between MCP types and Anthropic API types. Usage:: from anthropic.lib.tools.mcp import mcp_tool, async_mcp_tool, mcp_message This module requires the ``mcp`` package to be installed. ) annotationsN)AnyIterable)urlparse)Literal) Tool TextContent ContentBlock ImageContent PromptMessageCallToolResultEmbeddedResourceReadResourceResultBlobResourceContentsTextResourceContents) ClientSessionz~The `mcp` package is required to use MCP helpers. Install it with: pip install anthropic[mcp]. Requires Python 3.10 or higher.)BetaBase64PDFSourceParamBetaPlainTextSourceParamBetaBase64ImageSourceParamBetaCacheControlEphemeralParam) ToolErrorBetaFunctionToolBetaAsyncFunctionToolBetaFunctionToolResultType beta_toolbeta_async_tool) tag_helper)Content)mcp_toolasync_mcp_tool mcp_content mcp_messagemcp_resource_to_contentmcp_resource_to_fileUnsupportedMCPValueError> image/gif image/png image/jpeg image/webpc\rSrSrSrSrg) _TaggedDictJzA dict subclass that can carry a ``_stainless_helper`` attribute. Behaves identically to a regular dict for serialization and isinstance checks, but allows attaching tracking metadata that won't appear in JSON output. N__name__ __module__ __qualname____firstlineno____doc____static_attributes__r0V/var/www/piano.thomer.com/venv/lib/python3.13/site-packages/anthropic/lib/tools/mcp.pyr.r.Jsr8r.c\rSrSrSrSrg) _TaggedTupleRzBA tuple subclass that can carry a ``_stainless_helper`` attribute.r0Nr1r0r8r9r;r;RsLr8r;cU[;$N)_SUPPORTED_IMAGE_TYPES mime_types r9_is_supported_image_typerBVs . ..r8cvUSL=(d/ URS5=(d US:H=(d [U5$)Ntext/application/pdf) startswithrBr@s r9 _is_supported_resource_mime_typerGZs?T /    ( / ) ) / $I . r8c\rSrSrSrSrg)r(hzURaised when an MCP value cannot be converted to a format supported by the Claude API.r0Nr1r0r8r9r(r(hs_r8r( cache_controlc B[U[5(a-[SURS.5nUbXS'[ US5 U$[U[ 5(ar[ UR5(d[SUR35e[S[SURURS9S .5nUbXS'[ US5 U$[U[5(a[URUS 9$[US [U5R 5n[S U35e) zConvert a single MCP content block to an Anthropic content block. Handles text, image, and embedded resource content types. Raises :class:`UnsupportedMCPValueError` for audio and resource_link types. text)typerMrKr$zUnsupported image MIME type: imagebase64rNdata media_typerNsourcerJrNzUnsupported MCP content type: ) isinstancer r.rMr r rBmimeTyper(rrRr_resource_contents_to_blockresourcegetattrrNr2)contentrKblock image_block content_types r9r$r$qs';''VW\\BC  $%2/ "5-( '<(('(8(899*-J7K[K[J\+]^ ^!4! &//     $+8 (; .'+,,*7+;+;=YY7FDM,B,BCL "%CL>#R SSr8c :URnUbs[U5(ac[U[5(d[ SUR 35e[ S[SURUS9S.5nUbXS'[US5 U$US:Xac[U[5(d[ S UR 35e[ S [SURSS9S.5nUbXS'[US5 U$UbURS 5(a}[U[5(a URnO/[R"UR5R!S 5n[ S [#S USS9S.5nUbXS'[US5 U$[ SUSUR 35e)z)rGrW).0cs r9 *mcp_resource_to_content.. sTOq'G 'SOs- -Nz>No supported MIME type found in resource contents. Available: z, rJ)contentsr(nextrWjoinrX)rkrK supportedrp mime_typess r9r&r&s ??&'_``TFOOT I*0//T/QZZjajj/ T&LTYYWaMbLc d   'y NN Us BBcUR(d [S5eURSn[UR5n[ U5R nU(aUR SS5SOSn[U[5(a![R"UR5nOURRS5n[XEUR45n[!US5 U$) zConvert MCP resource contents to a file tuple for ``files.upload()``. Returns a ``(filename, content_bytes, mime_type)`` tuple compatible with the SDK's ``FileTypes``. rmr/rNrar')rsr(strrbrpathrsplitrVrrPrdrcrMencoder;rWr )rkrYuri_strr|name content_bytes file_tuples r9r'r's ??&'_``q!H(,,G G  ! !D&*4;;sA r "D(011((7  ,,W5 tH4E4EFGJz12 r8c^UR(a/[URVs/sHn[U5PM sn5eUR(d-URb [ R "UR5$URVs/sHn[U5PM sn$s snfs snf)zQConvert MCP ``CallToolResult`` to a value suitable for returning from ``call()``.)isErrorrr[r$structuredContentjsondumps)rkitems r9_convert_tool_resultr8s~ ~~v~~F~tT*~FGG >>f66Bzz&2233*0.. 9.$K . 99 G :s B% B*)rK defer_loadingallowed_callerseager_input_streaminginput_examplesstrictc ^^ ^ SSKm URm SU UU 4Sjjn[UT URURUUUUUUS9 n [ U S5 U $)aConvert an MCP tool to a sync runnable tool for ``tool_runner()``. Example:: from anthropic.lib.tools.mcp import mcp_tool tools_result = await mcp_client.list_tools() runner = client.beta.messages.tool_runner( model="claude-sonnet-4-20250514", max_tokens=1024, tools=[mcp_tool(t, mcp_client) for t in tools_result.tools], messages=[{"role": "user", "content": "Use the available tools"}], ) Args: tool: An MCP tool definition from ``client.list_tools()``. client: The MCP ``ClientSession`` used to call the tool. cache_control: Cache control configuration. defer_loading: If true, tool will not be included in initial system prompt. allowed_callers: Which callers may use this tool. eager_input_streaming: Enable eager input streaming for this tool. input_examples: Example inputs for the tool. strict: When true, guarantees schema validation on tool names and inputs. rNch>TRRTRTU5n[U5$r>) from_threadrun call_toolr)kwargsrkanyioclient tool_names r9call_mcpmcp_tool..call_mcpps.""&&v'7'7FK#F++r8 r description input_schemarKrrrrrr"rrreturnr)anyio.from_threadrrr inputSchemar ) toolrrKrrrrrrrkrrs ` @@r9r"r"IscF I,, $$%%##'3% Fvz" Mr8c ^^ URm SUU 4Sjjn[UT URURUUUUUUS9 n [ U S5 U $)aConvert an MCP tool to an async runnable tool for ``tool_runner()``. Example:: from anthropic.lib.tools.mcp import async_mcp_tool tools_result = await mcp_client.list_tools() runner = await client.beta.messages.tool_runner( model="claude-sonnet-4-20250514", max_tokens=1024, tools=[async_mcp_tool(t, mcp_client) for t in tools_result.tools], messages=[{"role": "user", "content": "Use the available tools"}], ) Args: tool: An MCP tool definition from ``client.list_tools()``. client: The MCP ``ClientSession`` used to call the tool. cache_control: Cache control configuration. defer_loading: If true, tool will not be included in initial system prompt. allowed_callers: Which callers may use this tool. eager_input_streaming: Enable eager input streaming for this tool. input_examples: Example inputs for the tool. strict: When true, guarantees schema validation on tool names and inputs. cV># TRTUS9IShvN n[U5$N7f)N)r arguments)rr)rrkrrs r9r async_mcp_tool..call_mcps/''Y&'II#F++Js )')rr"r)rrrrr ) rrrKrrrrrrrkrs ` @r9r#r#s`F I,, $$%%##'3% Fvz" Mr8)rAr{rbool)rAz str | Nonerr)r[r rK%BetaCacheControlEphemeralParam | Noner BetaContent)rYz+TextResourceContents | BlobResourceContentsrKrrr)rjr rKrrzdict[str, Any])rkrrKrrr)rkrrz$tuple[str | None, bytes, str | None])rkr rr)rrrrrKrr bool | NonerTlist[Literal['direct', 'code_execution_20250825', 'code_execution_20260120']] | Nonerrr"Iterable[dict[str, object]] | NonerrrzBetaFunctionTool[Any])rrrrrKrrrrrrrrrrrrzBetaAsyncFunctionTool[Any])?r6 __future__rrrPtypingrr urllib.parsertyping_extensionsr mcp.typesrr r r r r rrrrmcp.client.sessionr ImportError_err types.betarrrr_beta_functionsrrrrrr_stainless_helpersr 'types.beta.beta_tool_result_block_paramr!r__all__ frozensetr?dictr.tupler;rBrG Exceptionr(r$rXr%r&r'rr"r#r0r8r9rso # !%   1  ,M ##YZ$M5M/`y`<@(T (T9(T (T\<@Ch9Ch9Ch Ch\<@   9  0<@O O9O O4 )D :*<@!%lp)-9=8 8 89 8  8 j 8'878 88~<@!%lp)-9=6 6 69 6  6 j 6'676 6 6C   I  sD**D>0 D99D>