Check whether any definitions in ``$defs`` form a reference cycle. A cycle means a definition directly or transitively references itself (e.g

Return a copy of the template with dereferenced schemas.

Return a copy of the tool with dereferenced schemas.

Determine the FastMCP component type based on the route and mappings.

Builds a chain of handlers for a given message.

Manage Docket instance and Worker for background task execution. Docket is process-level, not server-level: only the first server in a

Root-only Docket lifecycle. See _docket_lifespan for the dispatch.

Send an elicitation request from a background task (SEP-1686). This method handles elicitation when running in a Docket worker context,

Return IPv4 addresses embedded in known IPv6 transition forms.

Ensure there is room for at least one new entry.

Clone the openapi-directory repo if not already present at the pinned commit. Safe under pytest-xdist: a file lock serializes the rmtree/reclone

Enters the server's lifespan context for FastMCP servers and does nothing for FastMCP 1 servers.

Validate arguments and execute the tool body. Argument validation runs first and raises a bare ``pydantic.ValidationError`` on bad in

Extract only the schema definitions needed for input (parameters and request body). Args: parameters: Route parameters

Extract only the schema definitions needed for outputs (responses). Args: responses: Route responses all_sch

Extract and resolve parameters from operation and path item.

Extract public key from inline JWKS. Args: token: JWT token to extract kid from jwks: JWKS document containing keys

Extract and resolve request body information.

Extract and resolve response information. Only includes the primary success response for MCP tools.

Pull all schema definitions out of an OpenAPI spec.

Extract scopes from introspection response. RFC 7662 allows scopes to be returned as either: - A space-separated string in t

Async wrapper around _fetch_app_bridge_bundle_sync.

Fetch JWKS data, using SSRF-safe or standard fetch based on config.

Remove readOnly and/or writeOnly properties from schema.

Build a final_response tool-use reply.

Find Python code examples in .mdx files. pytest-examples only supports ``.md``; we call its internal ``_extract_code_chunks`` directly so ``.

Find the root of the package containing this file. Walks up the directory tree until we find a directory without __init__.py, but never above

Find the server object in the module. Args: module: The imported Python module file_path: Path to the file (for error

Find a tool by name from a pre-fetched list.

Format inputSchema properties as a compact signature.

Format inputSchema properties as a compact signature.

Format inputSchema properties as a compact signature.

Format PromptResult for tool output. Returns JSON with the messages array. Preserves embedded resources as structured JSON objects.

Format ResourceResult for tool output. Single text content is returned as-is. Single binary content is base64-encoded. Multiple contents are

Format a JSON schema for display in help text.

Check if function accepts **kwargs. This determines whether a custom function can accept arbitrary keyword arguments, which affects h

Generate a default name from the route.

Generate JSON manifest for the skill.

Generate PKCE code verifier and challenge pair. Returns: Tuple of (code_verifier, code_challenge) using S256 method

Geocode an address using OpenStreetMap Nominatim (free, no key).

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

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

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

Get client identifier for rate limiting.

Get the identity (type, name/uri) for a component. Returns: A tuple of (component_type, logical_name) where logical_name is

Expand environment variables and user home in path.

Read the FastMCPApp name from a tool's metadata, if present.

Get the appropriate type handler for the schema.

Get MIME type from format or guess from file extension.

Get MIME type from format or guess from file extension.

Get MIME type from format or guess from file extension.

Get parent trace context from request meta for distributed tracing.

Get the primary success response for an MCP tool. We only need one success response.

Get a specific prompt by name. Default implementation filters _list_prompts() and picks the highest version matching the spec.

Get a prompt for background execution (SEP-1686). Returns a PromptTask object that handles both background and immediate execution.

Get a specific resource by URI. Default implementation filters _list_resources() and returns highest version matching the spec.

Get a resource template that matches the given URI. Default implementation lists all templates, finds those whose pattern matches the

Extract the value from a CallToolResult (structured or text).

Extract the value from a CallToolResult (structured or text).

Extract the value from a CallToolResult (structured or text).

Lazily create the Pyodide sandbox.

Get a tool by name via aggregation from providers. Extends AggregateProvider._get_tool() with component-level auth checks. Args:

Get the Prefab peer-reference resolver bound to an app name.

Get the verification key for the token.

Get the token string to pass to the token verifier. Returns the upstream access token by default. Subclasses can override to verify a

Handle a prompt get within an open client session.

Handle a resource read within an open client session.

Process incoming notifications/tasks/status (internal). Called by Client when a notification is received for this task. Updates cache

Route task status notification to appropriate Task object. Called when notifications/tasks/status is received from server. Updates Ta

Handle a tool call within an open client session.

Return True if a URI path contains `.` or `..` segments. Browsers collapse dot-segments when resolving a 302 Location per RFC 3986 §5.2.4. Al

Return True when response includes cache freshness directives.

Check if a FunctionTool's return type annotation is a prefab type.

Return True if the tool has a UI resourceUri in its metadata.

Return True when CLONE_DIR is already checked out at the pinned commit.

Import a Python module from a file path. Args: file_path: Path to the Python file Returns: The imported modu

Interpolate environment variables in a string. Replaces ${VAR_NAME} with the value of VAR_NAME from the environment. If the variable

Call a serializer and await the result if it returns a coroutine.

Check if a host is a loopback address. Per RFC 8252 §7.3, loopback addresses include localhost, 127.0.0.1, and ::1.

Check whether *path* looks like a clone of the openapi-directory repo.

Check if a directory is a Python package (has __init__.py).

Check if *tp* is or contains a prefab type, recursing through unions and Annotated.

Check if an exception indicates a rate limit error from GitHub API. Args: excinfo: The exception info from pytest report: Optiona