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

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

Get task-eligible components with all transforms applied. Overrides AggregateProvider.get_tasks() to apply server-level transforms af

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.

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

Replay events that occurred after the specified event ID. Args: last_event_id: The ID of the last event the client received

Reset transport to previous value.

The `"result"` field of a direct `Tool.run()` call's structured content. `structured_content` is `dict | None` on `ToolResult` (a bare function t

Send a logging/setLevel request. Handshake-era servers only. `logging/setLevel` asks the server to remember a level for the rest of t

Update the progress status message.

Set the current transport type. Returns token for reset.

Suppress FastMCP's own spans without disabling trace propagation. Scoped equivalent of `telemetry_mode="propagation_only"`, for callers that

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

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.

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

Derive a human-friendly name from a server spec.

Whether a session record exists for this `(principal, session_id)`. True only once `create_session` has written the creation marker. A raw

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

Read the session's full stored dict, or `None` when the key is unset.

Log error with appropriate detail level.

Make a cache key for a tool call using name, version, and arguments.

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.

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

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).

Text from CallToolResult.content blocks (TextContent).

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

Run a tool sync and as a task; assert the inlined results are identical.

HTTPX auth flow with automatic retry on stale cached credentials. If the OAuth flow fails due to invalid/stale client credentials, cl

Server whose cart tools inject a per-user `session: UserSession`.

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

Call a sync function in a threadpool to avoid blocking the event loop. Uses anyio.to_thread.run_sync which properly propagates contextvars, m

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

Check whether the connected client supports a given MCP extension. Inspects the ``extensions`` capability on ``ClientCapabilities`` sent by the

Configure logging for FastMCP. Args: logger: the logger to configure level: the log level to use rich_kwargs: the pa

Create an OAuth callback server. Args: port: The port to run the server on callback_path: The path to listen for OAuth redir

The authenticated principal for the current request as a compact JSON string. Returns the `(client_id, issuer, subject)` triple encoded as compac

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.

Get a resource by URI, filtering disabled resources. Overrides Provider.get_resource() to add visibility filtering after all transfor

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

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. Instrumentation is on by default. FastMCP uses only the OpenTelemetry API, so span creation is a n

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

Whether FastMCP should create its own spans right now.

Create a new client instance with the same configuration but fresh session state. This creates a new client with the same transport, handlers

Validate and normalize a Horizon API origin.

Coerce a handler's return value into a wire ``Completion``. A returned ``str`` is rejected: it is almost always a mistake (the value would it

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.

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

Names of a function's parameters annotated with `SessionId`. Scans resolved type hints for `Annotated[str, _SessionIdMarker()]` metadata. Ret

The single storage key holding a session's state dict. Keyed by `(principal, session_id)`: the principal is the isolation wall, the id organi

Translate a FastMCP exception into a wire-format ``MCPError``. Central mapping from FastMCP's public exception types to the JSON-RPC error co

Verify a bearer token and return access info if valid. This method implements the TokenVerifier protocol by delegating to ou