Merge defaults with provided data at all levels.

List all available tools. Supports pagination via params.cursor.

Convert a JSON Schema property name to its CLI flag form. Replicates cyclopts' default_name_transform: camelCase → snake_case, lowercase, und

Server entry point for resource reads. The server calls this method instead of ``read()`` directly so that subclasses can customize d

Convert a display name to a URL-safe identifier. Lowercases, replaces non-alphanumeric runs with hyphens, and strips leading/trailing hyphens

Sanitize a string into a valid Python identifier.

Extract the logical return value from a ToolResult.

Acquire the reload lock, reload if needed, then run *coro_fn*. Holding the lock across both the reload and the read prevents concurre

Apply session-specific visibility transforms to components. This helper applies session-level enable/disable rules by marking components with

Build an OAuth proxy mounted at BASE_URL, optionally with a distinct issuer.

Recursively discover all Python files under a directory. Excludes __init__.py files (they're for package structure, not components). Args:

Extract trace context from an MCP request meta dict. If already in a valid trace (e.g., from HTTP propagation), the existing trace context is

Look up an app-visible tool by original name, bypassing transforms. Searches for a tool named ``tool_name`` tagged with the given app

Get or create an authenticated ATProto client.

Extract FastMCP metadata from a component's meta dict. Handles both the current `fastmcp` namespace and the legacy `_fastmcp` namespace for c

Get a cached or new OnBehalfOfCredential for OBO token exchange. Credentials are cached by user assertion so the Azure SDK's internal

Get OAuth routes with custom handlers for better error UX. This method creates standard OAuth routes and replaces: - /authorize endpo

Resolve and validate a `Session` for an explicit `session_id`. Pair with a `session_id: SessionId` tool argument (the agent obtains an id fro

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

Check if a compatible pydocket (>= 0.19.0) is installed and importable. Three things have to be true for fastmcp's task features to work: 1

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

List resource templates 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.

List tools with all transforms applied. Applies transforms sequentially: base → transforms (in order). Each transform receives the re

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

Load server from filesystem.

Paginate a sequence of items. Args: items: The full sequence to paginate. cursor: Optional cursor from a previous request. None f

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

Read the file content.

Registers all methods marked with @mcp_tool with the FastMCP server. Args: mcp_server: The FastMCP server instance to register to

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

Run the server using HTTP transport. Args: transport: Transport protocol to use - "http" (default), "streamable-http", or "sse"

Send a notification to the client immediately. Args: notification: An MCP notification instance (e.g., ToolListChangedNotificatio

Serialize tools to compact markdown, using ~65-70% fewer tokens than JSON.

Transform injected-by-type params into Dependency-defaulted params. Transforms ALL params typed as Context (into ``= CurrentContext()``) and as

Call the `tasks/update` handler within the given auth scope.

Validate that a JSON schema follows MCP elicitation requirements. This ensures the schema is compatible with MCP elicitation requirements: -

Verify GitHub OAuth token by calling GitHub API.

Verify a bearer token using OAuth 2.0 Token Introspection (RFC 7662). This method makes a POST request to the introspection endpoint

Add a component to unified storage. Args: component: The component to add. Returns: The component that was a

Build a ``Client`` from a resolved server spec. Applies ``auth='oauth'`` automatically for HTTP-based targets unless the caller explicitly pa

Build a uvx command for running a FastMCP server. Goose requires uvx (not uv run) as the command. The uvx format is: uvx [--with pkg] [--

Run the interior middleware chain for a component operation. This is the dispatch site for the component methods (``tools/call``, ``t

The accepted value of *field* from the elicitation answered under *key*.

A dual-era backend for the mirroring tests. Hosts the three-round guard tool (``book_flight``), a tool that reports the protocol version its

Get the correct npx command for the current platform.

Get the token to verify from the upstream token set. When verify_id_token is enabled, returns the id_token from the upstream token re

Return a new schema with *param* removed from `properties`, `required`, and (if no longer referenced) `$defs`.

Convert MCP content to Google GenAI Part.

Scan ``~/.claude.json`` for global and project-scoped MCP servers.

Return a human-readable type label for a property schema.

Helper method to time any operation.

Start OAuth transaction and route through consent interstitial. Flow: 1. Validate client's resource matches server's resource URL (se

Build the per-method `CacheHint` map for the SDK low-level server. `cache_ttl` is in seconds and is converted to the wire's milliseconds. When

Server whose cart tools take an explicit `session_id: SessionId`.

Combine multiple lifespans into a single lifespan. Useful when mounting FastMCP into FastAPI and you need to run both your app's lifespan and

Create a test JWT token.

Helper to create a FastMCP server with OpenAPIProvider.

Create an INTERNAL span for provider delegation. Used by FastMCPProvider when delegating to mounted servers. Automatically records any except

Derive JWT signing key from a high-entropy key material and server salt.

Parse an x-www-form-urlencoded request body into a dict.

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

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.

Start the mock OAuth server.

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.