Set visibility state in component metadata if rule matches. Returns a copy of the component with updated metadata to avoid mutating s

Fetch and validate a CIMD document with SSRF protection. Uses ssrf_safe_fetch_response for the HTTP layer, which provides: - HTTPS on

Set the MCP endpoint path and create JWTIssuer with correct audience. This method is called by get_routes() to configure the resource URL

Convert the FastMCP tool to an MCP tool.

Find an available port by letting the OS assign one.

Parse MCP configuration from dictionary format.

Check if a callable is a coroutine function, unwrapping functools.partial. ``inspect.iscoroutinefunction`` returns ``False`` for ``functools.

Issue a minimal FastMCP access token. FastMCP tokens are reference tokens containing only the minimal claims needed for validation an

Set a value in the state store. By default, values are stored in the session-scoped state store and persist across requests within th

Coerce a string CLI value according to a JSON-Schema type hint.

Resolve all $ref references in a JSON schema by inlining definitions. This function resolves $ref references that point to $defs, replacing them

Check if this component supports task execution.

Check if this environment config requires uv to set up. Returns: True if any environment settings require uv run

Add a tool to this app programmatically. The tool is tagged with this app's name for routing.

Assert that a hook was called a specific number of times.

Assert that a hook was not called.

Create a SamplingTool from a FunctionTool or TransformedTool. Reuses existing server tools in sampling contexts. For TransformedTool,

Create a SamplingTool from a function. The function's signature is analyzed to generate a JSON schema for the tool's parameters. Type

Get the current FastMCP Context instance directly.

Get a value from the state store. Checks request-scoped state first (set with ``serializable=False``), then falls back to the session

Check if cls is a member of base, even if cls is a type variable. Base can be a type, a UnionType, or an Annotated type. Generic types are n

Construct the lookup key for this component type. Args: identifier: The raw identifier (name for tools/prompts, uri for resources

List all available tools, in the format expected by the low-level MCP server. Supports pagination when list_page_size is configured.

Generate the source for a single ``@call_tool_app.command`` function.

Get the schema for an elicitation response. Args: response_type: The type of the response

Clear all recorded notifications.

Return the Redis key prefix that owns a given scope. Authenticated tasks live under ``fastmcp:task:auth:{enc_scope}``; anonymous tasks live u

Validate that a redirect_uri is allowed by the CIMD document. Uses component-level matching (scheme, host, port, path) which correctly

Validate redirect URI against proxy patterns and optionally CIMD redirect_uris. For CIMD clients: validates against BOTH the CIMD document's

Expand a URI template with parameters — inverse of `match_uri_template`. Supports the same RFC 6570 subset: - Path params: `{var}`, `{var*}`

Create an AzureProvider pre-configured for Azure AD B2C. Derives authority host, tenant path, and identifier URI from `tenant_name` a

Serialize to JSON for Redis storage.

Verify token using custom validation logic. Args: token: The token string to validate Returns: AccessToken i

Get the current Docket instance managed by FastMCP. This dependency provides access to the Docket instance that FastMCP automatically creates

Extract the primary MIME type from an HTTPRoute's response definitions. Looks for the first successful response (2xx) and returns its content typ

Get auth context for the current request. Returns a tuple of (skip_auth, token) where: - skip_auth=True means auth checks should be skipped (

Return the SHA-256 hex digest of *token*.

Extract a string result from a ToolResult. String results are wrapped in ``{"result": "..."}`` by the structured-output convention.

Add a prompt to the server. Args: prompt: A Prompt instance or @prompt-decorated function to add Returns: Th

Helper to create a FastMCP server with OpenAPIProvider.

Generate a SKILL.md file for a generated CLI script.

Validate a JWT bearer token and return an AccessToken when the token is valid. Parameters: token (str): The JWT bearer t

Parse Docket task key to extract metadata. Args: task_key: Encoded task key from Docket Returns: Dict with keys: ``task_scop

Run the FastMCP server asynchronously. Args: transport: Transport protocol to use ("stdio", "http", "sse", or "streamable-http")

Convert a result to a sequence of content objects.

Return True if the resolved target will use an HTTP-based transport. MCPConfig dicts are excluded because ``MCPConfigTransport`` manages indi

Check if this transform applies to the component. All specified criteria must match (intersection semantics). An empty rule (no crite

Prepare scopes for Azure token refresh. Azure requires fully-qualified scopes and only allows ONE resource per token request (AADSTS2

Replace openapi $ref with jsonschema $defs recursively. Examples: - {"type": "object", "properties": {"$ref": "#/components/schemas/..."

Create a TransformedTool from a provided tool and this transformation configuration.

Assert that a hook was called a specific number of times.

Generate a CIMD document for hosting. Create a Client ID Metadata Document that you can host at an HTTPS URL. The URL where you host this doc

Extract all MCP components from a module. Scans all module attributes for instances of Tool, Resource, ResourceTemplate, or Prompt objects cr

Generate a standalone CLI script from an MCP server. Connects to the server, reads its tools/resources/prompts, and writes a Python script th

Get log lines from a caplog fixture.

Delegate well-known route creation to the server. This ensures that server-specific well-known route logic (e.g., OAuthProvider's RFC

Check if the client is currently connected.

The globally unique lookup key for this resource.

Build a tool-call argument dict from CLI inputs. A single JSON object argument is treated as the full argument dict. ``--input-json`` provide

Verify a Google OAuth token using the tokeninfo endpoint. Calls ``https://oauth2.googleapis.com/tokeninfo?access_token=TOKEN`` to val

Convert a JSON Schema to a Python type annotation. Returns (type_annotation, needs_json_parsing).

Build Docket task key with embedded metadata. When ``task_scope`` is ``None`` the task is anonymous and lives in the ``anon`` keyspace. Othe

Send a tools/call request and return the complete MCP protocol result. This method returns the raw CallToolResult object, which includes an i

Enable components matching criteria for this session only. Session rules override global transforms. Rules accumulate - each call add

Deterministic hex hash for a tool in an app. Same inputs on every replica produce the same output.

Load a FastMCP configuration from a fastmcp.json file. Args: config_path: Path to fastmcp.json file Returns: MCPServerConfig

Read the resource by calling the wrapped function.

Validate a redirect URI against allowed patterns. Args: redirect_uri: The redirect URI to validate allowed_patterns: List of allo

Temporarily replace sys.argv if args provided. This context manager is used at the CLI boundary to inject server arguments when needed, witho

Bind this OAuth provider to a specific MCP server URL. Called automatically when mcp_url is provided to __init__, or by the transport

Get the actual resource URL being protected. Uses ``resource_base_url`` if set; otherwise falls back to ``base_url``. Args:

Parse an mcpServers-style JSON file into discovered servers.

Register client and start auth; returns (txn_id, consent_url).

Add a resource to the server. Args: resource: A Resource instance or @resource-decorated function to add Returns:

Convert an AppConfig or dict to the wire-format dict for ``meta["ui"]``.

Call a tool, read a resource, or get a prompt on an MCP server. By default the target is treated as a tool name. If the target contains ``://

Create a CLIENT span with standard MCP attributes. Automatically records any exception on the span and sets error status.

Convert a raw result to ToolResult. Handles ToolResult passthrough and converts raw values using the tool's attributes (serializer, o

Create a styled HTML response for OAuth callbacks.

Download a skill and all its files to a local directory. Creates a subdirectory named after the skill containing all files. Args: cl

Execute tool calls using Python code.

List prompts with all transforms applied. Components may be marked as disabled but are NOT filtered here.

List resources with all transforms applied. Components may be marked as disabled but are NOT filtered here.

Load and return the FastMCP server instance. Must be called after prepare() if the source requires preparation. All information neede

Attempt to open a Cursor deeplink URL using the system's default handler. Args: deeplink: The deeplink URL to open Returns:

Convert tools to SamplingTool objects. Accepts SamplingTool instances, FunctionTool instances, TransformedTool instances, or plain callable f

Send a resources/read request and return the complete MCP protocol result. Args: uri (AnyUrl | str): The URI of the resource to r