From 63be81fadd75a386593042d5479aad09521081a2 Mon Sep 17 00:00:00 2001
From: David Karlsson <35727626+dvdksn@users.noreply.github.com>
Date: Mon, 20 Apr 2026 15:38:34 +0200
Subject: [PATCH] Advertise the Docker docs MCP server

Publish an MCP Server Card at /.well-known/mcp/server-card.json
pointing at https://mcp-docs.docker.com/mcp, so agents doing MCP
discovery can find the official Docker docs endpoint. Mirror the
serverInfo and capabilities reported by the server's initialize
response.

Also add a one-line pointer near the top of llms.txt so LLMs fetching
the index learn about the structured-access alternative.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
---
 layouts/home.llms.txt                   |  2 ++
 static/.well-known/mcp/server-card.json | 23 +++++++++++++++++++++++
 2 files changed, 25 insertions(+)
 create mode 100644 static/.well-known/mcp/server-card.json

diff --git a/layouts/home.llms.txt b/layouts/home.llms.txt
index 8eec5f273a..6648734b6e 100644
--- a/layouts/home.llms.txt
+++ b/layouts/home.llms.txt
@@ -3,6 +3,8 @@
 {{- $grouped := $sorted.GroupBy "Section" -}}
 
 # Docker Documentation
+
+> MCP endpoint for structured agent access: https://mcp-docs.docker.com/mcp
 {{- range $grouped }}
 
 ## {{ humanize .Key }}
diff --git a/static/.well-known/mcp/server-card.json b/static/.well-known/mcp/server-card.json
new file mode 100644
index 0000000000..6b21ff4210
--- /dev/null
+++ b/static/.well-known/mcp/server-card.json
@@ -0,0 +1,23 @@
+{
+  "serverInfo": {
+    "name": "llms-txt",
+    "version": "1.26.0",
+    "description": "Official Docker documentation MCP server. Exposes a fetch_docker_docs tool that returns the docs.docker.com content index."
+  },
+  "transport": {
+    "type": "http",
+    "url": "https://mcp-docs.docker.com/mcp"
+  },
+  "capabilities": {
+    "prompts": {
+      "listChanged": false
+    },
+    "resources": {
+      "subscribe": false,
+      "listChanged": false
+    },
+    "tools": {
+      "listChanged": false
+    }
+  }
+}