Forward to parent tool with argument transformation applied. This function can only be called from within a transformed tool's custom functio

Load configuration from JSON file.

Generate a Cursor deeplink for installing the MCP server. Args: server_name: Name of the server server_config: Server configurati

Fetch CIMD document and create synthetic OAuth client. Args: client_id_url: HTTPS URL pointing to CIMD document Returns:

Extract FastMCP metadata from a function, handling bound methods and wrappers.

Get prompt by transformed name with all transforms applied. Note: This method does NOT filter disabled components. The Server (FastMC

Get a resource template by URI, filtering disabled templates. Overrides Provider.get_resource_template() to add visibility filtering after

Get the current FastMCP server instance directly. In a background-task worker, checks the task-server map first so that mounted-child tasks r

Get the current task context if running inside a background task worker. This function extracts task information from the Docket execution contex

Get the FastMCP tracer for creating spans. Args: version: Optional version string for the instrumentation Returns: A tracer

Inject current trace context into a meta dict for MCP request propagation. Args: meta: Optional existing meta dict to merge with trace co

Install FastMCP server in Goose via deeplink. Args: file: Path to the server file. server_object: Optional server object name (fo

List all available skills from an MCP server. Discovers skills by finding resources with URIs matching the `skill://{name}/SKILL.md` pattern.

Send a tools/list request and return the complete MCP protocol result. Args: cursor: Optional pagination cursor from a previous r

Normalize a timeout value to seconds (float). Args: value: Timeout value as int/float (seconds), timedelta, or None. Zero val

Process common arguments shared by all install commands. Handles both fastmcp.json config files and traditional file.py:object syntax.

Reset transport to previous value.

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

Propagate MCP path to the server and all verifiers.

Update the progress status message.

Set the current transport type. Returns token for reset.

Convert to MCP resource contents type. Args: uri: The URI of the resource (required by MCP types) Returns: T

Update the default scopes advertised to clients and used for DCR/CIMD fallback. Use this method when the available scope set is determined af

Validate URL for SSRF and resolve to IPs. Args: url: URL to validate require_path: If True, require non-root path (for CIMD)

Verify a Hugging Face OAuth token using the userinfo endpoint.

Initialize a Stdio transport. Args: command: The command to run (e.g., "python", "node", "uvx") args: The ar

Return the exact decoded byte-length of a base64 string without decoding it.

Validate that client context is still active. Raises: RuntimeError: If accessed outside client context (unless immediate)

Derive a human-friendly name from a server spec.

Fetch the latest version from PyPI. Args: include_prereleases: If True, include pre-release versions (alpha, beta, rc). Returns:

Return a stable, hashed identifier for the current access token. Cache entries are partitioned by access token so that responses filtered by

Load visibility rule dicts from session state.

Generate a deterministic hash for schema caching. Handles non-JSON-native types (datetime, date, bool keys) that can appear in schemas loaded

Hash a token for secure storage lookup. Uses SHA-256 to create a one-way hash. The original token cannot be recovered from the hash, providin

Log error with appropriate detail level.

Create an UpstreamTokenSet with optional id_token.

Normalize editor-specific server config fields to MCPConfig format. Handles two known differences: - Claude Code uses ``type`` where MCPConfi

Parse environment variable string in format KEY=VALUE.

Convert model preferences to ModelPreferences object.

Set up a proxy JWT pointing at an expired upstream token. Returns the proxy JWT (access token) that can be passed to load_access_toke

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

Apply runtime settings like environment variables and working directory. Args: config_path: Path to config file for resolving rel

Build regex pattern for URI template, handling RFC 6570 syntax. Supports: - `{var}` - simple path parameter - `{var*}` - wildcard path pa

Call multiple tools registered on this MCP server in a single request. Each call can be for a different tool and can include differe

Decode JWT payload without signature verification. Use only for tokens received directly from trusted sources (e.g., IdP token endpoints). A

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

Find a fastmcp.json file in the specified directory. Args: start_path: Directory to look in (defaults to current directory)

Get all recorded calls for a specific method or hook. Args: method: The method to filter by (e.g. "tools/list")

Get client information by ID. This is generally the random ID provided to the DCR client during registration, not the upstream client ID.

Return HTTP headers from an ambient server request, when available. The standalone client package has no server request context. When the full

Get the manifest for a specific skill. Args: client: Connected FastMCP client skill_name: Name of the skill Returns:

Extract information from a FastMCP v1.x instance using a Client. Args: mcp: The FastMCP v1.x instance to inspect Returns: Fa

Install FastMCP server in Cursor. Args: file: Path to the server file server_object: Optional server object name (for :object suf

Check if cls is a subclass of base, even if cls is a type variable.

Issue a minimal FastMCP refresh token. FastMCP refresh tokens are reference tokens containing only the minimal claims needed for vali

Retrieve all tools available on the server. This method automatically fetches all pages if the server paginates results, returning th

Start ping task on first message from a session.

Parse ``<HASH_LENGTH hex>_<rest>`` → ``(hash, local_tool_name)`` or None.

Prepare environment and source for execution. When output_dir is provided, creates a persistent uv project. When output_dir is None,

Raise ImportError with install instructions if docket not available. Args: feature: Description of what requires docket (e.g., "`task=Tru

Require scopes when the accessed component has a specific tag.

Search for available tools by query. Returns matching tools ranked by relevance.

Serialize a resolved transport to a Python expression string. Returns ``(expression, extra_imports)`` where *extra_imports* is a set of impor

Start the mock OAuth server.

Fill in missing boolean fields with their model defaults. HTML checkboxes omit the field entirely when unchecked, so the submitted data dict

Shell-split a command string into a ``StdioTransport``.

Build a minimal ~/.claude.json structure.

Collect successful list results, logging any exceptions. Emits a warning when the same MCP identity is returned by more than one prov

Construct a provider with mocked discovery, returning the timeout used.

Convert MCP tool_choice to Anthropic format. Returns None for "none" mode, signaling that tools should be omitted from the request en

Helper to create a test RemoteAuthProvider with StaticTokenVerifier.

Disconnect from session using reference counting. This method implements proper cleanup for reentrant context managers: - De

Lazily register tools and resources on first access.

Extract scopes from JWT claims. Supports both 'scope' and 'scp' claims. Checks the `scope` claim first (standard OAuth2 clai

Extract an AzureProvider from an auth provider, unwrapping MultiAuth if needed.

Build the Starlette dev server application.

Create a CallTool resolver that prefixes tool names with a hash. Structurally identical to the old ``___`` resolver — ``app_name`` is the Fas

Parse an mcp.types.CallToolResult into our CallToolResult dataclass. Args: name: Tool name (for schema lookup) result: Raw MCP pr

Prepare scopes for Azure authorization code exchange. Azure requires scopes during token exchange (AADSTS28003 error if missing). Azu

Return the snapshot bound for ``task_id`` in the current context. Returns ``None`` if nothing is bound, or if the bound entry belongs to a di

Resolves a reference to its target definition.

Escape rich markup and encode control chars for terminal-safe output.

Walk up from *start_dir* looking for ``.cursor/mcp.json``.

Scan Gemini CLI settings for MCP servers. Checks both user-level ``~/.gemini/settings.json`` and project-level ``.gemini/settings.json``.

Convert schema to appropriate Python type.