From d86063bad9a26341d0050e5b96761f77dd0c2409 Mon Sep 17 00:00:00 2001
From: Conor Bronsdon <120674402+conorbronsdon@users.noreply.github.com>
Date: Wed, 8 Jul 2026 18:32:52 -0700
Subject: [PATCH] fix(docs): show manual-setup indicator for extensions without
 an install link (#10321)

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
---
 documentation/src/components/server-card.tsx  | 12 +++++++++++-
 documentation/src/css/extensions.css          |  6 ++++--
 documentation/src/pages/extensions/detail.tsx |  9 ++++++++-
 3 files changed, 23 insertions(+), 4 deletions(-)

diff --git a/documentation/src/components/server-card.tsx b/documentation/src/components/server-card.tsx
index da1f328f8f..8623d18976 100644
--- a/documentation/src/components/server-card.tsx
+++ b/documentation/src/components/server-card.tsx
@@ -149,7 +149,17 @@ export function ServerCard({ server }: { server: MCPServer }) {
                     <span>Install</span>
                     <Download className="h-4 w-4" />
                   </a>
-                ) : null}
+                ) : (
+                  <div
+                    className="manual-setup-badge"
+                    title={
+                      server.installation_notes ||
+                      "This extension requires manual setup. See details for instructions."
+                    }
+                  >
+                    Manual setup
+                  </div>
+                )}
               </div>
             </div>
           </div>
diff --git a/documentation/src/css/extensions.css b/documentation/src/css/extensions.css
index 39274f91a0..fdd01f9470 100644
--- a/documentation/src/css/extensions.css
+++ b/documentation/src/css/extensions.css
@@ -281,7 +281,8 @@
   color: #fa5204;
 }
 
-.built-in-badge {
+.built-in-badge,
+.manual-setup-badge {
   font-size: 0.75rem;
   padding: 0.25rem 0.5rem;
   border-radius: 999px;
@@ -322,6 +323,7 @@ html[data-theme="dark"] .command-content {
   background-color: rgba(255, 255, 255, 0.05);
 }
 
-html[data-theme="dark"] .built-in-badge {
+html[data-theme="dark"] .built-in-badge,
+html[data-theme="dark"] .manual-setup-badge {
   background-color: rgba(255, 255, 255, 0.1);
 }
diff --git a/documentation/src/pages/extensions/detail.tsx b/documentation/src/pages/extensions/detail.tsx
index e51ac0e787..71f0956ea1 100644
--- a/documentation/src/pages/extensions/detail.tsx
+++ b/documentation/src/pages/extensions/detail.tsx
@@ -225,7 +225,14 @@ const getDocumentationPath = (serverId: string): string => {
                         <span>Install</span>
                         <Download className="h-4 w-4" />
                       </a>
-                    ) : null}
+                    ) : (
+                      <div
+                        className="manual-setup-badge"
+                        title="This extension requires manual setup. See the installation notes above."
+                      >
+                        Manual setup
+                      </div>
+                    )}
                   </div>
                 </div>
               </div>