k7ih %SSKJr SSKrSSKrSSKrSSKrSSKrSSKJrJ r J r SSK J r SSK JrJr SSKJr SSKJr SSKJr SS KJrJrJrJrJr SSKrSS KJrJr SS KJ r SS K!J"r" SS K#J$r$ SSK%J&r&J'r'J(r(J)r)J*r*J+r+J,r,J-r-J.r.J/r/J0r0J1r1 SSK%J2r3 SSK%J4r5 SSK%J6r7 SSK8J9r9 SSK:J;r; SSKr?SSK?J@r@ SSKAJBrBJCrCJDrDJErEJFrF SSKGJHrH SSKIJJrJJKrK SSKLJMrM \K"\NS9rOS\PS'\ORSS9rRS\PS'\J"\RS S!9 \="S"\S#9rS\"S$SS#9rTS%\PS&'\R"5rV\"S'S(55rW\R\R\R\R\R\R\R\RS).r]\ S/S+j5r^\"S,S*55r_S0S-jr`S1S2S.jjrag)3) annotationsN) GeneratorMappingSequence)contextmanager) ContextVarToken) dataclass)Enum)Logger)AnyLiteralcast get_originoverload) LoggingLevel ServerSession)ReadResourceContents) request_ctx)RequestContext) AudioContentClientCapabilitiesCreateMessageResultGetPromptResult ImageContentIncludeContext ModelHintModelPreferencesRootSamplingCapabilitySamplingMessage TextContent)CreateMessageRequestParams)Prompt)Resource)AnyUrl)Request)TypeVar)settings)AcceptedElicitationCancelledElicitationDeclinedElicitationScalarElicitationTypeget_elicitation_schema)FastMCP) _clamp_logger get_logger)get_cached_typeadapternamer logger to_client)suffixto_client_loggerDEBUG)r5 max_levelT)defaultcontextzContextVar[Context | None]_current_contextc2\rSrSr%SrS\S'SrS\S'Srg) LogDataEzData object for passing log arguments to client-side handlers. This provides an interface to match the Python standard library logging, for compatibility with structured logging. strmsgNMapping[str, Any] | Noneextra)__name__ __module__ __qualname____firstlineno____doc____annotations__rE__static_attributes__rFP/home/james-whalen/.local/lib/python3.13/site-packages/fastmcp/server/context.pyr@r@Es H&*E #*rNr@)debuginfonoticewarningerrorcriticalalert emergencyContextc## [RU5nUv [RU5 g![RU5 f=f7fN)r>setreset)r=tokens rO set_contextr^]s<   )E& u%u%sA 3A A  A c\rSrSrSrS(Sjr\S)Sj5rS*SjrS+Sjr \S,Sj5r S-S.S jjr S/S jr S0S jr S1S2S jjrS3S jrS4S5Sjjr\S6Sj5r\S7Sj5r\S7Sj5r\S8Sj5rS-S9SjjrS-S9SjjrS-S9SjjrS-S9SjjrS:SjrS+SjrS+SjrS+SjrS;SSj5r\S?Sj5rS1S@SjjrSAS jr SBS!jr!SCS"jr"S+S#jr#S+S$jr$S+S%jr%S+S&jr&S'r'g)DrXfayContext object providing access to MCP capabilities. This provides a cleaner interface to MCP's RequestContext functionality. It gets injected into tool and resource functions that request it via type hints. To use context in a tool function, add a parameter with the Context type annotation: ```python @server.tool async def my_tool(x: int, ctx: Context) -> str: # Log messages to the client await ctx.info(f"Processing {x}") await ctx.debug("Debug info") await ctx.warning("Warning message") await ctx.error("Error message") # Report progress await ctx.report_progress(50, 100, "Processing") # Access resources data = await ctx.read_resource("resource://data") # Get request info request_id = ctx.request_id client_id = ctx.client_id # Manage state across the request ctx.set_state("key", "value") value = ctx.get_state("key") return str(x) ``` State Management: Context objects maintain a state dictionary that can be used to store and share data across middleware and tool calls within a request. When a new context is created (nested contexts), it inherits a copy of its parent's state, ensuring that modifications in child contexts don't affect parent contexts. The context parameter name can be anything as long as it's annotated with Context. The context is optional - tools that don't need it can omit the parameter. ct[R"U5Ul/Ul[ 5Ul0UlgrZ)weakrefref_fastmcp_tokensr[_notification_queue_stateselffastmcps rO__init__Context.__init__s*.5kk'.B $& -0U &( rNcBUR5nUc [S5eU$)zGet the FastMCP instance.z'FastMCP instance is no longer available)rd RuntimeErrorrhs rOrjContext.fastmcps%--/ ?HI IrNc# [RS5nUb%[R"UR5Ul[R U5nUR RU5 U$7f)zFEnter the context manager and set this context as the current context.N)r>getcopydeepcopyrgr[reappend)riparent_contextr]s rO __aenter__Context.__aenter__sZ)--d3  %--(=(=>DK!$$T* E" sA0A2c# UR5IShvN UR(a0URR5n[R U5 ggNF7f)z9Exit the context manager and reset the most recent token.N)_flush_notificationsrepopr>r\)riexc_typeexc_valexc_tbr]s rO __aexit__Context.__aexit__sJ''))) <<LL$$&E  " "5 )  *sAAAAcj[R"5$![an[S5UeSnAff=f)zqAccess to the underlying request context. If called outside of a request context, this will raise a ValueError. z-Context is not available outside of a requestN)rrq LookupError ValueError)ries rOrequest_contextContext.request_contexts6  U??$ $ ULMST T Us 2 -2Nc# URR(a URRROSnUcgURR UUUUUR S9IShvN gN7f)zReport progress for the current operation. Args: progress: Current progress value e.g. 24 total: Optional total value e.g. 100 N)progress_tokenprogresstotalmessagerelated_request_id)rmeta progressTokensessionsend_progress_notification request_id)rirrrrs rOreport_progressContext.report_progressst##((  % % 3 3   ! ll55)# 6   sA,A6.A4/A6cR# URR5IShvN $N7f)zmList all available resources from the server. Returns: List of Resource objects available on the server N)rj_list_resources_mcpris rOlist_resourcesContext.list_resourcess \\557777 '%'cR# URR5IShvN $N7f)ziList all available prompts from the server. Returns: List of Prompt objects available on the server N)rj_list_prompts_mcprs rO list_promptsContext.list_promptss \\335555rcT# URRX5IShvN $N7f)zGet a prompt by name with optional arguments. Args: name: The name of the prompt to get arguments: Optional arguments to pass to the prompt Returns: The prompt result N)rj_get_prompt_mcp)rir4 argumentss rO get_promptContext.get_prompts"\\11$BBBB (&(cT# URRU5IShvN $N7f)zxRead a resource by URI. Args: uri: Resource URI to read Returns: The resource content as either text or bytes N)rj_read_resource_mcp)riuris rO read_resourceContext.read_resources"\\44S9999rc# [XS9n[UURU=(d SUURS9IShvN gN7f)aSend a log message to the client. Messages sent to Clients are also logged to the `fastmcp.server.context.to_client` logger with a level of `DEBUG`. Args: message: Log message level: Optional log level. One of "debug", "info", "notice", "warning", "error", "critical", "alert", or "emergency". Default is "info". logger_name: Optional logger name extra: Optional mapping for additional arguments )rCrErQ)datarlevel logger_namerN)r@_log_to_server_and_clientrr)rirrrrErs rOlog Context.logs>$70'LL/6##    s7A?Ac~URR(a![URRSS5$S$)zGet the client ID if available. client_idN)rrgetattrrs rOrContext.client_id"s< ##(( D((--{D A  rNc@[URR5$)z#Get the unique ID for this request.)rBrrrs rOrContext.request_id+s4''2233rNcURnURn[USS5nUbU$URnU(aURR S5nUcSSKJn [U"55nX2l U$)a=Get the MCP session ID for ALL transports. Returns the session ID that can be used as a key for session-based data storage (e.g., Redis) to share data between tool calls within the same client session. Returns: The session ID for StreamableHTTP transports, or a generated ID for other transports. Example: ```python @server.tool def store_data(data: dict, ctx: Context) -> str: session_id = ctx.session_id redis_client.set(f"session:{session_id}:data", json.dumps(data)) return f"Data stored for session {session_id}" ``` _fastmcp_idNzmcp-session-idr)uuid4) rrrrequestheadersrquuidrrBr)rirr session_idrrs rOrContext.session_id0s*** %%WmT:  ! %%  ,,-=>J   "UWJ)rNc.URR$)z4Access to the underlying session for advanced usage.)rrrs rOrContext.session\s##+++rNcD# URSUUUS9IShvN gN7f)zSend a `DEBUG`-level message to the connected MCP Client. Messages sent to Clients are also logged to the `fastmcp.server.context.to_client` logger with a level of `DEBUG`.rPrrrrENrrirrrEs rOrP Context.debugb.hh#      cD# URSUUUS9IShvN gN7f)zSend a `INFO`-level message to the connected MCP Client. Messages sent to Clients are also logged to the `fastmcp.server.context.to_client` logger with a level of `DEBUG`.rQrNrrs rOrQ Context.infors.hh#    rcD# URSUUUS9IShvN gN7f)zSend a `WARNING`-level message to the connected MCP Client. Messages sent to Clients are also logged to the `fastmcp.server.context.to_client` logger with a level of `DEBUG`.rSrNrrs rOrSContext.warnings.hh#    rcD# URSUUUS9IShvN gN7f)zSend a `ERROR`-level message to the connected MCP Client. Messages sent to Clients are also logged to the `fastmcp.server.context.to_client` logger with a level of `DEBUG`.rTrNrrs rOrT Context.errorrrcj# URR5IShvN nUR$N7f)zCList the roots available to the server, as indicated by the client.N)r list_rootsroots)riresults rOrContext.list_rootss)||..00||1s 313cT# URR5IShvN gN7f)z4Send a tool list changed notification to the client.N)rsend_tool_list_changedrs rOrContext.send_tool_list_changedsll11333 (&(cT# URR5IShvN gN7f)z8Send a resource list changed notification to the client.N)rsend_resource_list_changedrs rOr"Context.send_resource_list_changedsll55777rcT# URR5IShvN gN7f)z6Send a prompt list changed notification to the client.N)rsend_prompt_list_changedrs rOr Context.send_prompt_list_changedsll33555rc # UcSn[U[5(a[[USS9SS9/nON[U[5(a9UVs/sH,n[U[5(a[[USS9SS9OUPM. nnUR R S:H=(a- URR[[5S9S 9(+n UR R S :XdU (aUR Rc [S 5eUR RW[UUUU[U5S 9UR5n [ R""U 5(a U IShvN n [U [5(a [U SS9$[U [$5(a U R&$[S U 35eURR)WUUUU[U5UR*S9IShvN n U R&$s snfNN7f)z Send a sampling request to the client and await the response. Call this method at any time to have the server request an LLM completion from the client. The client must be appropriately configured, or the request will error. Nitext)rtypeuser)contentrolefallback)sampling) capabilityalwaysz Client does not support sampling) systemPromptmessages temperature maxTokensmodelPreferencesz$Unexpected sampling handler result: )r system_promptinclude_contextr max_tokensmodel_preferencesr) isinstancerBr!r"rrjsampling_handler_behaviorrcheck_client_capabilityrr sampling_handlerrSamplingParams_parse_model_preferencesrinspect isawaitablerrcreate_messager) rirrrrrrsampling_messagesmshould_fallbackcreate_message_resultrs rOsampleContext.samples"  J h $ $'XFC&!  ( + + " !"Aa%% (HvV" ! LL 2 2j @ LL88-7I7KL9  << 1 1X =||,,4 !CDD$(LL$A$A!!.. +(%=>O%P $$ % !""#899.C(C%/55"(=FKK/1DEE,444!:;P:QR-1LL,G,G&'+#!67HI#-H- ' ~~m!>)D' s2AH  3H=C-H *H+BH 2H 3H  H c # g7frZrFrir response_types rOelicitContext.elicits  c # g7frZrFrs rOrrs ORrc # g7frZrFrs rOrrs QTrc# UcS0S.nO[U[5(aA[SU55(d[SU35e[[ U5n[ UnO_U[[[[1;d<[U5[Ld*[U[5(a[U[5(a [ Un[[[ U5n[#U5nUR$R'UUUR(S9IShvN nUR*S:XaUb[-U5n[[ [ [ -UR/UR055n[U[ 5(a[2[ "UR4S9$[2[ "[[ U5S9$UR0(a[S UR035e[2[6[[84"0S9$UR*S :Xa [;5$UR*S :Xa [=5$[S UR*35eGN<7f) a! Send an elicitation request to the client and await the response. Call this method at any time to request additional information from the user through the client. The client must support elicitation, or the request will error. Note that the MCP protocol only supports simple object schemas with primitive types. You can provide a dataclass, TypedDict, or BaseModel to comply. If you provide a primitive type, an object schema with a single "value" field will be generated for the MCP interaction and automatically deconstructed into the primitive type upon response. If the response_type is None, the generated schema will be that of an empty object in order to comply with the MCP protocol requirements. Clients must send an empty object ("{}")in response. Args: message: A human-readable message explaining what information is needed response_type: The type of the response, which should be a primitive type or dataclass or BaseModel. If it is a primitive type, an object schema with a single "value" field will be generated. Nobject)r propertiesc3B# UHn[U[5v M g7frZrrB).0items rO !Context.elicit..MsK]T:dC00]z5List of options must be a list of strings. Received: )rrequestedSchemaraccept)rz6Elicitation expected an empty response, but received: declinecancelzUnexpected elicitation action: )rlistallrrtupler-boolintfloatrBrr issubclassr rr;r.rrractionr2validate_pythonrr*valuedictr r,r+)rirrschemachoice_literalr type_adaptervalidated_datas rOrr&sD  &b9F-..K]KKK$O(/+ ")})=!> 5n E $UC!88m,7}d33 =RV8W8W 5m D  a-8M+M:F||**"#+   ==H $(5mD !%-a00 00@"n.CDD.q1~7K7KLL.q1tA~7NOO L~~&( +4S>:CC ]]i '&( ( ]]h &') )>v}}oNO O= sD I  I D!$IMKrNc TUcg[U[5(aU$[U[5(a[[US9/S9$[U[5(aC[ SU55(d [ S5e[UVs/sH n[US9PM snS9$[ S5es snf)a( Validates and converts user input for model_preferences into a ModelPreferences object. Args: model_preferences (ModelPreferences | str | list[str] | None): The model preferences to use. Accepts: - ModelPreferences (returns as-is) - str (single model hint) - list[str] (multiple model hints) - None (no preferences) Returns: ModelPreferences | None: The parsed ModelPreferences object, or None if not provided. Raises: ValueError: If the input is not a supported type or contains invalid values. Nr3)hintsc3B# UHn[U[5v M g7frZr )r hs rOr +_parse_model_preferences..sA/@!:a%%/@rzJAll elements of model_preferences list must be strings (model name hints).zLmodel_preferences must be one of: ModelPreferences, str, list[str], or None.)rrrBrrrr)rrQs rOrrs(  %'7 8 8  %s + +y6G'H&IJJ %t , ,A/@AAA/  BS&TBSQya'8BS&TUU Z  'UsB%c# SUR5S3nU(a USUS3- n[R[UUSUR3UR S9 UR UUUUS9IShvN gN7f) z'Log a message to the server and client.zSending z to clientz ()z: )rrCrE)rrr5rN)upperr8r_mcp_level_to_python_levelrCrEsend_log_message)rrrrr msg_prefixs rOrrsEKKM?*5J;-q)) (/l"TXXJ 'jj  " " - # sA/A91A72A9)r=rXrGzGenerator[Context, None, None])rrLrGzModelPreferences | NonerI) rr@rrrrrrKrrKrGrH)b __future__rrrrloggingr&rbcollections.abcrrr contextlibr contextvarsrr dataclassesr enumr r typingr rrrranyiomcprr mcp.server.lowlevel.helper_typesrmcp.server.lowlevel.serverrmcp.shared.contextr mcp.typesrrrrrrrrrr r!r"r#rr$ MCPPromptr% MCPResourcepydantic.networksr&starlette.requestsr'typing_extensionsr(fastmcp.server.dependenciesrjr)fastmcp.server.elicitationr*r+r,r-r.fastmcp.server.serverr/fastmcp.utilities.loggingr0r1fastmcp.utilities.typesr2rGr5rLgetChildr8r;r>LockrCr@r9INFOWARNINGERRORCRITICALrVr^rXrrrFrNrOrws" 88%)!;; +A2-    C)-$&%"*?:**!??+?>&> %9 C/9)T/R,Rjjl  ++ +]] LLll ]]    !! && M M  M `& @& & Z#%)      #   rN