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

Parse an ``mcpServers``-style dict into discovered servers.

Read the consent binding map from the signed cookie. Returns a dict of {txn_id: consent_token} for all pending flows.

Handle MCP 'readResource' requests. Extracts task metadata from MCP request context and passes it explicitly to read_resource(). The

Render tools at the requested detail level. The same detail value produces the same output format regardless of which discovery tool calls th

Scan the Claude Desktop config file.

Check for ``mcp.json`` in *start_dir*.

Install an auth context for a given client_id/sub. Returns the reset token.

Sign a cookie payload with HMAC-SHA256. Returns: base64(payload).base64(signature)

Submit a background task and return its server-assigned task id.

Build a real Tool component (a FastMCPComponent) with a version.

Apply namespace to a URI: protocol://path → protocol://namespace/path.

Translate IdP-returned scopes into the client-facing form. Some IdPs (notably Azure) require scopes on the wire in a form that differ

Return True when id_token verification is enabled. This ensures ``load_access_token`` always patches the validated result with upstre

Validate a stored transaction redirect URI before sending a browser to it.

Verify and extract payload from signed cookie. Returns: payload if signature valid, None otherwise

Wait until task reaches a terminal state (completed, failed, cancelled). Unlike wait(), this will not return on input_required — it continues

Filter for files that should trigger reload.

Constructs a final httpx.Request object, handling all OpenAPI serialization. Args: route: HTTPRoute containing OpenAPI o

Handle OAuth callback and return (auth_code, state).

Send a cancellation notification for an in-progress request.

Check if Docket is configured with a distributed backend. The CLI worker runs as a separate process, so it needs Redis/Valkey to coordinate w

Validate client arguments against their declared parameter types. The synchronous ``run()`` path validates arguments through the func

Create a FastMCP server from a MCPConfig.

Helper to create a FastMCP server with OpenAPIProvider.

Helper to create a FastMCP server with OpenAPIProvider.

Create a FastMCP server with tools, resources, and prompts.

Create a FastMCP server with tools, resources, and prompts.

Exchange FastMCP refresh token for new FastMCP access token. Implements two-tier refresh: 1. Verify FastMCP refresh token 2.

Forward directly to parent tool without transformation. This function bypasses all argument transformation and validation, calling the parent

Load configuration from a JSON file. Args: file_path: Path to the configuration file Returns: MCPServerConfi

Gets the OIDC configuration for the specified configuration URL. Args: config_url: The OIDC configuration URL strict:

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

Return the SEP-1686 task capabilities. Returns task capabilities as a first-class ServerCapabilities field, declaring support for list, cance

Return components eligible for background task execution. Returns components that have task_config.mode != 'forbidden'. This includes

Get tool by transformed name.

Load visibility rule dicts from session state.

Generate the stdio command for running a FastMCP server. Args: file: Path to the server file server_object: Optional server objec

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

Send a resources/listResourceTemplates request and return the complete MCP protocol result. Args: cursor: Optional pagination cur

Retrieve all resources available on the server. This method automatically fetches all pages if the server paginates results, returnin

Send a resources/list request and return the complete MCP protocol result. Args: cursor: Optional pagination cursor from a previo

List the roots available to the server, as indicated by the client.

List background tasks. Sends a 'tasks/list' MCP protocol request to the server. If the server returns an empty list (indicating clien

Mark tools by visibility state.

Handle errors for all messages.

Apply sliding window rate limiting to requests.

Interpret the --verify value as a boolean toggle or a CA bundle path.

Parse a version string into a sortable key. Args: version: The version string, or None for unversioned. Returns: A VersionKe

Clear all recorded calls.

Resolve task config, defaulting None to False.

Return the appropriate MIME type for a resource URI. For ``ui://`` scheme resources, defaults to ``UI_MIME_TYPE`` when no explicit MIME type

Run the server using stdio transport. Args: show_banner: Whether to display the server banner log_level: Log level fo

Save visibility rule dicts to session state and send notifications. Args: context: The context to save rules for. rules: The visi

Convert the prompt to an MCP prompt.

Convert the resource template to an SDKResourceTemplate.

Validate get_oidc_configuration call.

Verify and decode a FastMCP token. Validates JWT signature, expiration, issuer, audience, and token type. Args: token: J

Verify token using the configured token verifier.

Get a sort key for a component based on its version. Use with sorted() or max() to order components by version. The key is a `(VersionKey, r

Write configuration to JSON file.

Get a specific claim from the access token. This dependency extracts a single claim value from the current access token. It's useful for gett

Initialize WorkOS OAuth provider. Args: client_id: WorkOS client ID client_secret: WorkOS client secret a

Return state updates for all three status lists.

Synthesize a TextResource for a prefab tool. Returns None if prefab_ui isn't installed.

Build Azure authorization URL with prefixed scopes. Overrides parent to prefix scopes with identifier_uri before sending to Azure, wh

Calculate delay for the given attempt number.

Helper method to call a tool with the provided arguments.

SHA256 hash of sorted tool searchable text for staleness detection.