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

Check if a client_id looks like a CIMD URL. CIMD URLs must be HTTPS with a host and non-root path.

Check if an IP address is allowed (must be globally routable unicast). Uses ip.is_global which catches: - Private (10.x, 172.16-31.x, 192.168

Set `fastmcp.settings.telemetry_mode` for the duration of a test.

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

Read the resource content. Subclasses implement this to return resource data. Supported return types: - str: Text content

Resolve a server name (or ``source:name``) to a transport. Raises :class:`ValueError` when the name is not found or is ambiguous.

Set the total/target value for progress tracking.

Validate an OIDC configuration against the source dict.

Create a wrapper function without injected parameters. Returns a wrapper that excludes Context and Docket dependency parameters, making it sa

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

Combines parameter and request body schemas into a single schema. Handles parameter name collisions by adding location suffixes. This is

Return secure cookie name for HTTPS, fallback for HTTP development.

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 all additional HTTP routes including from mounted servers. Collects custom HTTP routes registered via ``@server.custom_route()``

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

Check if a JSON schema represents an object type.

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.

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.

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

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

Create a FastMCP server from an OpenAPI specification. Args: openapi_spec: OpenAPI schema as a dictionary cl

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.

Sign in to Prefect Horizon.

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

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.

Start the mock OAuth server.

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

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

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: