feat: improve AI documentation discoverability

cursoragent · cursoragent · commit bfc029be2cf7 · 2026-03-16T21:35:06.000Z
- Add &lt;link rel="llms-txt" href="/llms.txt"&gt; to the &lt;head&gt; of every page
  so any LLM fetching any page can discover the machine-readable docs
- Add /.well-known/llms.txt -&gt; /llms.txt permanent redirect in vercel.json
  (the emerging standard path for llms.txt discovery)
- Add /en and /en/:path* -&gt; / and /:path* permanent redirects at CDN level
  so old /en/build-style URLs no longer 404 (saves LLM agents a round-trip)
- Add MCP server mention to llms.txt via starlightLlmsTxt details option
  ("For AI coding tools, install @aptos-labs/aptos-mcp")
diff --git a/astro.config.mjs b/astro.config.mjs
@@ -155,10 +155,15 @@ export default defineConfig({
           rawContent: true,
           description:
             "Developer documentation for the Aptos blockchain — Move smart contracts, SDKs, APIs, indexer, node operations, and AI tools.",
+          details: [
+            "For AI coding tools, install the Aptos MCP server: `npx @aptos-labs/aptos-mcp`",
+            "It gives your IDE direct access to Aptos APIs, on-chain data, and Move contract helpers.",
+            "See <https://aptos.dev/build/ai> for setup guides (Claude Code, Cursor, and more).",
+          ].join("\n"),
           optionalLinks: [
             {
               label: "Aptos MCP Server",
-              url: "https://www.npmjs.com/package/@anthropic-ai/aptos-mcp",
+              url: "https://www.npmjs.com/package/@aptos-labs/aptos-mcp",
               description: "MCP server for AI coding tools",
             },
             {
diff --git a/src/starlight-overrides/Head.astro b/src/starlight-overrides/Head.astro
@@ -149,6 +149,9 @@ const breadcrumbItems = [
 {/* Critical CSS with high fetch priority */}
 <link rel="preload" href={globalCssUrl} as="style" fetchpriority="high" />
 
+{/* LLMs.txt discovery: lets any LLM fetching any page find the machine-readable docs */}
+<link rel="llms-txt" href="/llms.txt" />
+
 {/* hreflang x-default: tells search engines which URL to serve when no locale matches */}
 <link rel="alternate" hreflang="x-default" href={getLanguageUrl("en")} />
 
diff --git a/vercel.json b/vercel.json
@@ -24,6 +24,21 @@
     }
   ],
   "redirects": [
+    {
+      "source": "/.well-known/llms.txt",
+      "destination": "/llms.txt",
+      "permanent": true
+    },
+    {
+      "source": "/en",
+      "destination": "/",
+      "permanent": true
+    },
+    {
+      "source": "/en/:path*",
+      "destination": "/:path*",
+      "permanent": true
+    },
     {
       "source": "/tutorials/:path*",
       "destination": "/build/guides/:path*",
