diff --git a/docs/docs.json b/docs/docs.json
index 87477c70c..0b0e4f41a 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -825,201 +825,7 @@
         "version": "v3"
       },
       {
-        "dropdowns": [
-          {
-            "dropdown": "Documentation",
-            "groups": [
-              {
-                "group": "Get Started",
-                "pages": [
-                  "v2/getting-started/welcome",
-                  "v2/getting-started/installation",
-                  "v2/getting-started/quickstart",
-                  "v2/updates"
-                ]
-              },
-              {
-                "group": "Servers",
-                "pages": [
-                  "v2/servers/server",
-                  {
-                    "group": "Core Components",
-                    "icon": "toolbox",
-                    "pages": [
-                      "v2/servers/tools",
-                      "v2/servers/resources",
-                      "v2/servers/prompts"
-                    ]
-                  },
-                  {
-                    "group": "Advanced Features",
-                    "icon": "stars",
-                    "pages": [
-                      "v2/servers/composition",
-                      "v2/servers/context",
-                      "v2/servers/elicitation",
-                      "v2/servers/icons",
-                      "v2/servers/logging",
-                      "v2/servers/middleware",
-                      "v2/servers/progress",
-                      "v2/servers/proxy",
-                      "v2/servers/sampling",
-                      "v2/servers/storage-backends",
-                      "v2/servers/tasks"
-                    ]
-                  },
-                  {
-                    "group": "Authentication",
-                    "icon": "shield-check",
-                    "pages": [
-                      "v2/servers/auth/authentication",
-                      "v2/servers/auth/token-verification",
-                      "v2/servers/auth/remote-oauth",
-                      "v2/servers/auth/oauth-proxy",
-                      "v2/servers/auth/oidc-proxy",
-                      "v2/servers/auth/full-oauth-server"
-                    ]
-                  },
-                  {
-                    "group": "Deployment",
-                    "icon": "rocket",
-                    "pages": [
-                      "v2/deployment/running-server",
-                      "v2/deployment/http",
-                      "deployment/prefect-horizon",
-                      "v2/deployment/server-configuration"
-                    ]
-                  }
-                ]
-              },
-              {
-                "group": "Clients",
-                "pages": [
-                  {
-                    "group": "Essentials",
-                    "icon": "cube",
-                    "pages": [
-                      "v2/clients/client",
-                      "v2/clients/transports"
-                    ]
-                  },
-                  {
-                    "group": "Core Operations",
-                    "icon": "handshake",
-                    "pages": [
-                      "v2/clients/tools",
-                      "v2/clients/resources",
-                      "v2/clients/prompts"
-                    ]
-                  },
-                  {
-                    "group": "Advanced Features",
-                    "icon": "stars",
-                    "pages": [
-                      "v2/clients/elicitation",
-                      "v2/clients/logging",
-                      "v2/clients/progress",
-                      "v2/clients/sampling",
-                      "v2/clients/tasks",
-                      "v2/clients/messages",
-                      "v2/clients/roots"
-                    ]
-                  },
-                  {
-                    "group": "Authentication",
-                    "icon": "user-shield",
-                    "pages": [
-                      "v2/clients/auth/oauth",
-                      "v2/clients/auth/bearer"
-                    ]
-                  }
-                ]
-              },
-              {
-                "group": "Integrations",
-                "pages": [
-                  {
-                    "group": "Authentication",
-                    "icon": "key",
-                    "pages": [
-                      "v2/integrations/auth0",
-                      "v2/integrations/authkit",
-                      "v2/integrations/aws-cognito",
-                      "v2/integrations/azure",
-                      "v2/integrations/descope",
-                      "v2/integrations/discord",
-                      "v2/integrations/github",
-                      "v2/integrations/google",
-                      "v2/integrations/oci",
-                      "v2/integrations/scalekit",
-                      "v2/integrations/supabase",
-                      "v2/integrations/workos"
-                    ]
-                  },
-                  {
-                    "group": "Authorization",
-                    "icon": "shield-check",
-                    "pages": [
-                      "v2/integrations/eunomia-authorization",
-                      "v2/integrations/permit"
-                    ]
-                  },
-                  {
-                    "group": "AI Assistants",
-                    "icon": "robot",
-                    "pages": [
-                      "v2/integrations/chatgpt",
-                      "v2/integrations/claude-code",
-                      "v2/integrations/claude-desktop",
-                      "v2/integrations/cursor",
-                      "v2/integrations/gemini-cli",
-                      "v2/integrations/mcp-json-configuration"
-                    ]
-                  },
-                  {
-                    "group": "AI SDKs",
-                    "icon": "code",
-                    "pages": [
-                      "v2/integrations/anthropic",
-                      "v2/integrations/gemini",
-                      "v2/integrations/openai"
-                    ]
-                  },
-                  {
-                    "group": "API Integration",
-                    "icon": "globe",
-                    "pages": [
-                      "v2/integrations/fastapi",
-                      "v2/integrations/openapi"
-                    ]
-                  }
-                ]
-              },
-              {
-                "group": "Patterns",
-                "pages": [
-                  "v2/patterns/tool-transformation",
-                  "v2/patterns/decorating-methods",
-                  "v2/patterns/cli",
-                  "v2/patterns/contrib",
-                  "v2/patterns/testing"
-                ]
-              },
-              {
-                "group": "Development",
-                "pages": [
-                  "v2/development/contributing",
-                  "v2/development/tests",
-                  "v2/development/releases",
-                  "v2/development/upgrade-guide",
-                  "v2/changelog"
-                ]
-              }
-            ],
-            "icon": "book"
-          }
-        ],
-        "version": "v2.14.5"
+        "$ref": "./v2-navigation.json"
       }
     ]
   },
diff --git a/docs/v2-navigation.json b/docs/v2-navigation.json
new file mode 100644
index 000000000..17865edfd
--- /dev/null
+++ b/docs/v2-navigation.json
@@ -0,0 +1,197 @@
+{
+  "dropdowns": [
+    {
+      "dropdown": "Documentation",
+      "groups": [
+        {
+          "group": "Get Started",
+          "pages": [
+            "v2/getting-started/welcome",
+            "v2/getting-started/installation",
+            "v2/getting-started/quickstart",
+            "v2/updates"
+          ]
+        },
+        {
+          "group": "Servers",
+          "pages": [
+            "v2/servers/server",
+            {
+              "group": "Core Components",
+              "icon": "toolbox",
+              "pages": [
+                "v2/servers/tools",
+                "v2/servers/resources",
+                "v2/servers/prompts"
+              ]
+            },
+            {
+              "group": "Advanced Features",
+              "icon": "stars",
+              "pages": [
+                "v2/servers/composition",
+                "v2/servers/context",
+                "v2/servers/elicitation",
+                "v2/servers/icons",
+                "v2/servers/logging",
+                "v2/servers/middleware",
+                "v2/servers/progress",
+                "v2/servers/proxy",
+                "v2/servers/sampling",
+                "v2/servers/storage-backends",
+                "v2/servers/tasks"
+              ]
+            },
+            {
+              "group": "Authentication",
+              "icon": "shield-check",
+              "pages": [
+                "v2/servers/auth/authentication",
+                "v2/servers/auth/token-verification",
+                "v2/servers/auth/remote-oauth",
+                "v2/servers/auth/oauth-proxy",
+                "v2/servers/auth/oidc-proxy",
+                "v2/servers/auth/full-oauth-server"
+              ]
+            },
+            {
+              "group": "Deployment",
+              "icon": "rocket",
+              "pages": [
+                "v2/deployment/running-server",
+                "v2/deployment/http",
+                "deployment/prefect-horizon",
+                "v2/deployment/server-configuration"
+              ]
+            }
+          ]
+        },
+        {
+          "group": "Clients",
+          "pages": [
+            {
+              "group": "Essentials",
+              "icon": "cube",
+              "pages": [
+                "v2/clients/client",
+                "v2/clients/transports"
+              ]
+            },
+            {
+              "group": "Core Operations",
+              "icon": "handshake",
+              "pages": [
+                "v2/clients/tools",
+                "v2/clients/resources",
+                "v2/clients/prompts"
+              ]
+            },
+            {
+              "group": "Advanced Features",
+              "icon": "stars",
+              "pages": [
+                "v2/clients/elicitation",
+                "v2/clients/logging",
+                "v2/clients/progress",
+                "v2/clients/sampling",
+                "v2/clients/tasks",
+                "v2/clients/messages",
+                "v2/clients/roots"
+              ]
+            },
+            {
+              "group": "Authentication",
+              "icon": "user-shield",
+              "pages": [
+                "v2/clients/auth/oauth",
+                "v2/clients/auth/bearer"
+              ]
+            }
+          ]
+        },
+        {
+          "group": "Integrations",
+          "pages": [
+            {
+              "group": "Authentication",
+              "icon": "key",
+              "pages": [
+                "v2/integrations/auth0",
+                "v2/integrations/authkit",
+                "v2/integrations/aws-cognito",
+                "v2/integrations/azure",
+                "v2/integrations/descope",
+                "v2/integrations/discord",
+                "v2/integrations/github",
+                "v2/integrations/google",
+                "v2/integrations/oci",
+                "v2/integrations/scalekit",
+                "v2/integrations/supabase",
+                "v2/integrations/workos"
+              ]
+            },
+            {
+              "group": "Authorization",
+              "icon": "shield-check",
+              "pages": [
+                "v2/integrations/eunomia-authorization",
+                "v2/integrations/permit"
+              ]
+            },
+            {
+              "group": "AI Assistants",
+              "icon": "robot",
+              "pages": [
+                "v2/integrations/chatgpt",
+                "v2/integrations/claude-code",
+                "v2/integrations/claude-desktop",
+                "v2/integrations/cursor",
+                "v2/integrations/gemini-cli",
+                "v2/integrations/mcp-json-configuration"
+              ]
+            },
+            {
+              "group": "AI SDKs",
+              "icon": "code",
+              "pages": [
+                "v2/integrations/anthropic",
+                "v2/integrations/gemini",
+                "v2/integrations/openai"
+              ]
+            },
+            {
+              "group": "API Integration",
+              "icon": "globe",
+              "pages": [
+                "v2/integrations/fastapi",
+                "v2/integrations/openapi"
+              ]
+            }
+          ]
+        },
+        {
+          "group": "Patterns",
+          "pages": [
+            "v2/patterns/tool-transformation",
+            "v2/patterns/decorating-methods",
+            "v2/patterns/cli",
+            "v2/patterns/contrib",
+            "v2/patterns/testing"
+          ]
+        },
+        {
+          "group": "Development",
+          "pages": [
+            "v2/development/contributing",
+            "v2/development/tests",
+            "v2/development/releases",
+            "v2/development/upgrade-guide",
+            "v2/changelog"
+          ]
+        }
+      ],
+      "icon": "book"
+    }
+  ],
+  "version": "v2.14.5"
+}