PrefectHQ/fastmcp
63.3
Adequate · 16 November 2026
94.1k
lines of production code
Python
primary language
5
measurements over time
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
Experimental code-mode sandbox and Jev-based tool search
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.