docs: cover the MCP Registry across swarmdock.ai

- /docs/registry — dedicated reference page: overview, REST API, MCP
  tools, SDK, submission flow, signed usage attestations,
  quality-score formula, paid-tier flow, ingestion sources.
- /docs landing — new MCP Registry section with short code sample and
  link to the reference page.
- /docs/mcp — inline callout pointing at the registry for discovery,
  linking to /docs/registry for full details.
- Top nav MCP link now points at /mcp (the public registry) rather
  than the integration docs, matching what users actually want when
  they click it.

Author: waydelyle

packages/web/src/app/docs/mcp/page.tsx

@@ -152,6 +152,21 @@ export default function McpDocsPage() {
           <code className="mono text-sm text-[var(--color-accent)]">swarmdock-mcp</code> stdio package — see Local / stdio
           below. Pick hosted for zero-install; pick stdio if you prefer your key never leaves your machine.
         </p>
+        <p className="rounded-[12px] border border-[var(--color-accent)]/30 bg-[var(--color-accent)]/[0.04] p-4 text-sm">
+          <strong>Looking for MCP servers to use?</strong> Browse the{' '}
+          <Link href="/mcp" className="text-[var(--color-accent)] hover:underline">
+            SwarmDock MCP Registry
+          </Link>{' '}
+          at{' '}
+          <a href="https://mcp.swarmdock.ai" className="text-[var(--color-accent)] hover:underline">
+            mcp.swarmdock.ai
+          </a>{' '}
+          — 257+ servers with verified usage signal. Full reference at{' '}
+          <Link href="/docs/registry" className="text-[var(--color-accent)] hover:underline">
+            /docs/registry
+          </Link>
+          .
+        </p>
       </div>
 
       <div className="section-rule mt-12" id="hosted"><span>Hosted Endpoint</span></div>

packages/web/src/app/docs/page.tsx

@@ -8,6 +8,7 @@ const sections = [
   { id: 'cli-reference', label: 'CLI Reference' },
   { id: 'sdk', label: 'SDK' },
   { id: 'mcp', label: 'MCP Server' },
+  { id: 'registry', label: 'MCP Registry' },
   { id: 'webhooks', label: 'Webhooks' },
   { id: 'task-lifecycle', label: 'Task Lifecycle' },
   { id: 'authentication', label: 'Authentication' },
@@ -161,6 +162,36 @@ export default function DocsPage() {
         </p>
       </div>
 
+      {/* MCP Registry */}
+      <div className="section-rule mt-12" id="registry"><span>MCP Registry</span></div>
+      <div className="mt-6 max-w-3xl space-y-4">
+        <p className="text-[var(--color-text-2)]">
+          Public directory of Model Context Protocol servers with cryptographically verified usage
+          signal. Live at{' '}
+          <a href="https://mcp.swarmdock.ai" className="text-[var(--color-accent)] hover:underline">
+            mcp.swarmdock.ai
+          </a>
+          , aggregated from Smithery, modelcontextprotocol/servers, and direct submissions.
+        </p>
+        <Terminal lines={[
+          { comment: true, text: '# Search the registry from any MCP client — no auth needed' },
+          { prompt: true, text: 'curl https://swarmdock-api.onrender.com/api/v1/mcp/servers?q=postgres' },
+          { comment: true, text: '# Or from the SDK' },
+          { text: "await client.mcp.search({ q: 'postgres' });" },
+          { text: "await client.mcp.recommend({ description: 'parse PDF invoices' });" },
+          { comment: true, text: '# Signed usage attestation — feeds the public quality score' },
+          { text: "await client.mcp.recordUsage('filesystem', 'success', { latencyMs: 120 });" },
+        ]} />
+        <p className="text-sm text-[var(--color-text-3)]">
+          Full reference — REST endpoints, MCP tools, SDK methods, attestation format, quality-score
+          formula, paid-tier flow, ingestion sources — at{' '}
+          <Link href="/docs/registry" className="text-[var(--color-accent)] hover:underline">
+            /docs/registry
+          </Link>
+          .
+        </p>
+      </div>
+
       {/* Webhooks */}
       <div className="section-rule mt-12" id="webhooks"><span>Webhooks</span></div>
       <div className="mt-6 max-w-3xl space-y-4">