Skip to content
CAI
Software that uses CAICheck a score

PrefectHQ/fastmcp

63.3

Adequate · 16 November 2026

94.1k

lines of production code

Python

primary language

5

measurements over time

CAI band scale
CAI trend line
CAI lens gauges

What this system is

Features

Add ATProto MCP example for Bluesky interaction

This change introduces a new example ATProto MCP server that enables interaction with the Bluesky social network. The server exposes read-only resources for checking profile status, fetching the user's timeline, and retrieving notifications. It also provides tools for state-modifying actions, including posting (with support for images, quotes, replies, and rich text), following users, liking and reposting posts, searching for content, and creating multi-post threads.

_examples/atproto\_mcp/src/atproto\mcp · high confidence

Add Auth0 MCP authentication example

This change introduces a new example in the \examples/auth/auth0\_mcp\ directory that demonstrates how to protect a FastMCP server using Auth0's Auth for MCP. It includes a server implementation (\server.py\) utilizing the \Auth0MCPProvider\ for token validation, a corresponding client example (\client.py\) configured for OAuth, and setup instructions (\README.md\) for configuring the Auth0 tenant and running the integration.

_examples/auth/auth0\_mcp, examples/auth/clerk\_oauth, examples/auth/workos\oauth · high confidence

Add Azure OAuth example for FastMCP servers

This change introduces a new example demonstrating how to protect a FastMCP server using Azure (Microsoft Entra) OAuth. It includes a server configuration using the \AzureProvider\ with required environment variables for client ID, secret, and tenant ID, along with a client example that authenticates via OAuth to list available tools.

_examples/auth/azure\oauth · high confidence

Add File Upload example application

A new example application has been added at examples/apps/file\_upload that demonstrates how to bypass the LLM context window to upload files to a server. The app uses the FastMCP framework with a dedicated FileUpload provider to handle file ingestion.

_examples/apps/file\upload · high confidence

Add Fire TV control tools to the smart-home example

The smart-home example now includes a new Fire TV integration that exposes tools for reading the TV's status (power state, current app, running apps) and performing actions such as pressing Home, launching installed apps by package ID, and playing specific YouTube videos. This feature is implemented via a dedicated MCP server backed by the Home Assistant androidtv library, with connection management and settings handled through environment variables.

_examples/smart\_home/src/smart\_home/fire\tv · high confidence

Add Hugging Face OAuth example for FastMCP servers

This change introduces a new example demonstrating how to protect a FastMCP server using Hugging Face OAuth. It includes a server configuration that utilizes the \HuggingFaceProvider\ for authentication and a client example that connects to the server using OAuth credentials. Users can now reference this example to understand how to set up Hugging Face as an identity provider for their FastMCP applications.

_examples/auth/huggingface\oauth · high confidence

Add Keycloak OAuth example for FastMCP server protection

A new example in examples/auth/keycloak\_oauth demonstrates how to secure a FastMCP server using Keycloak OAuth. The server.py file configures a KeycloakAuthProvider to handle authentication, requiring Keycloak 26.6.0 or later with Dynamic Client Registration enabled, and exposes a tool to retrieve access token claims. The accompanying client.py shows how to connect to this protected server using OAuth authentication.

_examples/auth/keycloak\_oauth, examples/auth/scalekit\oauth · high confidence

Add Prefect Horizon authentication and deployment support to the CLI

The FastMCP CLI now includes a new deployment subsystem for Prefect Horizon, introducing commands for device-based authentication (login, logout, whoami) and local state management. Users can now sign in via a browser-based device authorization flow, with credentials and configuration persisted securely in local state files that are restricted to owner-only permissions on all platforms. The CLI also provides structured terminal and JSON output for these operations, enabling programmatic integration and clearer feedback during the authentication process. Also in this area: Persistent encrypted OAuth tokens, Windows ACL fix, and UTF-8 generation.

_fastmcp\slim/fastmcp/cli/deploy · high confidence

Add client-side sampling handlers for Anthropic, OpenAI, and Google GenAI

The \fastmcp-slim\ client package now includes built-in sampling handlers for Anthropic, OpenAI, and Google GenAI, allowing users to delegate LLM inference directly from the client side. These new modules in \fastmcp.client.sampling.handlers\ provide \AnthropicSamplingHandler\, \OpenAISamplingHandler\, and \GoogleGenaiSamplingHandler\ classes that convert MCP sampling requests (including messages, tools, and tool choices) into the respective provider's API formats. This enables client-only installations to interact with MCP servers requiring LLM sampling without needing a separate server-side inference component, provided the corresponding optional dependencies (\anthropic\, \openai\, or \google-genai\) are installed. Also in this area: 5 commits (2 fixes) modifying fastmcp\_slim; 1 commit (0 fixes) modifying fastmcp\_slim/fastmcp/client/sampling; 4 commits (1 fix) modifying fastmcp\_slim/fastmcp/client; Improved Anthropic stop reason mapping and config client connection stability.

_fastmcp\slim/fastmcp/client/sampling · medium confidence · unverified

Add experimental CodeMode example with search and execute meta-tools

An example demonstrating the experimental CodeMode transform has been added to examples/code\_mode. This feature collapses a tool catalog into two meta-tools: \search\ for keyword-based discovery and \execute\ for running Python scripts that chain tool calls server-side. This reduces context window usage and round-trips by keeping intermediate data out of the LLM's context.

_examples/code\mode · high confidence

Add filesystem-based component discovery example

The \examples/filesystem-provider\ directory now includes a working example demonstrating how to use \FileSystemProvider\ to automatically discover and register tools, resources, and prompts from the filesystem. The example features a \server.py\ that scans a \components\ directory for decorated functions, along with sample implementations for tools (calculator, greeting), resources (config), and prompts (assistant) to illustrate the discovery mechanism.

examples/filesystem-provider · high confidence

Add persistent session state example

Added an example in the examples/persistent\_state directory that demonstrates how to use Context.get\_state() and set\_state() to store and retrieve data that persists across tool calls within the same MCP session. The example includes a server implementation with set\_value, get\_value, and list\_session\_info tools, along with HTTP and STDIO client scripts to show how state is isolated per session and cleared upon reconnection.

_examples/persistent\state · high confidence

Add sales dashboard and system monitor example applications

New example applications have been added to the examples directory: a sales dashboard demonstrating KPIs, revenue trends, and deal tracking using static data, and a live system monitor that displays real-time CPU, memory, and disk usage with auto-refresh capabilities. These examples serve as reference implementations for building UIs with the Prefab UI component library and FastMCP.

_examples/apps/sales\dashboard · high confidence

Added Approval and Choice example applications

New example applications have been added to demonstrate the Approval and Choice providers. The Approval demo (examples/apps/approval) shows how to require human sign-off before an agent acts, while the Choice demo (examples/apps/choice) illustrates how to let users pick from predefined options instead of typing. These examples serve as usage guides for integrating these specific provider types into FastMCP applications.

examples/apps/approval, examples/apps/choice · high confidence

Added dedicated script to run the smart home example with isolated Hue tools

A new \pi\_harness.py\ script has been added to the smart home example to provide a controlled environment for testing. This script runs the Pi agent with only the specific Hue MCP tools enabled, stripping away other extensions, skills, and built-in tools to ensure a clean audit trail. It supports loading bridge credentials from an existing dotenv file and can emit a JSON event stream for tool-call auditing, facilitating easier debugging and verification of the Hue integration.

_examples/smart\home/scripts · high confidence

Added search transform examples for tool discovery

The examples/search directory now includes runnable demos for Regex and BM25 search transforms, illustrating how to collapse a large tool catalog into a single \search\_tools\ endpoint to conserve context. The regex example (\client\_regex.py\/\server\_regex.py\) shows pattern-based discovery, while the BM25 example (\client\_bm25.py\/\server\_bm25.py\) demonstrates natural language search with relevance ranking and an \always\_visible\ configuration for specific tools.

examples/search · high confidence

Client mixins for prompts, resources, and tools in fastmcp-slim

The fastmcp-slim package now includes dedicated client mixins (ClientPromptsMixin, ClientResourcesMixin, ClientToolsMixin) that provide methods for listing and retrieving prompts, resources, and tools. These implementations support automatic pagination with a 250-page limit, manual cursor-based pagination, and response caching via the MCP Python SDK v2's CacheMode. The tool execution mixin also includes trace context injection and timeout handling. Also in this area: 6 commits (3 fixes) modifying fastmcp\_slim; 4 commits (1 fix) modifying fastmcp\_slim/fastmcp/client; Client elicitation handling, OAuth public client support, and tool schema hydration; Configurable HTTP header forwarding in proxy clients. Also in this area: 2 commits (1 fix) modifying fastmcp\_slim; 2 commits (2 fixes) fixing fastmcp\_slim/fastmcp/client/mixins.

_fastmcp\slim/fastmcp/client/mixins · medium confidence · unverified

The experimental transforms module now includes a code-mode execution environment and a new search strategy. The code-mode transform provides a sandbox provider backed by pydantic-monty with sensible default resource limits (30 seconds, 100 MB memory) and improved error reporting that includes valid parameter lists for validation failures. Additionally, a new JevSearchTransform is introduced, which uses TypeSafe's Jev model to rank tools in a catalog via a two-pass approach (wide summary pass followed by a close read with full descriptions), requiring a TypeSafe API key.

_fastmcp\slim/fastmcp/experimental · high confidence

Introduce OAuth Proxy provider for FastMCP

Adds a new OAuthProxy provider that acts as a transparent proxy to an upstream OAuth Authorization Server, enabling authentication with providers that do not support Dynamic Client Registration (DCR). The implementation includes local DCR with fixed upstream credentials, upstream token endpoint proxying, and a user-facing consent page for managing client access. It also introduces server-side identity assertions (ID-JAG) and supports Client Identity Metadata Discovery (CIMD) for verified domain badges on the consent UI.

_fastmcp\_slim/fastmcp/server/auth/oauth\proxy · high confidence

Introduce client-only 'fastmcp-slim' package with distributed caching and authentication

The new \fastmcp-slim\ package provides a lightweight client-only installation of FastMCP, decoupling client capabilities from the server-side dependencies. This release adds a \KeyValueResponseCacheStore\ that enables distributed, shared response caching across multiple client instances (e.g., proxy replicas) by adapting the MCP SDK's cache protocol to FastMCP's \AsyncKeyValue\ abstraction. It also introduces robust client-side authentication options, including \BearerAuth\, \ClientCredentialsOAuthProvider\, and \PrivateKeyJWTOAuthProvider\, alongside a new \MessageHandler\ class for granular control over server notifications and transport-level exceptions. Additionally, the client now supports elicitation handlers for interactive prompts, transparent telemetry attribute preservation, and automatic forwarding of ambient HTTP headers for seamless proxy integration. Also in this area: 5 commits (2 fixes) modifying fastmcp\_slim; Client elicitation handling, OAuth public client support, and tool schema hydration.

_fastmcp\slim/fastmcp/client · medium confidence · unverified

Introduce dynamic provider abstraction and backend-tool routing

The server now supports dynamic component discovery and registration through a new \Provider\ abstraction, exposing concrete implementations like \FileSystemProvider\ (which scans directories for tools, resources, and prompts) and \FastMCPProvider\ (which wraps other FastMCP servers to delegate execution and preserve middleware chains). To support complex compositions, the system introduces deterministic tool hashing and backend-tool routing, allowing tools to be addressed via stable \\<hash\>\_\<name\>\ identifiers that survive renaming across nested servers. Additionally, Prefab UI payloads are now rewritten to use these stable identities, and per-tool renderer resources are synthesized on demand, ensuring that UI components remain correctly bound to their underlying tools even in deeply nested server compositions. Also in this area: 6 commits (3 fixes) modifying fastmcp\_slim/fastmcp/server/providers.

_fastmcp\slim/fastmcp/server/providers · medium confidence · unverified

Introduce fastmcp-remote stdio bridge for connecting to remote MCP servers

A new standalone CLI tool, fastmcp-remote, is now available to bridge remote MCP servers (hosted over Streamable HTTP or SSE) to local MCP clients via stdio. This allows users to connect to remote MCP endpoints by launching a local process, supporting features such as OAuth authentication, custom HTTP headers, tool filtering via glob patterns, and configurable TLS certificate verification (including self-signed certificates or disabled verification). Also in this area: 1 commit (0 fixes) modifying fastmcp\_remote; Proxy server now supports tool filtering via transforms.

_fastmcp\remote · medium confidence · unverified

Introduce fastmcp-slim client-only tool exports

A new \fastmcp-slim\ package variant is introduced for client-only installations, providing a lightweight entry point at \fastmcp\_slim/fastmcp/tools\. This module exposes core tooling components—\FunctionTool\, \Tool\, \ToolResult\, \InputRequiredToolResult\, and the \tool\ decorator—along with \forward\ and \forward\_raw\ utilities from \tool\_transform\, enabling users to build and manage tools without the full server-side dependency footprint.

_fastmcp\slim/fastmcp/tools · high confidence

Introduce fastmcp-slim package with dedicated CLI entry points

The \fastmcp-slim\ distribution now includes its own CLI package (\fastmcp\slim/fastmcp/cli\), providing a client-only installation path. This location contributes the entry-point modules (\\\init\\.py\, \\\main\\_.py\) that expose the CLI application, along with the implementation of client-side commands (\client.py\) for discovering and invoking MCP servers, authentication utilities (\auth.py\, \cimd.py\) for handling OAuth and Client ID Metadata Documents, and the \dev apps\ subcommand (\apps\_dev.py\) for previewing FastMCPApp UIs locally with secure session handling. This separation allows users to install the CLI and client capabilities without pulling in the full server-side dependencies. Also in this area: 6 commits (3 fixes) modifying fastmcp\_slim; 5 commits (3 fixes) fixing fastmcp\_slim/fastmcp/cli; 2 commits (1 fix) modifying fastmcp\_slim/fastmcp/cli.

_fastmcp\slim/fastmcp/cli · medium confidence · unverified

Introduce fastmcp-slim package with lazy imports and SDK v2 compatibility

This change adds the \fastmcp-slim\ package, a lightweight client-only installation option that avoids loading the full MCP and CLI stacks during imports for better performance. It includes a camelCase compatibility bridge (\\_compat.py\) to support legacy code reading snake\_case-renamed fields from the MCP Python SDK v2, with a runtime toggle via \mcp\_camelcase\_compat\ settings. The package also introduces lazy imports for \Client\, \ClientGroup\, \FastMCP\, and other core symbols, providing clear error messages when optional dependencies are missing, and exposes \ClientGroup\ from the package root.

_fastmcp\slim/fastmcp · high confidence

Introduce fastmcp-slim with resource and prompt modules

The fastmcp-slim package now includes the resources and prompts submodules, providing users with a client-only installation option that exposes core resource types (TextResource, BinaryResource, FileResource, HttpResource, DirectoryResource) and prompt constructs (FunctionPrompt, Prompt, etc.). This allows users to define and manage resources and prompts without the full server overhead, supporting features like URI template handling, file reading, and HTTP fetching within the slim distribution. Also in this area: 4 commits (4 fixes) fixing fastmcp\_slim/fastmcp/resources; 1 commit (0 fixes) modifying fastmcp\_slim/fastmcp/resources; Resource template validation and URI parsing improvements; Strip internal metadata from resource and prompt results.

_fastmcp\slim/fastmcp/resources · medium confidence · unverified

Introduce fastmcp-slim with streaming ASGI transport and core utilities

This change introduces the \fastmcp-slim\ package, a client-only installation variant that includes the core utility modules (such as async helpers, authentication, CLI configuration, and JSON schema processing) but excludes the server-side components. A key addition is the \StreamingASGITransport\ in \fastmcp/utilities/asgi\_transport.py\, which enables in-process, full-duplex HTTP communication with ASGI applications by streaming response chunks immediately, avoiding the deadlocks associated with the standard \httpx2.ASGITransport\ when dealing with server-initiated requests or SSE streams.

_fastmcp\slim/fastmcp/utilities · high confidence

Introduce fastmcp-tasks package for SEP-2663 background task execution

FastMCP now includes a dedicated \fastmcp-tasks\ package that implements the SEP-2663 background tasks extension, enabling long-running tools to execute asynchronously. Users can register the \TasksExtension\ on their server and mark tools with \task=True\ to offload work to a durable backend (defaulting to in-memory, configurable to Redis). The package provides a transparent client-side implementation that automatically polls for task completion and handles mid-run input requests via the client's elicitation handler. It also supports out-of-process workers for distributed deployments and includes optional encryption for task context snapshots at rest. Also in this area: 1 commit (0 fixes) modifying examples, fastmcp\_tasks; 6 commits (4 fixes) fixing fastmcp\_tasks; 1 commit (1 fix) fixing fastmcp\_tasks; Improved task argument validation and storage reliability.

_fastmcp\tasks · low confidence · unverified

Introduce on-demand tool discovery via search transforms

Added a new search transform module that allows LLM clients to discover tools on demand rather than receiving the full catalog. This introduces two search strategies: BM25-based natural language search (BM25SearchTransform) and regex-based pattern matching (RegexSearchTransform). When applied, the server replaces the standard list\_tools output with synthetic search and call tools, enabling clients to find relevant tools by querying their names, descriptions, and parameter schemas.

_fastmcp\slim/fastmcp/server/transforms/search · high confidence

Introduce server-level caching hints, argument completion, and resumable Streamable HTTP sessions

The server module now supports server-level cache hints (SEP-2549) via \cache\_ttl\ and \cache\_scope\ constructor parameters, automatically applying uniform caching to all SDK-cacheable methods. It adds server-side argument completion for prompts and resource templates through the \@mcp.completion\ decorator, enforcing the 100-candidate limit. Additionally, Streamable HTTP transport now supports resumability via an \EventStore\ backed by \AsyncKeyValue\ (e.g., Redis or in-memory), with session-scoped isolation to prevent stream ID collisions across concurrent sessions. Also in this area: 10 commits (5 fixes) modifying fastmcp\_slim/fastmcp/server; 2 commits (2 fixes) fixing fastmcp\_slim/fastmcp/server; Client extension detection no longer requires client info; Improved HTTP session timeout handling and upstream error logging; Component Manager routes now inherit server authentication and SSE/HTTP transports support Host/Origin protection.

_fastmcp\slim/fastmcp/server · medium confidence · unverified

Introduce server-side component transform system

The server now supports a new transform system that allows modifying tools, resources, prompts, and resource templates before they are exposed to clients. This location introduces the core \Transform\ base class and several concrete implementations: \Namespace\ for prefixing component names and URIs, \VersionFilter\ for restricting visibility by version ranges, \Visibility\ for marking components as enabled or disabled based on tags or names, \ToolTransform\ for renaming or altering tool schemas, and \PromptsAsTools\/\ResourcesAsTools\ for exposing prompts and resources as standard tools for clients that only support tool-based interfaces. These transforms can be chained to apply complex filtering, naming, and compatibility logic to the server's component catalog.

_fastmcp\slim/fastmcp/server/transforms · high confidence

Major examples overhaul: new capabilities and API migration

The examples directory has been significantly expanded and modernized to demonstrate new FastMCP capabilities and migrate to the current API. New examples include \config\_server.py\ for CLI argument support, \elicitation.py\ for interactive user input, \screenshot.py\ for screen capture, and \text\_me.py\ for external API integration. The suite now features \run\_with\_tracing.py\ and a \diagnostics/\ subdirectory to demonstrate OpenTelemetry tracing integration. Advanced patterns are covered by \mount\_example.py\ (app composition), \in\_memory\_proxy\_example.py\ (proxies), \custom\_tool\_serializer\_decorator.py\ (custom serialization), and \tags\_example.py\ (FastAPI route mapping). The \desktop.py\ example has been updated to use the new \FastMCP\ class and decorator-based resource definitions, replacing the legacy \FastMCPServer\ and \add\_dir\_resource\ methods. Additionally, the outdated \weather.py\ example has been removed.

examples · high confidence

New ATProto MCP example for Bluesky integration

Added a new example server in examples/atproto\_mcp that exposes AT Protocol (Bluesky) capabilities via FastMCP. The server provides read-only resources for profile status, timeline, and notifications, along with tools for posting (including rich text, images, quotes, and replies), creating threads, searching, and social actions like following, liking, and reposting. The example includes a demo script, configuration via fastmcp.json, and setup instructions for Bluesky credentials.

_examples/atproto\mcp · high confidence

New CLI install subcommands for MCP clients and formats

The FastMCP CLI now includes a dedicated \install\ command group that simplifies adding MCP servers to various environments. Users can run \fastmcp install claude-code\, \claude-desktop\, \cursor\, \gemini-cli\, \goose\, \mcp-json\, or \stdio\ to automatically configure the server in the respective client or generate the necessary configuration/command. This includes direct integration for Claude Code and Gemini CLI, workspace-specific installation for Cursor, deeplink-based installation for Goose, and plain JSON or shell command generation for manual setup.

_fastmcp\slim/fastmcp/cli/install · high confidence

New Discord OAuth example for FastMCP server protection

Added a new example in the \examples/auth/discord\_oauth\ directory that demonstrates how to protect a FastMCP server using Discord OAuth. The entry includes a server implementation (\server.py\) utilizing the \DiscordProvider\ for authentication, a corresponding client example (\client.py\) showing how to connect with OAuth credentials, and setup instructions (\README.md\) for configuring the Discord OAuth app and environment variables.

_examples/auth/discord\oauth · high confidence

New FastMCP configuration demo using fastmcp.json

Added an example demonstrating the recommended way to configure FastMCP servers using a \fastmcp.json\ file. This example shows how to declare dependencies (such as \pyautogui\ and \Pillow\) and environment settings in the configuration file instead of passing them as parameters in the Python code, highlighting benefits like environment isolation and IDE support.

_examples/fastmcp\_config\demo · high confidence

New FastMCP configuration examples demonstrating JSON-based setup

Added example files in the examples/fastmcp\_config directory that illustrate how to configure a FastMCP server using a fastmcp.json file. These examples cover basic setups with source paths and stdio transport, full configurations including Python version, dependencies, HTTP transport settings, and environment variable interpolation, providing users with templates for defining entrypoints, environment requirements, and deployment parameters.

_examples/fastmcp\config · high confidence

New FastMCP testing demo example with comprehensive test patterns

The \examples/testing\_demo\ directory now includes a complete example demonstrating how to test FastMCP servers using pytest-asyncio. It provides a sample server (\server.py\) with tools, resources, and prompts, along with a test suite (\tests/test\_server.py\) that showcases async fixtures, parametrized tests, and assertions using \dirty-equals\ and \inline-snapshot\. The example also includes a \README.md\ explaining the \pyproject.toml\ configuration for automatic asyncio mode and instructions for running the server and tests.

_examples/testing\demo · high confidence

New FastMCPApp example applications for approvals and data exploration

Added two new example applications in the examples/apps directory: an approvals workflow demonstrating multi-step interactive UI with tabs, status badges, and action chaining (approve/reject/comment), and a data explorer showcasing tables, charts (BarChart, PieChart), metric cards, and filtering capabilities. Both examples utilize the FastMCPApp framework with PrefabUI components, illustrating backend tool definitions (@app.tool) and frontend state management.

examples/apps/approvals, examples/apps/explorer · high confidence

New GitHub and Google OAuth example applications

Added example projects for both GitHub and Google OAuth authentication. The GitHub example demonstrates server protection using the \GitHubProvider\ and client-side authentication via the \OAuth\ helper, while the Google example shows server protection with \GoogleProvider\ and client-side authentication using the string identifier \"oauth"\. Both examples include setup instructions for creating OAuth apps, configuring environment variables, and running the server and client scripts.

_examples/auth/github\oauth · high confidence

New OAuth authentication examples for AWS Cognito and WorkOS AuthKit

Added example implementations for protecting FastMCP servers with two new enterprise OAuth providers: AWS Cognito and WorkOS AuthKit. The AWS Cognito example demonstrates server-side authentication using the AWSCognitoProvider and includes a tool to inspect user claims, while the AuthKit example shows integration with WorkOS, including automatic binding of the JWT audience to the resource URL and client configuration for public clients.

_examples/auth/aws\oauth · high confidence

New Prefab UI example applications for FastMCP

Added a suite of runnable example applications in the \examples/apps\ directory that demonstrate how to build interactive UIs using the Prefab UI library with FastMCP. These include a sales dashboard with bar charts, a team directory with sortable data tables and pie charts, a generative UI studio that allows LLMs to build custom Prefab UIs on the fly, a multilingual greeter, a component showcase displaying various UI widgets, and a demo server for testing the MCP message inspector. These examples serve as templates for creating app-enabled tools that return rich, interactive Prefab UI components.

examples/apps · high confidence

New PropelAuth OAuth example for FastMCP servers

Added a new example in \examples/auth/propelauth\_oauth\ that demonstrates how to protect a FastMCP server using PropelAuth OAuth. The server-side code (\server.py\) configures a \PropelAuthProvider\ with introspection credentials and exposes authenticated tools (echo, whoami), while the client-side code (\client.py\) shows how to connect using OAuth authentication. This provides a reference implementation for integrating PropelAuth as an authentication provider in FastMCP applications.

_examples/auth/propelauth\oauth · high confidence

New QR Code MCP App example with interactive UI

Added a new example application in examples/apps/qr\_server that demonstrates FastMCP's MCP Apps support. The app generates QR codes as base64 PNG images and serves an interactive HTML viewer UI linked via AppConfig. It showcases linking a tool to a ui:// resource, serving embedded HTML with CSP metadata for CDN-loaded dependencies, and returning ImageContent from a tool.

_examples/apps/qr\server · high confidence

New SQLite-based dynamic tool provider example

Added an example in examples/providers/sqlite that demonstrates how to implement a Provider which loads tool definitions from a SQLite database at runtime. This allows users to add, modify, or disable tools by updating the database without restarting the server, with the example including the server implementation, a database setup script, and documentation.

examples/providers · high confidence

New Skills providers for discovering and exposing agent skills as MCP resources

This change introduces a new module at fastmcp/server/providers/skills that enables FastMCP servers to automatically discover and expose agent skills (structured folders containing a SKILL.md manifest and supporting files) as MCP resources. It provides a base SkillsDirectoryProvider for scanning arbitrary directories, a SkillProvider for single folders, and convenience vendor-specific providers for Claude, Cursor, VS Code, Codex, Gemini, Goose, Copilot, and OpenCode that point to their respective default skill directories. The implementation includes path-safety checks via safe\_join to prevent directory traversal, handles non-UTF-8 SKILL.md files by skipping them, and supports both static and reload-based discovery modes. Also in this area: 5 commits (0 fixes) modifying fastmcp\_slim.

_fastmcp\slim/fastmcp/server/providers/skills · medium confidence · unverified

New background tasks example with client/server pair

The examples/tasks directory now provides a runnable client/server pair demonstrating SEP-2663 background tasks. The server exposes a 'slow\_computation' tool that reports progress, while the client supports three interaction modes: transparent execution (blocking until completion), explicit handle usage (polling for status and result), and parallel execution of multiple tasks. The example defaults to an in-memory backend for easy local testing but can be configured via environment variables to use Redis for distributed workers.

examples/tasks · high confidence

New built-in authentication providers for Auth0, AWS Cognito, Azure, Clerk, Descope, Discord, and GitHub

FastMCP now ships with dedicated OAuth/OIDC provider implementations for major identity platforms, allowing you to secure your MCP server with a single import and minimal configuration. The new \fastmcp.server.auth.providers\ module includes \Auth0Provider\ and \Auth0MCPProvider\ (supporting CIMD), \AWSCognitoProvider\ (with Cognito-specific claim filtering), \AzureProvider\ (handling Microsoft Entra scopes and authority overrides), \ClerkProvider\ (using introspection and userinfo endpoints), \DescopeProvider\ (supporting DCR and flexible issuer validation), \DiscordProvider\ (verifying opaque tokens via the tokeninfo API), and \GitHubProvider\. These providers handle the complexity of token validation, scope parsing, and redirect flows, enabling you to add robust authentication to your FastMCP server without writing custom verification logic.

_fastmcp\slim/fastmcp/server/auth/providers · high confidence

New client-only authentication module with M2M OAuth and bearer support

The \fastmcp\_slim\ package now includes a new \fastmcp.client.auth\ module that provides authentication capabilities for client-only installations. This module introduces \BearerAuth\ for simple token-based authorization and implements machine-to-machine (M2M) OAuth 2.0 support via \ClientCredentialsOAuthProvider\ (using client ID/secret) and \PrivateKeyJWTOAuthProvider\ (using private key JWT assertions). These providers wrap the MCP SDK's client-credentials extensions, adding features like scoped token caching and handling of insufficient scope challenges. The module also includes an \OAuth\ class for interactive authorization flows, utilizing a \TokenStorageAdapter\ to persist tokens and client information in key-value stores.

_fastmcp\slim/fastmcp/client/auth · high confidence

New contrib modules: MCPMixin, BulkToolCaller, and Component Manager

FastMCP now includes three new community-contributed modules in the \fastmcp.contrib\ package. The \MCPMixin\ allows developers to define classes with methods decorated by \@mcp\_tool\, \@mcp\_resource\, and \@mcp\_prompt\, which can then be registered with a server using methods like \register\_all()\. The \BulkToolCaller\ provides tools (\call\_tools\_bulk\, \call\_tool\_bulk\) to execute multiple tool calls in a single request, reducing server overhead. The \Component Manager\ exposes HTTP endpoints to enable or disable tools, resources, and prompts at runtime, supporting authentication and scoped access for both local and mounted servers. Also in this area: 2 commits (0 fixes) modifying fastmcp\_slim/fastmcp/contrib.

_fastmcp\_slim/fastmcp/contrib/bulk\_tool\_caller, fastmcp\_slim/fastmcp/contrib/mcp\mixin · medium confidence · unverified

New example apps and CLI deployment scaffolding

This update adds several new example applications to the \examples/\ directory, including a Contacts manager, an Inventory tracker, a Media Picker, and demos for complex inputs, memory, and task elicitation, which showcase the \FastMCPApp\ stack, form handling, and background task patterns. It also introduces the initial scaffolding for the \fastmcp-slim\ CLI, adding modules for Horizon credential storage, the Horizon HTTP client, and MCP server discovery from editor configuration files. Also in this area: 5 commits (1 fix) modifying fastmcp; 10 commits (6 fixes) fixing fastmcp; 4 commits (2 fixes) modifying fastmcp; Improved proxy fidelity, stricter tool validation, and better docstring parsing; Improved elicitation validation, metadata stripping, and server startup reliability; and 4 more.

fastmcp · medium confidence · unverified

New example demonstrating ResourcesAsTools transform

Added an example in the resources\_as\_tools directory that shows how to use the ResourcesAsTools transform to expose resources as tools. The server example defines static and templated resources and applies the transform to generate list\_resources and read\_resource tools, while the client example demonstrates connecting to this server and invoking those generated tools to list and read resources.

_examples/resources\_as\tools · high confidence

New example demonstrating prompts-as-tools transform

Added an example in examples/prompts\_as\_tools that shows how to use the PromptsAsTools transform to expose MCP prompts as standard tools. The server.py file defines several prompts (explain\_concept, analyze\_code, review\_pull\_request) and applies the transform to generate list\_prompts and get\_prompt tools, while client.py demonstrates how to call these generated tools to list and retrieve prompt definitions and results.

_examples/prompts\_as\tools · high confidence

New example for mounting multiple OAuth-protected MCP servers

Added a new example in \examples/auth/mounted\ that demonstrates how to host multiple OAuth-protected MCP servers (GitHub and Google) within a single application. The example uses Starlette to mount separate server instances under distinct paths (e.g., \/api/mcp/github\ and \/api/mcp/google\) and configures path-aware OAuth discovery endpoints compliant with RFC 8414, allowing each provider to have its own metadata endpoint.

examples/auth/mounted · high confidence

New interactive app providers for human-in-the-loop and structured input

The \fastmcp/apps\ package introduces a suite of composable providers that enable rich, interactive user experiences within MCP conversations. \FastMCPApp\ serves as the base provider for binding UI entry-points with backend tools, while specialized providers like \Approval\ (human-in-the-loop confirmation), \Choice\ (discrete option selection), \FileUpload\ (drag-and-drop file handling), \FormInput\ (Pydantic-driven structured data collection), and \GenerativeUI\ (LLM-generated sandboxed UIs) allow servers to present interactive cards, forms, and dynamic interfaces. These components rely on the \prefab-ui\ library and are configured via \AppConfig\ models that handle UI metadata, Content Security Policies, and iframe sandbox permissions. Also in this area: Move Content Security Policy to renderer resource; File upload app now supports total size limits and time-to-live expiration. Also in this area: 10 commits (5 fixes) modifying fastmcp\_slim/fastmcp/server.

_fastmcp\slim/fastmcp/apps · medium confidence · unverified

New interactive map example with geocoding

Added a new example application in examples/apps/map that demonstrates geocoding addresses via OpenStreetMap Nominatim and rendering them on an interactive Leaflet map. The map\_server.py file provides a FastMCP tool that accepts location strings, fetches coordinates, and displays the results in a PrefabApp UI with an embedded map and data table.

examples/apps/map · high confidence

New interactive media picker example app

An interactive media picker example app has been added to the examples directory. It allows users to verify YouTube links via oEmbed, display playable media options in a UI, and play or save selected items. The app includes a CSS stylesheet for the interface, a server implementation, and comprehensive tests covering link verification, malformed input handling, and playback routing.

_examples/apps/media\picker · high confidence

New maintenance and benchmarking scripts for development workflows

Added four new Python scripts to the \scripts/\ directory to support project maintenance and performance tracking. \benchmark\_http\_startup.py\ measures the cold-start performance of the FastMCP HTTP server, breaking down import, configuration, and ASGI app build times. \gate\_digest.py\ automates the review of pull requests waiting on the issue-link gate, using an AI assistant to classify PRs as worth assigning, needing human review, or decline. \maintenance\_status.py\ generates public maintenance status reports (including \status.json\ and \STATUS.md\) by aggregating data from GitHub Actions workflows. Finally, \rank\_issues\_tui.py\ provides a terminal-based user interface for browsing and filtering issues based on a ranking algorithm, displaying details like severity, author trust, and engagement metrics. Also in this area: 1 commit (0 fixes) modifying scripts, status-site; 2 commits (0 fixes) modifying scripts, status-site; New script to identify human contributors in release notes.

scripts · medium confidence · unverified

New namespace activation example demonstrating session-specific tool visibility

Added an example in examples/namespace\_activation that demonstrates how to organize tools into namespaces using tags and control their visibility per session. The example shows how to globally disable namespace tools by default and selectively enable them for specific sessions using context methods like enable\_components and reset\_visibility.

_examples/namespace\activation · high confidence

New quiz example application demonstrating multi-turn state management

Added a new quiz example application in examples/apps/quiz that demonstrates building state over a conversation using FastMCP. The app features a multi-turn UI where the LLM generates quiz questions and launches the interface, users answer via multiple-choice buttons, and each answer updates the score and progress state. The implementation includes a backend tool for grading answers and a UI entry point that manages question visibility, score tracking, and completion state.

examples/apps/quiz · high confidence

New server middleware components for authorization, caching, and rate limiting

The \fastmcp/server/middleware\ package now includes a comprehensive set of middleware components: \AuthMiddleware\ for global authorization checks, \CachingMiddleware\ for response caching (including binary resource support and multi-round-trip handling), \RateLimitingMiddleware\ with token bucket and sliding window algorithms, \ResponseLimitingMiddleware\ to truncate oversized tool outputs, \DereferenceRefsMiddleware\ to inline JSON Schema $refs, \ErrorHandlingMiddleware\ and \RetryMiddleware\ for consistent error handling and automatic retries, \LoggingMiddleware\ for structured request logging, \PingMiddleware\ for connection keep-alive, \TimingMiddleware\ for performance measurement, and \ToolInjectionMiddleware\ for adding tools to the context. Also in this area: 5 commits (2 fixes) modifying fastmcp\_slim/fastmcp/server/middleware; 3 commits (2 fixes) fixing fastmcp\_slim/fastmcp/server/middleware; Preserve error context in middleware handling; Component Manager routes now inherit server authentication and SSE/HTTP transports support Host/Origin protection.

_fastmcp\slim/fastmcp/server/middleware · medium confidence · unverified

New smart-home example with Hue and Fire TV integration

The smart-home example has been refreshed to support both Philips Hue lights and Fire TV devices. Users can now run a unified hub that mounts the lights server under the 'hue' namespace and the Fire TV server under the 'fire\_tv' namespace. Configuration for the Hue bridge (IP, username, and optional certificate) is managed via environment variables using pydantic-settings.

_examples/smart\_home/src/smart\home · high confidence

New versioning examples for client selection, filters, and components

Added three new example scripts in the \examples/versioning\ directory that demonstrate how to use the FastMCP versioning capabilities. \versioned\_components.py\ shows how to register multiple versions of tools, resources, and prompts under the same name, allowing clients to see the highest version by default while still being able to request specific older versions. \client\_version\_selection.py\ illustrates how a client can discover available versions via metadata and explicitly call a specific version of a tool. \version\_filters.py\ demonstrates how to use \VersionFilter\ transforms to create distinct API surfaces (e.g., v1, v2, v3) from a shared set of components, enabling different clients to see only the versions relevant to their needs.

examples/versioning · high confidence

Removals

Removal of legacy FastMCP server implementation and CLI

The legacy \src/fastmcp\ module has been completely removed, eliminating the previous \FastMCPServer\ class, its associated resource and tool managers, the CLI entry point, and internal Pydantic models. This change removes the ability to run servers via the previous stdio/SSE transport mechanisms and the \fastmcp\ CLI commands, requiring users to adopt the updated server architecture and context handling introduced in the current codebase.

src/fastmcp · high confidence

Behavioural changes

2 commits (0 fixes) modifying scripts, status-site

A change to existing behaviour in scripts, status-site — 2 commits, 8 files: “Restore the status site (\#6216)”; “Remove the status site and its maintenance scripts (\#6211)” (refs \#6216, \#6211). Also in this area: 1 commit (0 fixes) modifying scripts, status-site; Public backlog dashboard and automation health site.

status-site · medium confidence · unverified

3 commits (0 fixes) modifying fastmcp\_slim/fastmcp/contrib/component\_manager

A change to existing behaviour in fastmcp\_slim/fastmcp/contrib/component\_manager — 3 commits, 4 files: “Convert the component manager's version query param to a VersionSpec (\#5575)”; “Add fastmcp-slim for client-only installs (\#4122)”; “Use the server's auth provider for component manager routes (\#5425)” (refs \#5575, \#4122, \#5425).

_fastmcp\_slim/fastmcp/contrib/component\manager · medium confidence · unverified

5 commits (1 fix) modifying .agents/skills/release

A change to existing behaviour in .agents/skills/release — 5 commits (1 fix), 2 files: “Share repository skills across agents and check triage history (\#5013)”; “agents: make AGENTS.md the entry point and tighten repo skills (\#5278)”; “docs: credit issue authors in maintainer implementations (\#5410)”; and 2 more (refs \#5013, \#5278, \#5410, \#6001, \#5433).

.agents/skills/release, examples/diagnostics · medium confidence · unverified

6 commits (3 fixes) modifying fastmcp\_slim/fastmcp/server/providers

A change to existing behaviour in fastmcp\_slim/fastmcp/server/providers — 6 commits (3 fixs), 7 files: “fix(openapi): make resource templates for non-identifier path parameters readable (\#6187)”; “fix(openapi): hydrate data for wrapped non-object responses with validate\_output=False (\#5784)”; “Revert 12 contributions merged without enough review (\#6434)”; and 3 more (refs \#6187, \#5784, \#6434, \#5062, \#5798, …). Also in this area: Introduce LocalProvider for standalone MCP component management.

(repo-wide) · medium confidence · unverified

Enhanced authorization handler with improved error responses

The authorization handler in the auth handlers module has been updated to provide better user experience when clients attempt to authorize with unregistered client IDs. The handler now implements content negotiation, returning styled HTML error pages for browser requests and enhanced JSON responses with registration endpoint hints for API clients. The HTML error pages include clear guidance on how to resolve the issue, such as clearing authentication tokens and reconnecting. Additionally, the handler now uses issuer\_url for OAuth issuer identity instead of base\_url, and supports keyword-only arguments for improved API clarity.

_fastmcp\slim/fastmcp/server/auth/handlers · high confidence

Introduce fastmcp-slim client transport layer with MCP SDK v2 support

The \fastmcp\_slim\ package now includes a complete client transport implementation (\fastmcp/client/transports\) that migrates the HTTP, SSE, and stdio transports to use the MCP Python SDK v2 (specifically \httpx2\ and the modern \streamable\_http\_client\). This change introduces \StreamableHttpTransport\ for native sessionless HTTP connections, updates \SSETransport\ to work with the new SDK client, and refactors \StdioTransport\ to manage subprocess lifecycles with explicit keep-alive and cancellation handling. It also adds \MCPConfigTransport\ for connecting to multiple servers via a unified config, \FastMCPTransport\ for in-memory server connections, and an \infer\_transport\ function that automatically selects the correct transport type from URLs, paths, or config dicts, while deprecating the inference of stdio transports from string paths in favor of explicit \Path\ objects. Also in this area: 4 commits (1 fix) modifying fastmcp\_slim/fastmcp/client; 1 commit (0 fixes) modifying fastmcp\_slim; Improved Anthropic stop reason mapping and config client connection stability; Configurable HTTP header forwarding in proxy clients.

_fastmcp\slim/fastmcp/client/transports · medium confidence · unverified

Introduce server mixin architecture for lifespan, extensions, and transport

The server implementation has been refactored into modular mixins located in \fastmcp/server/mixins\. This change introduces \LifespanMixin\ to manage process-level shared contexts and extension lifespans, \ExtensionsMixin\ to handle explicit and provider-bundled server extension registration, \MCPOperationsMixin\ to centralize MCP protocol handler setup and wire-format logic, and \TransportMixin\ to standardize HTTP/stdio/SSE transport handling and custom route registration. Users benefit from a more structured server lifecycle and clearer separation of concerns in how extensions, protocol operations, and network transports are managed. Also in this area: 5 commits (2 fixes) modifying fastmcp\_slim; 6 commits (4 fixes) fixing fastmcp\_slim/fastmcp/server/mixins; HTTP session idle timeout configuration and stdio capability parity; Component Manager routes now inherit server authentication and SSE/HTTP transports support Host/Origin protection.

_fastmcp\slim/fastmcp/server/mixins · medium confidence · unverified

LocalProvider decorator mixins are restructured into dedicated modules

The decorator functionality for LocalProvider (tools, resources, and prompts) has been reorganized into separate mixin classes (ToolDecoratorMixin, ResourceDecoratorMixin, PromptDecoratorMixin) within the fastmcp-slim package. This change refactors how decorators like @provider.tool and @provider.resource are implemented, moving the registration logic into dedicated modules while preserving the existing API surface for users.

_fastmcp\_slim/fastmcp/server/providers/local\provider/decorators · high confidence

Major overhaul of server authentication and authorization modules

The \fastmcp/server/auth\ package has been significantly restructured and expanded. The module now exposes a comprehensive set of authentication providers and utilities, including \OAuthProxy\, \OIDCProxy\, \JWTVerifier\, and \IdentityAssertion\, along with authorization helpers like \require\_roles\ and \require\_scopes\. A key behavioral change is the introduction of lazy imports for heavy dependencies (such as \authlib\ and \cryptography\) to reduce startup time for common server-only use cases. The \TokenHandler\ has been updated to strictly comply with OAuth 2.1 and MCP specifications by transforming error codes (e.g., \unauthorized\_client\ to \invalid\_client\) and status codes (e.g., 400 to 401 for invalid tokens). Additionally, the \RequireAuthMiddleware\ now distinguishes between missing and invalid authentication headers per RFC 6750 §3.1, providing more accurate error responses. The \OIDCProxy\ includes a new caching mechanism for OIDC discovery configurations to improve performance and stability, and \redirect\_validation\ utilities have been added to securely handle OAuth redirect URIs, including protection against userinfo-based bypass attacks.

_fastmcp\slim/fastmcp/server/auth · high confidence

New stateless OpenAPI provider with RequestDirector and httpx2 support

A new OpenAPI provider implementation has been added to replace the legacy server module, introducing a stateless architecture that uses \RequestDirector\ and \openapi-core\ for zero-latency startup and robust parameter handling (including deepObject and collision resolution). The provider now requires \httpx2\ for HTTP requests, while maintaining backward compatibility with legacy \httpx\ clients via a deprecation warning. Users can customize how OpenAPI routes map to MCP components (Tools, Resources, or ResourceTemplates) using \RouteMap\ configurations and \route\_map\_fn\ callbacks. Also in this area: 1 commit (0 fixes) modifying fastmcp\_slim/fastmcp/server/providers; 6 commits (3 fixes) modifying fastmcp\_slim; Improved OpenAPI resource handling and filesystem reload reliability; Improved security and consistency in tool lookups and skill file resolution.

_fastmcp\slim/fastmcp/server/providers/openapi · low confidence · unverified

Refactored ATProto client and unified posting API

The ATProto implementation module has been restructured into dedicated files for client management, posting, reading, profile, and social actions. A key behavioral change is in post creation: URLs embedded in post text are now automatically detected and converted into clickable links via facets, in addition to supporting explicit link and mention parameters. The posting API also now supports creating threaded posts, replying to specific posts, quoting posts, and attaching images. Other operations like fetching the timeline, searching posts, retrieving notifications, and social actions (follow, like, repost) have been consolidated into this new structure.

_examples/atproto\_mcp/src/atproto\_mcp/\atproto · high confidence

Smart home example updated to support Philips Hue V2 protocol and native effects

The smart home example has been refreshed to use the Philips Hue V2 API, introducing support for native light effects (such as candle flicker and fire), precise color temperature control in Kelvin, and scene activation with dynamic palettes. This change replaces the previous Hue integration with a new implementation that manages a pooled bridge connection via FastMCP's lifespan system and exposes tools for discovering rooms, lights, and scenes, as well as controlling individual lights and rooms with detailed state verification.

_examples/smart\_home/src/smart\home/lights · high confidence

Fixes

Refactored OpenAPI utilities with stateless request building and comprehensive serialization fixes

The OpenAPI integration utilities have been refactored into a new modular structure (\director.py\, \parser.py\, \schemas.py\, \models.py\, \formatters.py\, \json\_schema\_converter.py\) to support a stateless request-building strategy using \openapi-core\ and \httpx2\. This change eliminates startup latency by pre-calculating schemas and parameter mappings during parsing. The update includes numerous fixes to OpenAPI compliance: it now correctly preserves raw body content types, extracts parameter-level examples, encodes JSON scalar request bodies, flattens discriminator subtypes, preserves dictionary request bodies, rewrites model references in \prefixItems\, fixes query explode defaults, preserves HTTP parameters that match whole-body names, and fixes multipart string-array default encoding. Additionally, the \json\_schema\_converter\ now systematically handles OpenAPI 3.0 nullable fields, discriminator tags, and recursive schema processing. Also in this area: 8 commits (4 fixes) modifying fastmcp\_slim/fastmcp/utilities; Improved OpenAPI schema conversion and request handling robustness; Improved OpenAPI schema handling and request parameter mapping.

_fastmcp\slim/fastmcp/utilities/openapi · medium confidence · unverified

Test coverage

6 commits adding/updating tests in tests/downstream; Add comprehensive test suite for server authentication; Added HTTP server test suite; Added MCP conformance test suite for FastMCP; Added comprehensive test coverage for resources; Added comprehensive test coverage for server provider implementations; Added comprehensive test coverage for tool transformation logic; Added comprehensive test suite for CLI commands and integrations; Added comprehensive test suite for FastMCP utilities; Added comprehensive test suite for MCP Apps, Prefab integration, and SDK compatibility; Added comprehensive test suite for OAuth proxy; Added comprehensive test suite for OpenAPI provider; Added comprehensive test suite for proxy server behavior; Added comprehensive test suite for server mounting behavior; Added comprehensive test suite for server versioning; Added comprehensive test suite for tool argument validation, concurrency, and result handling; Added experimental test suite structure; Added integration tests for GitHub MCP remote and HTTP transport timeout handling; Added integration tests for GitHub and Keycloak OAuth providers; Added server-side tests for SEP-2663 background tasks; Added telemetry tests for FastMCP server tracing; Added test coverage for OAuth client authentication features; Added test coverage for server transforms; Added test suite for FastMCP utilities; Added tests for Approval, Choice, FileUpload, and FormInput providers; Added tests for CLI deploy authentication, state management, and output formatting; Added tests for FastMCP telemetry interoperability and span attributes; Added tests for Fire TV and Hue smart-home example tools; Added tests for MRE auto-close exemption and release contributor credit scanning; Added tests for OpenAPI utility functions; Added tests for client transport behavior and security; Added tests for client-side OpenTelemetry tracing; Added tests for contrib components; Added tests for experimental CodeMode and JevSearch transforms; Added tests for filesystem component discovery and provider behavior; Added tests for prompt rendering and standalone decorator behavior; Added tests for removed include/exclude tags parameters; Added tests for sampling handlers; Added tests for server versioning logic; Added tests for standalone decorators, future annotations, thread affinity, and tool timeouts; Added tests for the MCP SEP-2663 background task client; Added unit tests for server auth providers; Comprehensive test coverage for server middleware; Expanded server-side test coverage for core FastMCP capabilities; Expanded test coverage for JSON Schema type conversion; Expanded test coverage for client elicitation, extensions, logging, and security; Tests added for removed FastMCP initialization arguments and settings access.

Dependencies

FastMCP package split into slim, remote, and tasks extras

The FastMCP distribution has been restructured into a modular workspace. The main \fastmcp\ package now acts as a meta-package that dynamically resolves dependencies from three new sub-packages: \fastmcp-slim\ (the core, dependency-light base), \fastmcp-remote\ (a stdio bridge for remote MCP servers), and \fastmcp-tasks\ (background task execution support). This change replaces the previous monolithic dependency list with optional extras (e.g., \fastmcp\[client,server\]\) that pull in the necessary components from these sub-packages, allowing users to install only the functionality they need.

(dependencies) · high confidence

Housekeeping

Repository governance and development workflow configuration

Establishes the project's development standards and automation by adding a Code of Conduct, Security Policy, and Contributing guidelines, alongside configuration for pre-commit hooks (Ruff, Prettier, ty, loq), Renovate dependency management, and CodeRabbit review exclusions. This also includes a comprehensive AGENTS.md guide for LLM-driven agents and human developers, a justfile for common tasks, and updated .gitignore rules to support the new tooling and workspace structure.

(repo-wide) · high confidence

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

How this codebase got here

Score

  • CAI 60 → 63 (+3.1)
  • Rubric changed (rubric-2026.11.2 → rubric-2026.11.4) — scores are not directly comparable.

Lenses

  • Code Health 55 → 54 (-0.8)
  • Architecture 85 → 88 (+2.2)
  • Maturity 73 → 77 (+4.3)
  • Readiness 62 → 82 (+20.4)
  • Security 80 → 80 (-0.0)
  • Accessibility 69 → 84 (+14.3)
  • Performance 60 → 60 (+0.0)

Resolved (65)

  • Change coupling: function_prompt.py ↔ function_tool.py (fastmcp_slim/fastmcp/prompts/function_prompt.py)
  • Critical CVE: [GHSA redacted] (uv.lock)
  • Duplicated block (10 lines × 10) (examples/auth/azure_oauth/client.py)
  • Duplicated block (10 lines × 2) (fastmcp_slim/fastmcp/server/providers/filesystem_discovery.py)
  • Duplicated block (10 lines × 2) (fastmcp_slim/fastmcp/server/server.py)
  • Duplicated block (11 lines × 2) (fastmcp_slim/fastmcp/server/server.py)
  • Duplicated block (11–12 lines × 2) (examples/auth/aws_oauth/client.py)
  • Duplicated block (11–12 lines × 3) (fastmcp_slim/fastmcp/server/server.py)
  • Duplicated block (12 lines × 2) (examples/apps/inspector_demo.py)
  • Duplicated block (13 lines × 2) (fastmcp_slim/fastmcp/client/sampling/handlers/anthropic.py)
  • Duplicated block (13 lines × 2) (fastmcp_slim/fastmcp/server/server.py)
  • Duplicated block (13 lines × 2) (fastmcp_slim/fastmcp/server/server.py)
  • Duplicated block (13 lines × 2) (fastmcp_slim/fastmcp/server/server.py)
  • Duplicated block (13–17 lines × 2) (fastmcp_slim/fastmcp/prompts/function_prompt.py)
  • Duplicated block (14 lines × 3) (fastmcp_slim/fastmcp/server/middleware/authorization.py)
  • Duplicated block (16 lines × 2) (fastmcp_slim/fastmcp/server/server.py)
  • Duplicated block (16–18 lines × 2) (examples/atproto_mcp/demo.py)
  • Duplicated block (16–18 lines × 2) (fastmcp_slim/fastmcp/prompts/function_prompt.py)
  • Duplicated block (18 lines × 2) (examples/apps/explorer/explorer_server.py)
  • Duplicated block (18–35 lines × 2) (examples/code_mode/client.py)
  • …and 45 more

New (126)

  • Change coupling: anthropic.py ↔ google_genai.py (fastmcp_slim/fastmcp/client/sampling/handlers/anthropic.py)
  • Change coupling: anthropic.py ↔ openai.py (fastmcp_slim/fastmcp/client/sampling/handlers/anthropic.py)
  • Change coupling: azure.py ↔ google.py (fastmcp_slim/fastmcp/server/auth/providers/azure.py)
  • Change-coupling hub: github.py → azure.py, google.py, workos.py (fastmcp_slim/fastmcp/server/auth/providers/github.py)
  • Duplicated block (10–11 lines × 2) (fastmcp_slim/fastmcp/utilities/json_schema_type.py)
  • Duplicated block (13 lines × 2) (examples/apps/contacts/contacts_server.py)
  • Duplicated block (17 lines × 3) (fastmcp_slim/fastmcp/server/server.py)
  • Duplicated block (19 lines × 2) (scripts/auto_close_needs_mre.py)
  • Duplicated block (20–26 lines × 2) (fastmcp_slim/fastmcp/server/auth/providers/github.py)
  • Duplicated block (28–29 lines × 2) (fastmcp_slim/fastmcp/utilities/json_schema_type.py)
  • Duplicated block (7 lines × 11) (examples/auth/aws_oauth/client.py)
  • Duplicated block (9 lines × 10) (examples/auth/azure_oauth/client.py)
  • Edited copies of one member (3 members, 13+ corresponding lines) (fastmcp_slim/fastmcp/server/mixins/mcp_operations.py)
  • Edited copies of one member (3 members, 14+ corresponding lines) (fastmcp_slim/fastmcp/server/providers/fastmcp_provider.py)
  • Edited copies of one member (3 members, 15+ corresponding lines) (fastmcp_slim/fastmcp/resources/base.py)
  • Edited copies of one member (3 members, 15+ corresponding lines) (fastmcp_slim/fastmcp/server/providers/proxy.py)
  • Edited copies of one member (3 members, 23+ corresponding lines) (fastmcp_slim/fastmcp/client/transports/stdio.py)
  • Edited copies of one member (3 members, 24+ corresponding lines) (fastmcp_slim/fastmcp/server/middleware/caching.py)
  • Edited copies of one member (3 members, 24+ corresponding lines) (fastmcp_slim/fastmcp/server/providers/base.py)
  • Edited copies of one member (3 members, 31+ corresponding lines) (fastmcp_slim/fastmcp/server/server.py)
  • …and 106 more

Changes since last survey

  • 159 commits — 97 feature/other, 62 fixes

By area

  • fastmcp_slim/fastmcp — 94 commits
  • docs/servers — 11 commits
  • .github/agentic — 8 commits
  • (root) — 5 commits
  • tests/cli — 5 commits
  • tests/server — 5 commits
  • .github/workflows — 3 commits
  • docs/changelog.mdx — 3 commits
  • docs/clients — 3 commits
  • fastmcp_tasks/fastmcp_tasks — 3 commits
  • tests/client — 3 commits
  • .agents/skills — 2 commits
  • docs/apps — 2 commits
  • examples/smart_home — 2 commits
  • docs/assets — 1 commit
  • docs/css — 1 commit
  • docs/deployment — 1 commit
  • docs/getting-started — 1 commit
  • docs/integrations — 1 commit
  • examples/auth — 1 commit

Notable commits

  • fix: Fix #5559: Configuration helpers still discard explicit port=0 (#5562)
  • fix: Fix #5563: OTel: prefer AccessToken.subject over client_id for enduser.id (#5565)
  • fix: Fix #5706: Resource template with a level-3 operator such as {&size} is listed bu (#5711)
  • fix: Fix generated CLIs for tools named app, console or Client (#6056)
  • fix: Fix hydration of mutually recursive schema types (#6394)
  • fix: Fix resource templates with multiple query expressions (#6061)
  • fix: Fix skill discovery for nested supporting files (#6310)
  • fix: Fix the CLI .js deprecation warning and a dead error-message link (#6453)
  • fix: Fix unbounded Apps dev log retention (#5549)
  • fix: Revert 12 contributions merged without enough review (#6434)
  • fix: Revert the consent double-submit re-acceptance (#6451)
  • fix: Update example locks past the schema-parsing security fix (#6339)
  • fix: fix(agentic): repair baseline collection verification (#6313)
  • fix: fix(agentic): suppress equivalent public triage feedback (#6314)
  • fix: fix(auth): accept private-use scheme redirect URIs in CIMD documents (#6335)
  • fix: fix(auth): authorize hashed app-tool names and synthesized Prefab resources (#5841)
  • fix: fix(auth): avoid rereading failed authorization forms (#5570)
  • fix: fix(auth): collapse a repeated iss in the client redirect (#6352)
  • fix: fix(auth): include DNS in SSRF deadline (#5509)
  • fix: fix(auth): keep revocation ownership separate from user identity (#6404)
  • …and 139 more

Architecture

  • Unchanged — 0 containers · 1 contexts · 0 edges

Written by cca.canine.dev from the codebase's own history, inside the signed delivery this page is composed from.

Survey your own repository

PrefectHQ/fastmcp was measured the same way every project in this corpus was: the same rubric, at a pinned commit, with the result published in full. Point a surveyor at a repository you know and see whether you agree with it.

About this page

  • The score is its most recent published measurement, taken on 16 November 2026 at a pinned commit. It is not a live figure and does not change until the project is measured again.
  • Measured at commit ffc65c7a8063bf66522fafd3d8db280d49a34e4e — the exact code this score is about.
  • Scored under rubric-2026.11.4 — the same rubric and the same method as every other entry in this index.
  • Measured by Canine Code Analyzer (cca.canine.dev) using cca measure-2026.11.73+preprod-52de90b74216.