fix(seo): canonical self-deindexing on /docs/*, truthful llms.txt, real sitemap dates, RSS feed, breadcrumbs, per-article OG images

- /docs subpages canonicalized to /docs and had no descriptions; each now
  uses pageMetadata with its own path (was: Google could index at most one)
- llms.txt claimed Team EUR 149, RBAC/SLA and BYO-cloud that do not exist;
  regenerated from lib/seo.ts truth + new llms-full.txt with docs content
- sitemap stamped lastModified=now on every request; now real per-route dates
  from new lib/articles.ts registry (single source for guides index/sitemap/RSS)
- new /feed.xml RSS 2.0 route + alternates link in root layout
- articleJsonLd: image (per-guide opengraph-image via lib/og-article.tsx),
  Person author, wordCount; new breadcrumbJsonLd on guides + docs
- GSC verification via NEXT_PUBLIC_GSC_VERIFICATION (documented in .env.example)
- dropped fabricated Enterprise EUR 499 offer from SoftwareApplication JSON-LD
- article-shell: OL/Table/Note primitives for upcoming articles

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SXUwmPVRTD8AKQtio6gCN5

apps/web/app/(marketing)/contact/layout.tsx

@@ -0,0 +1,15 @@
+import { pageMetadata } from '@/lib/seo';
+import type { ReactNode } from 'react';
+
+// The contact page itself is a client component ('use client'), which cannot
+// export metadata — so the canonical/description live here.
+export const metadata = pageMetadata({
+  title: 'Contact',
+  description:
+    'Get in touch with the BuildMyMCPServer team — support, sales and security questions answered by email.',
+  path: '/contact',
+});
+
+export default function ContactLayout({ children }: { children: ReactNode }) {
+  return children;
+}

apps/web/app/(marketing)/guides/article-shell.tsx

@@ -71,3 +71,33 @@ export function UL({ children }: { children: ReactNode }) {
 export function Strong({ children }: { children: ReactNode }) {
   return <strong className="font-semibold text-[--color-fg]">{children}</strong>;
 }
+
+export function OL({ children }: { children: ReactNode }) {
+  return (
+    <ol className="mt-3 list-decimal space-y-1.5 pl-5 text-[14.5px] leading-relaxed text-[--color-fg-muted]">
+      {children}
+    </ol>
+  );
+}
+
+/** Comparison / feature tables. Pass fully-formed <thead>/<tbody> children;
+ *  the wrapper provides the horizontal-scroll container so wide tables never
+ *  break the mobile viewport. */
+export function Table({ children }: { children: ReactNode }) {
+  return (
+    <div className="mt-4 overflow-x-auto rounded-lg border border-[--color-border]">
+      <table className="w-full min-w-[560px] border-collapse text-left text-[13.5px] leading-relaxed [&_td]:border-t [&_td]:border-[--color-border] [&_td]:px-3.5 [&_td]:py-2.5 [&_td]:align-top [&_td]:text-[--color-fg-muted] [&_th]:bg-[--color-bg-subtle] [&_th]:px-3.5 [&_th]:py-2.5 [&_th]:text-[12px] [&_th]:font-semibold [&_th]:uppercase [&_th]:tracking-wider [&_th]:text-[--color-fg]">
+        {children}
+      </table>
+    </div>
+  );
+}
+
+/** Callout for caveats and version-sensitive facts. */
+export function Note({ children }: { children: ReactNode }) {
+  return (
+    <div className="mt-4 rounded-lg border border-[--color-border] bg-[--color-bg-subtle] px-4 py-3 text-[13.5px] leading-relaxed text-[--color-fg-muted]">
+      {children}
+    </div>
+  );
+}

apps/web/app/(marketing)/guides/host-mcp-server-with-oauth/opengraph-image.tsx

@@ -0,0 +1,13 @@
+import { articleOgImage, OG_SIZE } from '@/lib/og-article';
+
+export const runtime = 'edge';
+export const alt = 'How to host a remote MCP server with OAuth (2026)';
+export const size = OG_SIZE;
+export const contentType = 'image/png';
+
+export default function Image() {
+  return articleOgImage({
+    title: 'How to host a remote MCP server with OAuth (2026)',
+    tag: 'Guide',
+  });
+}

apps/web/app/(marketing)/guides/host-mcp-server-with-oauth/page.tsx

@@ -1,5 +1,5 @@
 import { JsonLd } from '@/components/json-ld';
-import { articleJsonLd, pageMetadata } from '@/lib/seo';
+import { articleJsonLd, breadcrumbJsonLd, pageMetadata } from '@/lib/seo';
 import Link from 'next/link';
 import { ArticleShell, H2, P, Strong, UL } from '../article-shell';
 
@@ -21,6 +21,13 @@ export default function Page() {
           datePublished: '2026-05-31',
         })}
       />
+      <JsonLd
+        data={breadcrumbJsonLd([
+          { name: 'Home', path: '/' },
+          { name: 'Guides', path: '/guides' },
+          { name: TITLE, path: PATH },
+        ])}
+      />
       <ArticleShell
         title={TITLE}
         subtitle="Local STDIO servers are easy. A remote MCP server that Claude, Cursor and ChatGPT can install over the internet — without leaving it open to the world — is where the real work is. Here's the whole picture."

apps/web/app/(marketing)/guides/hosted-mcp-platforms-compared/opengraph-image.tsx

@@ -0,0 +1,13 @@
+import { articleOgImage, OG_SIZE } from '@/lib/og-article';
+
+export const runtime = 'edge';
+export const alt = 'Hosted MCP platforms compared: Cloudflare, Smithery, Composio & generating your own';
+export const size = OG_SIZE;
+export const contentType = 'image/png';
+
+export default function Image() {
+  return articleOgImage({
+    title: 'Hosted MCP platforms compared: Cloudflare, Smithery, Composio & more',
+    tag: 'Comparison',
+  });
+}

apps/web/app/(marketing)/guides/hosted-mcp-platforms-compared/page.tsx

@@ -1,5 +1,5 @@
 import { JsonLd } from '@/components/json-ld';
-import { articleJsonLd, pageMetadata } from '@/lib/seo';
+import { articleJsonLd, breadcrumbJsonLd, pageMetadata } from '@/lib/seo';
 import Link from 'next/link';
 import { ArticleShell, H2, P, Strong, UL } from '../article-shell';
 
@@ -22,6 +22,13 @@ export default function Page() {
           datePublished: '2026-05-31',
         })}
       />
+      <JsonLd
+        data={breadcrumbJsonLd([
+          { name: 'Home', path: '/' },
+          { name: 'Guides', path: '/guides' },
+          { name: TITLE, path: PATH },
+        ])}
+      />
       <ArticleShell
         title={TITLE}
         subtitle="There are 14,000+ MCP servers out there and a dozen platforms claiming to host them. They are not competing for the same job. Sort them into four buckets and the choice gets obvious."

apps/web/app/(marketing)/guides/mintmcp-alternative/opengraph-image.tsx

@@ -0,0 +1,13 @@
+import { articleOgImage, OG_SIZE } from '@/lib/og-article';
+
+export const runtime = 'edge';
+export const alt = 'MintMCP alternative: generate and host a custom MCP server';
+export const size = OG_SIZE;
+export const contentType = 'image/png';
+
+export default function Image() {
+  return articleOgImage({
+    title: 'MintMCP alternative: generate and host a custom MCP server',
+    tag: 'Alternative',
+  });
+}

apps/web/app/(marketing)/guides/mintmcp-alternative/page.tsx

@@ -1,5 +1,5 @@
 import { JsonLd } from '@/components/json-ld';
-import { articleJsonLd, pageMetadata } from '@/lib/seo';
+import { articleJsonLd, breadcrumbJsonLd, pageMetadata } from '@/lib/seo';
 import Link from 'next/link';
 import { ArticleShell, H2, P, Strong, UL } from '../article-shell';
 
@@ -21,6 +21,13 @@ export default function Page() {
           datePublished: '2026-05-31',
         })}
       />
+      <JsonLd
+        data={breadcrumbJsonLd([
+          { name: 'Home', path: '/' },
+          { name: 'Guides', path: '/guides' },
+          { name: TITLE, path: PATH },
+        ])}
+      />
       <ArticleShell
         title={TITLE}
         subtitle="MintMCP and BuildMyMCPServer both get you to a hosted, OAuth-protected MCP server — but they start from opposite ends. The right pick depends entirely on whether you already have server code."

apps/web/app/(marketing)/guides/page.tsx

@@ -1,4 +1,6 @@
-import { pageMetadata } from '@/lib/seo';
+import { JsonLd } from '@/components/json-ld';
+import { articlesNewestFirst } from '@/lib/articles';
+import { breadcrumbJsonLd, pageMetadata } from '@/lib/seo';
 import Link from 'next/link';
 
 export const metadata = pageMetadata({
@@ -8,48 +10,40 @@ export const metadata = pageMetadata({
   path: '/guides',
 });
 
-const GUIDES = [
-  {
-    slug: 'host-mcp-server-with-oauth',
-    title: 'How to host a remote MCP server with OAuth (2026)',
-    description:
-      'Streamable HTTP, OAuth 2.1, PKCE and Resource Indicators — what it actually takes to put a remote MCP server in production, and the shortcuts.',
-    tag: 'Guide',
-  },
-  {
-    slug: 'hosted-mcp-platforms-compared',
-    title: 'Hosted MCP platforms compared: Cloudflare, Smithery, Composio & generating your own',
-    description:
-      'The MCP hosting landscape splits into four categories. Which one fits depends on whether you have a server already, need a catalog, or need bespoke logic.',
-    tag: 'Comparison',
-  },
-  {
-    slug: 'mintmcp-alternative',
-    title: 'MintMCP alternative: generate and host a custom MCP server',
-    description:
-      'MintMCP wraps an existing STDIO server into a remote one. If you do not have a server yet, here is the generate-from-a-prompt route — and where MintMCP still wins.',
-    tag: 'Alternative',
-  },
-];
-
 export default function GuidesIndex() {
+  const guides = articlesNewestFirst();
   return (
     <div className="mx-auto max-w-3xl px-6 py-14">
+      <JsonLd
+        data={breadcrumbJsonLd([
+          { name: 'Home', path: '/' },
+          { name: 'Guides', path: '/guides' },
+        ])}
+      />
       <h1 className="text-[28px] font-semibold tracking-tight text-[--color-fg]">MCP guides</h1>
       <p className="mt-2 text-[14.5px] leading-relaxed text-[--color-fg-muted]">
         Hosting, auth and shipping for Model Context Protocol servers — written for people building
         real tools, not demos.
       </p>
       <div className="mt-8 space-y-3">
-        {GUIDES.map((g) => (
+        {guides.map((g) => (
           <Link
             key={g.slug}
             href={`/guides/${g.slug}`}
             className="block rounded-lg border border-[--color-border] p-4 transition-colors hover:bg-[--color-bg-subtle]"
           >
-            <span className="mono text-[10.5px] uppercase tracking-wider text-[--color-fg-subtle]">
-              {g.tag}
-            </span>
+            <div className="flex items-center gap-2.5">
+              <span className="mono text-[10.5px] uppercase tracking-wider text-[--color-fg-subtle]">
+                {g.tag}
+              </span>
+              <span className="text-[10.5px] text-[--color-fg-subtle]">
+                {new Date(g.dateModified ?? g.datePublished).toLocaleDateString('en-US', {
+                  year: 'numeric',
+                  month: 'short',
+                  day: 'numeric',
+                })}
+              </span>
+            </div>
             <h2 className="mt-1 text-[16px] font-semibold tracking-tight text-[--color-fg]">
               {g.title}
             </h2>