From 7da3b831d6142d8ef5ea96106df723e8d77a8f17 Mon Sep 17 00:00:00 2001
From: Jeremiah Lowin <153965+jlowin@users.noreply.github.com>
Date: Sun, 19 Oct 2025 20:33:35 -0400
Subject: [PATCH] Update changelog for 2.12.5 (#2146)

---
 docs/changelog.mdx | 15 +++++++++++++++
 docs/docs.json     |  2 +-
 docs/updates.mdx   | 10 ++++++++++
 3 files changed, 26 insertions(+), 1 deletion(-)

diff --git a/docs/changelog.mdx b/docs/changelog.mdx
index fabf26c6e..8fde12fe8 100644
--- a/docs/changelog.mdx
+++ b/docs/changelog.mdx
@@ -4,6 +4,21 @@ icon: "list-check"
 rss: true
 ---
 
+<Update label="v2.12.5" description="2025-10-17">
+
+**[v2.12.5: Safety Pin](https://github.com/jlowin/fastmcp/releases/tag/v2.12.5)**
+
+FastMCP 2.12.5 is a point release that pins the MCP SDK version below 1.17, which introduced a change affecting FastMCP users with auth providers mounted as part of a larger application. This ensures the `.well-known` payload appears in the expected location when using FastMCP authentication providers with composite applications.
+
+## What's Changed
+
+### Fixes 🐞
+* Pin MCP SDK version below 1.17 by [@jlowin](https://github.com/jlowin) in [a1b2c3d](https://github.com/jlowin/fastmcp/commit/dab2b316ddc3883b7896a86da21cacb68da01e5c)
+
+**Full Changelog**: [v2.12.4...v2.12.5](https://github.com/jlowin/fastmcp/compare/v2.12.4...v2.12.5)
+
+</Update>
+
 <Update label="v2.12.4" description="2025-09-26">
 
 **[v2.12.4: OIDC What You Did There](https://github.com/jlowin/fastmcp/releases/tag/v2.12.4)**
diff --git a/docs/docs.json b/docs/docs.json
index c5eb8c980..fe2891bdc 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -470,7 +470,7 @@
     "codeblocks": {
       "theme": {
         "light": "snazzy-light",
-        "dark": "material-theme-palenight"
+        "dark": "dark-plus"
       }
     }
   }
diff --git a/docs/updates.mdx b/docs/updates.mdx
index d8862e20e..134dc895c 100644
--- a/docs/updates.mdx
+++ b/docs/updates.mdx
@@ -5,6 +5,16 @@ icon: "sparkles"
 tag: NEW
 ---
 
+<Update label="FastMCP 2.12.5" description="October 17, 2025" tags={["Releases"]}>
+<Card
+title="FastMCP 2.12.5: Safety Pin"
+href="https://github.com/jlowin/fastmcp/releases/tag/v2.12.5"
+cta="Read the release notes"
+>
+Pins MCP SDK version below 1.17 to ensure the `.well-known` payload appears in the expected location when using FastMCP auth providers with composite applications.
+</Card>
+</Update>
+
 <Update label="FastMCP 2.12.4" description="September 26, 2025" tags={["Releases"]}>
 <Card
 title="FastMCP 2.12.4: OIDC What You Did There"