Execute the one code block on `page` that contains `needle`.

Synthesize a TextResource for a prefab tool. Returns None if prefab_ui isn't installed.

Build the SEP-2549 response cache from the `cache=` argument. Response caching is opt-in: `None` (the default) and `False` both leave it

Build Azure authorization URL with prefixed scopes. Overrides parent to prefix scopes with identifier_uri before sending to Azure, wh

An SDK MCPServer whose tools/list carries a positive ttlMs hint at 2026.

Calculate delay for the given attempt number.

Helper method to call a tool with the provided arguments.

Call through a client that does not enforce the schema itself.

SHA256 hash of sorted tool searchable text for staleness detection.

Build shared scope and resource metadata challenge parameters.

Remove all entries whose TTL has elapsed.

Remove expired JTIs from cache.

Collect a full snapshot of system stats.

Establish or reuse a session connection. This method implements the reentrant context manager pattern: - First call: Creates

Present a dead session the same way wherever it is noticed. A failed session surfaces from two places: `_connect`, when the connection never

True when `InputRequiredResult` appears anywhere in *tp*. Recurses through `TypeAliasType`, `Annotated`, and unions so a guard arm is found e

Serialize a single content block to a JSON-safe dict.

Convert OpenAPI nullable field to JSON Schema type array.

Convert MCP ToolChoice to Google GenAI ToolConfig.

Convert MCP tools to Anthropic tool format.

Return the key used for HMAC-signing consent cookies. Uses the upstream client secret when available, falling back to the JWT signing

Return a deep copy of a JSON schema without recursing. `copy.deepcopy` consumes stack frames in proportion to nesting depth, so a deeply nest

Create HTTP Basic Auth header value from client credentials.

Create dataclass from object schema.

Build the per-user session for the current principal, or `None` if unauth. Resolves the store through `get_server()` rather than `get_context()`:

Decode a JWT part (header or payload) without signature verification. Args: token: JWT token string (header.payload.signature) pa

Decode and verify a signed base64-encoded JSON list from cookie. Returns [] if missing/invalid.

Convert dict enum to SEP-1330 compliant schema pattern. Args: enum_dict: {"low": {"title": "Low Priority"}, "medium": {"title": "Medium P

Resolve a ``discriminator.mapping`` value to a local schema name. Mapping values hold "schema names or references", so a bare ``"Cat"`` means

Shared dispatch logic for @app.tool() and @app.ui() calling patterns.

Delegate to the inherited auth flow, flagging step-up challenges. On a 403 ``insufficient_scope`` the inherited flow unions the challenged scope

Poll `tasks/get` until the task reaches a terminal state. `working` sleeps and polls again; `input_required` answers the outstanding requests

Dump without the `resultType` discriminator the draft schema omits. `resultType` is required by the protocol's result union but forbidden by the

Encode values to base64 and sign with HMAC. Returns: signed cookie value (payload.signature)

Evaluate a single auth check, masking unexpected failures as denial. An ``AuthorizationError`` is the check's deliberate denial and propagates.

Pull `_meta[clientCapabilities][extensions][identifier]` from a lifted meta block.

Extract all schema names referenced by a schema (including transitive dependencies). Args: schema: The schema to analyze

Extract upstream claims to embed in FastMCP JWT. Override this method to decode upstream tokens, call userinfo endpoints, or otherwis

Format a host for inclusion in a URL, bracketing IPv6 addresses. A bare IPv6 address like ``::1`` must be wrapped in brackets when placed bef

Get a string representation of the arguments.

Extract the first candidate from a response.

Gets a client instance by calling the sync or async factory.

Get raw image data as base64-encoded string.

Get the auth-filtered tool catalog, excluding pinned tools.

Quick check if schema has any readOnly properties.

Check if a schema contains any $ref.

Quick check if schema has any writeOnly properties.

Build a minimal Starlette HTTP request carrying the given headers.

Create a session with the given token and return its session id.

Inject the MCP message log panel before </body>.

Parse a completed task's inlined result dict into a `CallToolResult`.

The active request's multi-round-trip fields (SEP-2322), if any. Reads the raw params of the active wire request through the SDK's pe

True when *tp* is the `InputRequiredResult` type (SEP-2322). Resolves a `TypeAliasType` and peels an `Annotated` wrapper first, so an aliased

Check if a schema represents a simple (non-complex) type.

The surfaced key whose parked request asks *message*.

Return all available prompts. Override to provide prompts dynamically. Returns ALL versions of all prompts. The server handles dedupl

Return all available resource templates. Override to provide resource templates dynamically. Returns ALL versions. The server handles

Return all available resources. Override to provide resources dynamically. Returns ALL versions of all resources. The server handles

List all resources from the remote server.

Return all available tools. Override to provide tools dynamically. Returns ALL versions of all tools. The server handles deduplicatio

Derive the per-session key used for logging/setLevel gating. v2 constructs sessions per-request, so the stable identity is the connection ses

Create the call_tool proxy that executes discovered tools.

Create a stable key for consent tracking from client_id and redirect_uri.

Create the get_prompt tool.

Create the list_prompts tool.

Create the list_resources tool.

Create the read_resource tool.

Wrap a proxy handler to restore request_ctx before delegating.

Create the search tool. Subclasses define the parameter schema.

Check if the tool matches the cache settings for tool calls.

Merge two schemas, with the override schema taking precedence. Args: base_schema: Base schema to start with override_