fastmcp 2.12.2__tar.gz → 2.12.4__tar.gz

{fastmcp-2.12.2 → fastmcp-2.12.4}/.github/pull_request_template.md

@@ -14,7 +14,7 @@ NOTE:
 If you do not follow these steps, your Pull Request will be closed without review.
 -->
 
-- [ ] My change is related to issue #(issue number)
+- [ ] My change closes #(issue number)
 - [ ] I have followed the repository's development workflow
 - [ ] I have tested my changes manually and by adding relevant tests
 - [ ] I have performed all required documentation updates
@@ -25,4 +25,4 @@ If you do not follow these steps, your Pull Request will be closed without revie
 - [ ] I have self-reviewed my changes
 - [ ] My Pull Request is ready for review
 
----
+---

{fastmcp-2.12.2 → fastmcp-2.12.4}/.github/workflows/run-tests.yml

@@ -48,10 +48,10 @@ jobs:
         run: uv sync --frozen
 
       - name: Run tests (excluding integration and client_process)
-        run: uv run pytest -v tests -m "not integration and not client_process"
+        run: uv run pytest --inline-snapshot=disable -v tests -m "not integration and not client_process" --numprocesses auto --maxprocesses 4 --dist worksteal
 
       - name: Run client process tests separately
-        run: uv run pytest -v tests -m "client_process" -x
+        run: uv run pytest --inline-snapshot=disable -v tests -m "client_process" -x
 
   run_integration_tests:
     name: "Run integration tests"
@@ -74,7 +74,7 @@ jobs:
 
       - name: Run integration tests
         # use longer per-test timeout than the default 3s
-        run: uv run pytest -v tests -m "integration" --timeout=15
+        run: uv run pytest -v tests -m "integration" --timeout=15 --numprocesses auto --maxprocesses 2 --dist worksteal
         env:
           FASTMCP_GITHUB_TOKEN: ${{ secrets.FASTMCP_GITHUB_TOKEN }}
           FASTMCP_TEST_AUTH_GITHUB_CLIENT_ID: ${{ secrets.FASTMCP_TEST_AUTH_GITHUB_CLIENT_ID }}

{fastmcp-2.12.2 → fastmcp-2.12.4}/.pre-commit-config.yaml

@@ -39,3 +39,10 @@ repos:
       - id: no-commit-to-branch
         name: prevent commits to main
         args: [--branch, main]
+
+  - repo: https://github.com/codespell-project/codespell
+    rev: v2.4.1
+    hooks:
+      - id: codespell # See pyproject.toml for args
+        additional_dependencies:
+          - tomli

{fastmcp-2.12.2 → fastmcp-2.12.4}/AGENTS.md

@@ -20,24 +20,24 @@ uv run pytest                        # Run full test suite
 
 ## Repository Structure
 
-| Path             | Purpose                                                |
-| ---------------- | ------------------------------------------------------ |
-| `src/fastmcp/`   | Library source code (Python ≥ 3.10)                   |
-| `├─server/`    | Server implementation, `FastMCP`, auth, networking    |
-| `│  ├─auth/`   | Authentication providers (Bearer, JWT, WorkOS)        |
-| `│  └─middleware/` | Error handling, logging, rate limiting             |
-| `├─client/`    | High-level client SDK + transports                    |
-| `│  └─auth/`   | Client authentication (Bearer, OAuth)                 |
-| `├─tools/`     | Tool implementations + `ToolManager`                  |
-| `├─resources/` | Resources, templates + `ResourceManager`              |
-| `├─prompts/`   | Prompt templates + `PromptManager`                     |
-| `├─cli/`       | FastMCP CLI commands (`run`, `dev`, `install`)         |
-| `├─contrib/`   | Community contributions (bulk caller, mixins)         |
-| `├─experimental/` | Experimental features (new OpenAPI parser)         |
-| `└─utilities/` | Shared utilities (logging, JSON schema, HTTP)         |
-| `tests/`         | Comprehensive pytest suite with markers               |
-| `docs/`          | Mintlify documentation (published to gofastmcp.com)   |
-| `examples/`      | Runnable demo servers (echo, smart_home, atproto)     |
+| Path               | Purpose                                             |
+| ------------------ | --------------------------------------------------- |
+| `src/fastmcp/`     | Library source code (Python ≥ 3.10)                 |
+| `├─server/`        | Server implementation, `FastMCP`, auth, networking  |
+| `│  ├─auth/`       | Authentication providers (Bearer, JWT, WorkOS)      |
+| `│  └─middleware/` | Error handling, logging, rate limiting              |
+| `├─client/`        | High-level client SDK + transports                  |
+| `│  └─auth/`       | Client authentication (Bearer, OAuth)               |
+| `├─tools/`         | Tool implementations + `ToolManager`                |
+| `├─resources/`     | Resources, templates + `ResourceManager`            |
+| `├─prompts/`       | Prompt templates + `PromptManager`                  |
+| `├─cli/`           | FastMCP CLI commands (`run`, `dev`, `install`)      |
+| `├─contrib/`       | Community contributions (bulk caller, mixins)       |
+| `├─experimental/`  | Experimental features (new OpenAPI parser)          |
+| `└─utilities/`     | Shared utilities (logging, JSON schema, HTTP)       |
+| `tests/`           | Comprehensive pytest suite with markers             |
+| `docs/`            | Mintlify documentation (published to gofastmcp.com) |
+| `examples/`        | Runnable demo servers (echo, smart_home, atproto)   |
 
 ## Core MCP Objects
 
@@ -64,13 +64,13 @@ When modifying MCP functionality, changes typically need to be applied across al
 - Every test: atomic, self-contained, single functionality
 - Use parameterization for multiple examples of same functionality
 - Use separate tests for different functionality pieces
-- Put imports at the top of the file, not in the test body
+- **ALWAYS** Put imports at the top of the file, not in the test body
 - **NEVER** add `@pytest.mark.asyncio` to tests - `asyncio_mode = "auto"` is set globally
 - **ALWAYS** run pytest after significant changes
 
 ### Inline Snapshots
 
-FastMCP uses `inline-snapshot` for testing complex data structures. On first run with empty `snapshot()`, pytest will auto-populate the expected value. To update snapshots after intentional changes, run `pytest --inline-snapshot=fix`. This is particularly useful for testing JSON schemas and API responses.
+FastMCP uses `inline-snapshot` for testing complex data structures. On first run with empty `snapshot()`, pytest will auto-populate the expected value when running `pytest --inline-snapshot=create`. To update snapshots after intentional changes, run `pytest --inline-snapshot=fix`. This is particularly useful for testing JSON schemas and API responses.
 
 ### Always Use In-Memory Transport
 

{fastmcp-2.12.2 → fastmcp-2.12.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: fastmcp
-Version: 2.12.2
+Version: 2.12.4
 Summary: The fast, Pythonic way to build MCP servers and clients.
 Project-URL: Homepage, https://gofastmcp.com
 Project-URL: Repository, https://github.com/jlowin/fastmcp
@@ -37,6 +37,13 @@ Description-Content-Type: text/markdown
 <div align="center">
 
 <!-- omit in toc -->
+
+<picture>
+  <source width="550" media="(prefers-color-scheme: dark)" srcset="docs/assets/brand/wordmark-watercolor-waves-dark.png">
+  <source width="550" media="(prefers-color-scheme: light)" srcset="docs/assets/brand/wordmark-watercolor-waves.png">
+  <img width="550" alt="FastMCP Logo" src="docs/assets/brand/wordmark-watercolor-waves.png">
+</picture>
+
 # FastMCP v2 🚀
 
 <strong>The fast, Pythonic way to build MCP servers and clients.</strong>
@@ -53,19 +60,19 @@ Description-Content-Type: text/markdown
 
 > [!Note]
 >
-> #### Beyond the Protocol
->
-> FastMCP is the standard framework for working with the Model Context Protocol. FastMCP 1.0 was incorporated into the [official MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) in 2024.
+> #### FastMCP 2.0: The Standard Framework
 >
-> This is FastMCP 2.0, the **actively maintained version** that provides a complete toolkit for working with the MCP ecosystem.
+> FastMCP pioneered Python MCP development, and FastMCP 1.0 was incorporated into the [official MCP SDK](https://github.com/modelcontextprotocol/python-sdk) in 2024.
 >
-> FastMCP 2.0 has a comprehensive set of features that go far beyond the core MCP specification, all in service of providing **the simplest path to production**. These include deployment, auth, clients, server proxying and composition, generating servers from REST APIs, dynamic tool rewriting, built-in testing tools, integrations, and more.
+> **This is FastMCP 2.0** — the actively maintained, production-ready framework that extends far beyond basic protocol implementation. While the SDK provides core functionality, FastMCP 2.0 delivers everything needed for production: advanced MCP patterns (server composition, proxying, OpenAPI/FastAPI generation, tool transformation), enterprise auth (Google, GitHub, WorkOS, Azure, Auth0, and more), deployment tools, testing utilities, and comprehensive client libraries.
 >
-> Ready to upgrade or get started? Follow the [installation instructions](https://gofastmcp.com/getting-started/installation), which include steps for upgrading from the official MCP SDK.
+> **For production MCP applications, install FastMCP:** `pip install fastmcp`
 
 ---
 
-The [Model Context Protocol (MCP)](https://modelcontextprotocol.io) is a new, standardized way to provide context and tools to your LLMs, and FastMCP makes building MCP servers and clients simple and intuitive. Create tools, expose resources, define prompts, and connect components with clean, Pythonic code.
+**FastMCP is the standard framework for building MCP applications**, providing the fastest path from idea to production.
+
+The [Model Context Protocol (MCP)](https://modelcontextprotocol.io) is a standardized way to provide context and tools to LLMs. FastMCP makes building production-ready MCP servers simple, with enterprise auth, deployment tools, and a complete ecosystem built in.
 
 ```python
 # server.py
@@ -104,28 +111,33 @@ There are two ways to access the LLM-friendly documentation:
 <!-- omit in toc -->
 ## Table of Contents
 
-- [What is MCP?](#what-is-mcp)
-- [Why FastMCP?](#why-fastmcp)
-- [Installation](#installation)
-- [Core Concepts](#core-concepts)
-  - [The `FastMCP` Server](#the-fastmcp-server)
-  - [Tools](#tools)
-  - [Resources \& Templates](#resources--templates)
-  - [Prompts](#prompts)
-  - [Context](#context)
-  - [MCP Clients](#mcp-clients)
-- [Advanced Features](#advanced-features)
-  - [Proxy Servers](#proxy-servers)
-  - [Composing MCP Servers](#composing-mcp-servers)
-  - [OpenAPI \& FastAPI Generation](#openapi--fastapi-generation)
-  - [Authentication \& Security](#authentication--security)
-- [Running Your Server](#running-your-server)
-- [Contributing](#contributing)
-  - [Prerequisites](#prerequisites)
-  - [Setup](#setup)
-  - [Unit Tests](#unit-tests)
-  - [Static Checks](#static-checks)
-  - [Pull Requests](#pull-requests)
+- [FastMCP v2 🚀](#fastmcp-v2-)
+  - [📚 Documentation](#-documentation)
+  - [What is MCP?](#what-is-mcp)
+  - [Why FastMCP?](#why-fastmcp)
+  - [Installation](#installation)
+  - [Core Concepts](#core-concepts)
+    - [The `FastMCP` Server](#the-fastmcp-server)
+    - [Tools](#tools)
+    - [Resources \& Templates](#resources--templates)
+    - [Prompts](#prompts)
+    - [Context](#context)
+    - [MCP Clients](#mcp-clients)
+  - [Authentication](#authentication)
+    - [Enterprise Authentication, Zero Configuration](#enterprise-authentication-zero-configuration)
+  - [Deployment](#deployment)
+    - [From Development to Production](#from-development-to-production)
+  - [Advanced Features](#advanced-features)
+    - [Proxy Servers](#proxy-servers)
+    - [Composing MCP Servers](#composing-mcp-servers)
+    - [OpenAPI \& FastAPI Generation](#openapi--fastapi-generation)
+  - [Running Your Server](#running-your-server)
+  - [Contributing](#contributing)
+    - [Prerequisites](#prerequisites)
+    - [Setup](#setup)
+    - [Unit Tests](#unit-tests)
+    - [Static Checks](#static-checks)
+    - [Pull Requests](#pull-requests)
 
 ---
 
@@ -142,11 +154,7 @@ FastMCP provides a high-level, Pythonic interface for building, managing, and in
 
 ## Why FastMCP?
 
-The MCP protocol is powerful but implementing it involves a lot of boilerplate - server setup, protocol handlers, content types, error management. FastMCP handles all the complex protocol details and server management, so you can focus on building great tools. It's designed to be high-level and Pythonic; in most cases, decorating a function is all you need.
-
-FastMCP 2.0 has evolved into a comprehensive platform that goes far beyond basic protocol implementation. While 1.0 provided server-building capabilities (and is now part of the official MCP SDK), 2.0 offers a complete ecosystem including client libraries, authentication systems, deployment tools, integrations with major AI platforms, testing frameworks, and production-ready infrastructure patterns.
-
-FastMCP aims to be:
+FastMCP handles all the complex protocol details so you can focus on building. In most cases, decorating a Python function is all you need — FastMCP handles the rest.
 
 🚀 **Fast:** High-level interface means less code and faster development
 
@@ -154,7 +162,9 @@ FastMCP aims to be:
 
 🐍 **Pythonic:** Feels natural to Python developers
 
-🔍 **Complete:** A comprehensive platform for all MCP use cases, from dev to prod
+🔍 **Complete:** Everything for production — enterprise auth (Google, GitHub, Azure, Auth0, WorkOS), deployment tools, testing frameworks, client libraries, and more
+
+FastMCP provides the shortest path from idea to production. Deploy locally, to the cloud with [FastMCP Cloud](https://fastmcp.cloud), or to your own infrastructure.
 
 ## Installation
 
@@ -278,7 +288,7 @@ async def main():
         tools = await client.list_tools()
         print(f"Available tools: {tools}")
         result = await client.call_tool("add", {"a": 5, "b": 3})
-        print(f"Result: {result.text}")
+        print(f"Result: {result.content[0].text}")
 
     # Connect via SSE
     async with Client("http://localhost:8000/sse") as client:
@@ -324,9 +334,82 @@ async def main():
 
 Learn more in the [**Client Documentation**](https://gofastmcp.com/clients/client) and [**Transports Documentation**](https://gofastmcp.com/clients/transports).
 
+## Authentication
+
+### Enterprise Authentication, Zero Configuration
+
+FastMCP provides comprehensive authentication support that sets it apart from basic MCP implementations. Secure your servers and authenticate your clients with the same enterprise-grade providers used by major corporations.
+
+**Built-in OAuth Providers:**
+
+- **Google**
+- **GitHub**
+- **Microsoft Azure**
+- **Auth0**
+- **WorkOS**
+- **Descope**
+- **JWT/Custom**
+- **API Keys**
+
+Protecting a server takes just two lines:
+
+```python
+from fastmcp.server.auth import GoogleProvider
+
+auth = GoogleProvider(client_id="...", client_secret="...", base_url="https://myserver.com")
+mcp = FastMCP("Protected Server", auth=auth)
+```
+
+Connecting to protected servers is even simpler:
+
+```python
+async with Client("https://protected-server.com/mcp", auth="oauth") as client:
+    # Automatic browser-based OAuth flow
+    result = await client.call_tool("protected_tool")
+```
+
+**Why FastMCP Auth Matters:**
+
+- **Production-Ready:** Persistent storage, token refresh, comprehensive error handling
+- **Zero-Config OAuth:** Just pass `auth="oauth"` for automatic setup
+- **Enterprise Integration:** WorkOS SSO, Azure Active Directory, Auth0 tenants
+- **Developer Experience:** Automatic browser launch, local callback server, environment variable support
+- **Advanced Architecture:** Full OIDC support, Dynamic Client Registration (DCR), and unique OAuth proxy pattern that enables DCR with any provider
+
+*Authentication this comprehensive is unique to FastMCP 2.0.*
+
+Learn more in the **Authentication Documentation** for [servers](https://gofastmcp.com/servers/auth) and [clients](https://gofastmcp.com/clients/auth).
+
+## Deployment
+
+### From Development to Production
+
+FastMCP supports every deployment scenario from local development to global scale:
+
+**Development:** Run locally with a single command
+
+```bash
+fastmcp run server.py
+```
+
+**Production:** Deploy to [**FastMCP Cloud**](https://fastmcp.cloud) — Remote MCP that just works
+
+- Instant HTTPS endpoints
+- Built-in authentication
+- Zero configuration
+- Free for personal servers
+
+**Self-Hosted:** Use HTTP or SSE transports for your own infrastructure
+
+```python
+mcp.run(transport="http", host="0.0.0.0", port=8000)
+```
+
+Learn more in the [**Deployment Documentation**](https://gofastmcp.com/deployment).
+
 ## Advanced Features
 
-FastMCP introduces powerful ways to structure and deploy your MCP applications.
+FastMCP introduces powerful ways to structure and compose your MCP applications.
 
 ### Proxy Servers
 
@@ -346,16 +429,6 @@ Automatically generate FastMCP servers from existing OpenAPI specifications (`Fa
 
 Learn more: [**OpenAPI Integration**](https://gofastmcp.com/integrations/openapi) | [**FastAPI Integration**](https://gofastmcp.com/integrations/fastapi).
 
-### Authentication & Security
-
-FastMCP provides built-in authentication support to secure both your MCP servers and clients in production environments. Protect your server endpoints from unauthorized access and authenticate your clients against secured MCP servers using industry-standard protocols.
-
-- **Server Protection**: Secure your FastMCP server endpoints with configurable authentication providers
-- **Client Authentication**: Connect to authenticated MCP servers with automatic credential management
-- **Production Ready**: Support for common authentication patterns used in enterprise environments
-
-Learn more in the **Authentication Documentation** for [servers](https://gofastmcp.com/servers/auth) and [clients](https://gofastmcp.com/clients/auth).
-
 ## Running Your Server
 
 The main way to run a FastMCP server is by calling the `run()` method on your server instance:

{fastmcp-2.12.2 → fastmcp-2.12.4}/README.md

@@ -1,6 +1,13 @@
 <div align="center">
 
 <!-- omit in toc -->
+
+<picture>
+  <source width="550" media="(prefers-color-scheme: dark)" srcset="docs/assets/brand/wordmark-watercolor-waves-dark.png">
+  <source width="550" media="(prefers-color-scheme: light)" srcset="docs/assets/brand/wordmark-watercolor-waves.png">
+  <img width="550" alt="FastMCP Logo" src="docs/assets/brand/wordmark-watercolor-waves.png">
+</picture>
+
 # FastMCP v2 🚀
 
 <strong>The fast, Pythonic way to build MCP servers and clients.</strong>
@@ -17,19 +24,19 @@
 
 > [!Note]
 >
-> #### Beyond the Protocol
->
-> FastMCP is the standard framework for working with the Model Context Protocol. FastMCP 1.0 was incorporated into the [official MCP Python SDK](https://github.com/modelcontextprotocol/python-sdk) in 2024.
+> #### FastMCP 2.0: The Standard Framework
 >
-> This is FastMCP 2.0, the **actively maintained version** that provides a complete toolkit for working with the MCP ecosystem.
+> FastMCP pioneered Python MCP development, and FastMCP 1.0 was incorporated into the [official MCP SDK](https://github.com/modelcontextprotocol/python-sdk) in 2024.
 >
-> FastMCP 2.0 has a comprehensive set of features that go far beyond the core MCP specification, all in service of providing **the simplest path to production**. These include deployment, auth, clients, server proxying and composition, generating servers from REST APIs, dynamic tool rewriting, built-in testing tools, integrations, and more.
+> **This is FastMCP 2.0** — the actively maintained, production-ready framework that extends far beyond basic protocol implementation. While the SDK provides core functionality, FastMCP 2.0 delivers everything needed for production: advanced MCP patterns (server composition, proxying, OpenAPI/FastAPI generation, tool transformation), enterprise auth (Google, GitHub, WorkOS, Azure, Auth0, and more), deployment tools, testing utilities, and comprehensive client libraries.
 >
-> Ready to upgrade or get started? Follow the [installation instructions](https://gofastmcp.com/getting-started/installation), which include steps for upgrading from the official MCP SDK.
+> **For production MCP applications, install FastMCP:** `pip install fastmcp`
 
 ---
 
-The [Model Context Protocol (MCP)](https://modelcontextprotocol.io) is a new, standardized way to provide context and tools to your LLMs, and FastMCP makes building MCP servers and clients simple and intuitive. Create tools, expose resources, define prompts, and connect components with clean, Pythonic code.
+**FastMCP is the standard framework for building MCP applications**, providing the fastest path from idea to production.
+
+The [Model Context Protocol (MCP)](https://modelcontextprotocol.io) is a standardized way to provide context and tools to LLMs. FastMCP makes building production-ready MCP servers simple, with enterprise auth, deployment tools, and a complete ecosystem built in.
 
 ```python
 # server.py
@@ -68,28 +75,33 @@ There are two ways to access the LLM-friendly documentation:
 <!-- omit in toc -->
 ## Table of Contents
 
-- [What is MCP?](#what-is-mcp)
-- [Why FastMCP?](#why-fastmcp)
-- [Installation](#installation)
-- [Core Concepts](#core-concepts)
-  - [The `FastMCP` Server](#the-fastmcp-server)
-  - [Tools](#tools)
-  - [Resources \& Templates](#resources--templates)
-  - [Prompts](#prompts)
-  - [Context](#context)
-  - [MCP Clients](#mcp-clients)
-- [Advanced Features](#advanced-features)
-  - [Proxy Servers](#proxy-servers)
-  - [Composing MCP Servers](#composing-mcp-servers)
-  - [OpenAPI \& FastAPI Generation](#openapi--fastapi-generation)
-  - [Authentication \& Security](#authentication--security)
-- [Running Your Server](#running-your-server)
-- [Contributing](#contributing)
-  - [Prerequisites](#prerequisites)
-  - [Setup](#setup)
-  - [Unit Tests](#unit-tests)
-  - [Static Checks](#static-checks)
-  - [Pull Requests](#pull-requests)
+- [FastMCP v2 🚀](#fastmcp-v2-)
+  - [📚 Documentation](#-documentation)
+  - [What is MCP?](#what-is-mcp)
+  - [Why FastMCP?](#why-fastmcp)
+  - [Installation](#installation)
+  - [Core Concepts](#core-concepts)
+    - [The `FastMCP` Server](#the-fastmcp-server)
+    - [Tools](#tools)
+    - [Resources \& Templates](#resources--templates)
+    - [Prompts](#prompts)
+    - [Context](#context)
+    - [MCP Clients](#mcp-clients)
+  - [Authentication](#authentication)
+    - [Enterprise Authentication, Zero Configuration](#enterprise-authentication-zero-configuration)
+  - [Deployment](#deployment)
+    - [From Development to Production](#from-development-to-production)
+  - [Advanced Features](#advanced-features)
+    - [Proxy Servers](#proxy-servers)
+    - [Composing MCP Servers](#composing-mcp-servers)
+    - [OpenAPI \& FastAPI Generation](#openapi--fastapi-generation)
+  - [Running Your Server](#running-your-server)
+  - [Contributing](#contributing)
+    - [Prerequisites](#prerequisites)
+    - [Setup](#setup)
+    - [Unit Tests](#unit-tests)
+    - [Static Checks](#static-checks)
+    - [Pull Requests](#pull-requests)
 
 ---
 
@@ -106,11 +118,7 @@ FastMCP provides a high-level, Pythonic interface for building, managing, and in
 
 ## Why FastMCP?
 
-The MCP protocol is powerful but implementing it involves a lot of boilerplate - server setup, protocol handlers, content types, error management. FastMCP handles all the complex protocol details and server management, so you can focus on building great tools. It's designed to be high-level and Pythonic; in most cases, decorating a function is all you need.
-
-FastMCP 2.0 has evolved into a comprehensive platform that goes far beyond basic protocol implementation. While 1.0 provided server-building capabilities (and is now part of the official MCP SDK), 2.0 offers a complete ecosystem including client libraries, authentication systems, deployment tools, integrations with major AI platforms, testing frameworks, and production-ready infrastructure patterns.
-
-FastMCP aims to be:
+FastMCP handles all the complex protocol details so you can focus on building. In most cases, decorating a Python function is all you need — FastMCP handles the rest.
 
 🚀 **Fast:** High-level interface means less code and faster development
 
@@ -118,7 +126,9 @@ FastMCP aims to be:
 
 🐍 **Pythonic:** Feels natural to Python developers
 
-🔍 **Complete:** A comprehensive platform for all MCP use cases, from dev to prod
+🔍 **Complete:** Everything for production — enterprise auth (Google, GitHub, Azure, Auth0, WorkOS), deployment tools, testing frameworks, client libraries, and more
+
+FastMCP provides the shortest path from idea to production. Deploy locally, to the cloud with [FastMCP Cloud](https://fastmcp.cloud), or to your own infrastructure.
 
 ## Installation
 
@@ -242,7 +252,7 @@ async def main():
         tools = await client.list_tools()
         print(f"Available tools: {tools}")
         result = await client.call_tool("add", {"a": 5, "b": 3})
-        print(f"Result: {result.text}")
+        print(f"Result: {result.content[0].text}")
 
     # Connect via SSE
     async with Client("http://localhost:8000/sse") as client:
@@ -288,9 +298,82 @@ async def main():
 
 Learn more in the [**Client Documentation**](https://gofastmcp.com/clients/client) and [**Transports Documentation**](https://gofastmcp.com/clients/transports).
 
+## Authentication
+
+### Enterprise Authentication, Zero Configuration
+
+FastMCP provides comprehensive authentication support that sets it apart from basic MCP implementations. Secure your servers and authenticate your clients with the same enterprise-grade providers used by major corporations.
+
+**Built-in OAuth Providers:**
+
+- **Google**
+- **GitHub**
+- **Microsoft Azure**
+- **Auth0**
+- **WorkOS**
+- **Descope**
+- **JWT/Custom**
+- **API Keys**
+
+Protecting a server takes just two lines:
+
+```python
+from fastmcp.server.auth import GoogleProvider
+
+auth = GoogleProvider(client_id="...", client_secret="...", base_url="https://myserver.com")
+mcp = FastMCP("Protected Server", auth=auth)
+```
+
+Connecting to protected servers is even simpler:
+
+```python
+async with Client("https://protected-server.com/mcp", auth="oauth") as client:
+    # Automatic browser-based OAuth flow
+    result = await client.call_tool("protected_tool")
+```
+
+**Why FastMCP Auth Matters:**
+
+- **Production-Ready:** Persistent storage, token refresh, comprehensive error handling
+- **Zero-Config OAuth:** Just pass `auth="oauth"` for automatic setup
+- **Enterprise Integration:** WorkOS SSO, Azure Active Directory, Auth0 tenants
+- **Developer Experience:** Automatic browser launch, local callback server, environment variable support
+- **Advanced Architecture:** Full OIDC support, Dynamic Client Registration (DCR), and unique OAuth proxy pattern that enables DCR with any provider
+
+*Authentication this comprehensive is unique to FastMCP 2.0.*
+
+Learn more in the **Authentication Documentation** for [servers](https://gofastmcp.com/servers/auth) and [clients](https://gofastmcp.com/clients/auth).
+
+## Deployment
+
+### From Development to Production
+
+FastMCP supports every deployment scenario from local development to global scale:
+
+**Development:** Run locally with a single command
+
+```bash
+fastmcp run server.py
+```
+
+**Production:** Deploy to [**FastMCP Cloud**](https://fastmcp.cloud) — Remote MCP that just works
+
+- Instant HTTPS endpoints
+- Built-in authentication
+- Zero configuration
+- Free for personal servers
+
+**Self-Hosted:** Use HTTP or SSE transports for your own infrastructure
+
+```python
+mcp.run(transport="http", host="0.0.0.0", port=8000)
+```
+
+Learn more in the [**Deployment Documentation**](https://gofastmcp.com/deployment).
+
 ## Advanced Features
 
-FastMCP introduces powerful ways to structure and deploy your MCP applications.
+FastMCP introduces powerful ways to structure and compose your MCP applications.
 
 ### Proxy Servers
 
@@ -310,16 +393,6 @@ Automatically generate FastMCP servers from existing OpenAPI specifications (`Fa
 
 Learn more: [**OpenAPI Integration**](https://gofastmcp.com/integrations/openapi) | [**FastAPI Integration**](https://gofastmcp.com/integrations/fastapi).
 
-### Authentication & Security
-
-FastMCP provides built-in authentication support to secure both your MCP servers and clients in production environments. Protect your server endpoints from unauthorized access and authenticate your clients against secured MCP servers using industry-standard protocols.
-
-- **Server Protection**: Secure your FastMCP server endpoints with configurable authentication providers
-- **Client Authentication**: Connect to authenticated MCP servers with automatic credential management
-- **Production Ready**: Support for common authentication patterns used in enterprise environments
-
-Learn more in the **Authentication Documentation** for [servers](https://gofastmcp.com/servers/auth) and [clients](https://gofastmcp.com/clients/auth).
-
 ## Running Your Server
 
 The main way to run a FastMCP server is by calling the `run()` method on your server instance:

{fastmcp-2.12.2 → fastmcp-2.12.4}/docs/changelog.mdx

@@ -4,7 +4,21 @@ icon: "list-check"
 rss: true
 ---
 
-<Update label="v2.12.1" description="2025-09-06">
+<Update label="v2.12.2" description="2025-09-03">
+
+**[v2.12.2: Perchance to Stream](https://github.com/jlowin/fastmcp/releases/tag/v2.12.2)**
+
+This is a hotfix for a bug where the `streamable-http` transport was not recognized as a valid option in `fastmcp.json` configuration files, despite being supported by the CLI. This resulted in a parsing error when the CLI arguments were merged against the configuration spec. 
+
+## What's Changed
+### Fixes 🐞
+* Fix streamable-http transport validation in fastmcp.json config by [@jlowin](https://github.com/jlowin) in [#1739](https://github.com/jlowin/fastmcp/pull/1739)
+
+**Full Changelog**: [v2.12.1...v2.12.2](https://github.com/jlowin/fastmcp/compare/v2.12.1...v2.12.2)
+
+</Update>
+
+<Update label="v2.12.1" description="2025-09-03">
 
 **[v2.12.1: OAuth to Joy](https://github.com/jlowin/fastmcp/releases/tag/v2.12.1)**
 
@@ -1743,7 +1757,7 @@ This release is highlighted by the ability to handle complex JSON objects as MCP
 ### New Features 🎉
 
 * Set up multiple os tests by [@jlowin](https://github.com/jlowin) in [#44](https://github.com/jlowin/fastmcp/pull/44)
-* Changes to accomodate windows users. by [@justjoehere](https://github.com/justjoehere) in [#42](https://github.com/jlowin/fastmcp/pull/42)
+* Changes to accommodate windows users. by [@justjoehere](https://github.com/justjoehere) in [#42](https://github.com/jlowin/fastmcp/pull/42)
 * Handle complex inputs by [@jurasofish](https://github.com/jurasofish) in [#31](https://github.com/jlowin/fastmcp/pull/31)
 
 ### Docs 📚