From b70ff741f1d70d37ac74f0bf4527538f3eb479ea Mon Sep 17 00:00:00 2001
From: Anthony Ettinger <anthony@chovy.com>
Date: Thu, 23 Jul 2026 08:27:49 +0000
Subject: [PATCH] docs(web): document WebMCP tools on the docs page

Add an "ai agents / webmcp" section listing the four tools registered on
document.modelContext, with a usage snippet, and mention WebMCP in the
page metadata for discoverability.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---
 apps/web/src/app/docs/page.tsx | 38 +++++++++++++++++++++++++++++++++-
 1 file changed, 37 insertions(+), 1 deletion(-)

diff --git a/apps/web/src/app/docs/page.tsx b/apps/web/src/app/docs/page.tsx
index cbe2609..27a85f4 100644
--- a/apps/web/src/app/docs/page.tsx
+++ b/apps/web/src/app/docs/page.tsx
@@ -3,7 +3,7 @@ import { CodeBlock as Code } from "@/components/CodeBlock";
 
 export const metadata = {
   title: "docs — c0mpute",
-  description: "CLI reference and cookbook for c0mpute: install, identity, workers, transcode jobs, AI inference, reputation, plugins, and health checks.",
+  description: "CLI reference and cookbook for c0mpute: install, identity, workers, transcode jobs, AI inference, reputation, plugins, WebMCP tools for AI agents, and health checks.",
   alternates: { canonical: "https://c0mpute.com/docs" },
 };
 
@@ -242,6 +242,42 @@ c0mpute doctor --report                # send anonymized telemetry`}
         </Code>
       </Section>
 
+      <Section h="agents" title="[ ai agents / webmcp ]">
+        <P>
+          c0mpute.com speaks{" "}
+          <a href="https://webmachinelearning.github.io/webmcp/">WebMCP</a> — a
+          browser AI agent visiting the site can call its tools directly instead
+          of scraping the page. Tools register on{" "}
+          <code>document.modelContext</code> and are a no-op in browsers that
+          don&apos;t implement the (draft) spec.
+        </P>
+        <P>Tools exposed on every page:</P>
+        <ul className="space-y-1 pl-5 text-sm leading-6">
+          <li>
+            <code>c0mpute_list_plugins</code> — the plugin catalogue with install
+            commands (also at <Link href="/api/plugins">/api/plugins</Link>)
+          </li>
+          <li>
+            <code>c0mpute_network_status</code> — live workers, jobs in flight,
+            24h throughput, latency (also at <code>/api/status</code>)
+          </li>
+          <li>
+            <code>c0mpute_latest_release</code> — CLI release manifest &amp;
+            per-platform artifacts
+          </li>
+          <li>
+            <code>c0mpute_install_command</code> — install command for the CLI or
+            a plugin by id
+          </li>
+        </ul>
+        <P>Any WebMCP-capable client can enumerate them:</P>
+        <Code>
+{`// in a page context on c0mpute.com
+const tools = await document.modelContext.getTools();
+const status = await document.modelContext.callTool("c0mpute_network_status", {});`}
+        </Code>
+      </Section>
+
       <Section h="design" title="[ design proposals ]">
         <P>
           Architecture decisions live in the{" "}