diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml
index 37006219..5a503932 100644
--- a/.github/workflows/docs.yml
+++ b/.github/workflows/docs.yml
@@ -8,6 +8,7 @@ on:
       - "README.md"
       - "apps/docs/**"
       - "packages/hyperliquid/README.md"
+      - "packages/hyperliquid/package.json"
       - ".github/CODEOWNERS"
       - ".github/workflows/docs.yml"
       - ".lycheeignore"
@@ -20,6 +21,7 @@ on:
       - "README.md"
       - "apps/docs/**"
       - "packages/hyperliquid/README.md"
+      - "packages/hyperliquid/package.json"
       - ".github/CODEOWNERS"
       - ".github/workflows/docs.yml"
       - ".lycheeignore"
@@ -62,6 +64,10 @@ jobs:
         working-directory: apps/docs
         run: bun run check
 
+      - name: Test documentation website helpers
+        working-directory: apps/docs
+        run: bun run test
+
       - name: Build static documentation website
         working-directory: apps/docs
         run: bun run build
diff --git a/apps/docs/README.md b/apps/docs/README.md
index 5f0f6f9f..6bd8a842 100644
--- a/apps/docs/README.md
+++ b/apps/docs/README.md
@@ -63,9 +63,12 @@ The build verifies every documentation page, internal link, asset, and anchor, p
 
 The build also exports files that let AI agents use the site without rendering JavaScript:
 
-- `public/llms.txt` is the curated entry point: what the SDK does, when to use it, and links to every page.
+- `app/llms.txt/route.ts` generates the entry point from the docs source: what the SDK does, when to use it,
+  call examples, and links to every page.
+- `app/llms-full.txt/route.ts` generates the complete docs with frontmatter removed and relative Markdown links
+  converted to absolute website URLs.
 - `scripts/export-markdown.ts` runs after `next build` and writes a Markdown mirror for each documentation page
-  (`/docs/clients/` → `/docs/clients.md`, served as `text/markdown`) plus a concatenated `llms-full.txt`.
+  (`/docs/clients/` → `/docs/clients.md`, served as `text/markdown`).
 - `app/sitemap.ts` emits `sitemap.xml`, and `public/robots.txt` explicitly allows AI crawlers.
 - `/about/`, `/contact/`, and `/privacy/` are trust pages, and the homepage carries JSON-LD
   (Organization with a contact point, WebSite, SoftwareApplication).
@@ -74,6 +77,7 @@ The build also exports files that let AI agents use the site without rendering J
 
 `scripts/verify-export.ts` checks all of these after every build. GitHub Pages cannot do server-driven content
 negotiation, so `Accept: text/markdown` requests still receive HTML; the `.md` mirrors are the Markdown path.
+Run `bun run --cwd apps/docs test` to test the agent-document generators and JSON-LD helpers.
 Build without `NEXT_PUBLIC_BASE_PATH` to serve at a domain root instead.
 
 ## Social cards
diff --git a/apps/docs/app/llms-full.txt/route.ts b/apps/docs/app/llms-full.txt/route.ts
new file mode 100644
index 00000000..39befba8
--- /dev/null
+++ b/apps/docs/app/llms-full.txt/route.ts
@@ -0,0 +1,10 @@
+import { llmsFullText } from "@/lib/agent";
+import { agentPagesWithMarkdown } from "@/lib/agent-pages";
+
+export const dynamic = "force-static";
+
+export async function GET() {
+  return new Response(llmsFullText(await agentPagesWithMarkdown()), {
+    headers: { "Content-Type": "text/plain; charset=utf-8" },
+  });
+}
diff --git a/apps/docs/app/llms.txt/route.ts b/apps/docs/app/llms.txt/route.ts
new file mode 100644
index 00000000..d5264087
--- /dev/null
+++ b/apps/docs/app/llms.txt/route.ts
@@ -0,0 +1,8 @@
+import { llmsText } from "@/lib/agent";
+import { agentPages } from "@/lib/agent-pages";
+
+export const dynamic = "force-static";
+
+export function GET() {
+  return new Response(llmsText(agentPages()), { headers: { "Content-Type": "text/plain; charset=utf-8" } });
+}
diff --git a/apps/docs/app/not-found.tsx b/apps/docs/app/not-found.tsx
index 1a77b540..451369f4 100644
--- a/apps/docs/app/not-found.tsx
+++ b/apps/docs/app/not-found.tsx
@@ -1,10 +1,13 @@
 import { HomeLayout } from "fumadocs-ui/layouts/home";
+import type { Metadata } from "next";
 import Link from "next/link";
 import { SiteFooter } from "@/components/site-footer";
 import { baseOptions } from "@/lib/layout.shared";
 
 const basePath = process.env.NEXT_PUBLIC_BASE_PATH ?? "";
 
+export const metadata: Metadata = { title: "Page not found", robots: { index: false } };
+
 export default function NotFound() {
   return (
     <HomeLayout {...baseOptions()} className="min-h-dvh">
diff --git a/apps/docs/app/page.tsx b/apps/docs/app/page.tsx
index f3547744..5f54669c 100644
--- a/apps/docs/app/page.tsx
+++ b/apps/docs/app/page.tsx
@@ -5,55 +5,10 @@ import { CopyButton } from "@/components/copy-button";
 import { InstallCommand } from "@/components/install-command";
 import { MarketPlayground } from "@/components/market-playground";
 import { SiteFooter } from "@/components/site-footer";
+import { homeStructuredData, jsonLdScript } from "@/lib/agent";
 import { baseOptions } from "@/lib/layout.shared";
-import { siteUrl } from "@/lib/social";
 
-const jsonLd = {
-  "@context": "https://schema.org",
-  "@graph": [
-    {
-      "@type": "Organization",
-      "@id": "https://bloxwap.com/#organization",
-      name: "Bloxwap, Inc.",
-      url: "https://bloxwap.com",
-      sameAs: [
-        "https://github.com/bloxwap",
-        "https://x.com/bloxwap",
-        "https://t.me/bloxwap",
-        "https://discord.com/invite/cEfkcg6JHT",
-        "https://www.reddit.com/r/Bloxwap/",
-      ],
-      contactPoint: {
-        "@type": "ContactPoint",
-        email: "support@bloxwap.com",
-        contactType: "customer support",
-        url: "https://bloxwap.github.io/hyperliquid/contact/",
-      },
-    },
-    {
-      "@type": "WebSite",
-      "@id": `${siteUrl.href}#website`,
-      url: siteUrl.href,
-      name: "Hyperliquid SDK · Bloxwap",
-      publisher: { "@id": "https://bloxwap.com/#organization" },
-    },
-    {
-      "@type": "SoftwareApplication",
-      name: "@bloxwap/hyperliquid",
-      description:
-        "A fast, fully typed TypeScript and JavaScript SDK for the Hyperliquid exchange API: market data, trading, signing, and real-time subscriptions over HTTP and WebSocket.",
-      applicationCategory: "DeveloperApplication",
-      operatingSystem: "Bun, Node.js, Browsers, React Native",
-      url: siteUrl.href,
-      downloadUrl: "https://www.npmjs.com/package/@bloxwap/hyperliquid",
-      codeRepository: "https://github.com/bloxwap/hyperliquid",
-      license: "https://opensource.org/licenses/MIT",
-      isAccessibleForFree: true,
-      offers: { "@type": "Offer", price: "0", priceCurrency: "USD" },
-      author: { "@id": "https://bloxwap.com/#organization" },
-    },
-  ],
-};
+const jsonLd = homeStructuredData();
 
 const features = [
   {
@@ -93,8 +48,8 @@ export default function Home() {
     // min-h-dvh lets .landing grow into the slack, keeping the footer at the bottom of a tall window.
     <HomeLayout {...baseOptions()} className="min-h-dvh">
       <main className="landing">
-        {/* biome-ignore lint/security/noDangerouslySetInnerHtml: JSON.stringify of a static constant is the Next.js-documented way to emit ld+json verbatim. */}
-        <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }} />
+        {/* biome-ignore lint/security/noDangerouslySetInnerHtml: Static JSON-LD is escaped by jsonLdScript before embedding in HTML. */}
+        <script type="application/ld+json" dangerouslySetInnerHTML={{ __html: jsonLdScript(jsonLd) }} />
         <div className="hero">
           <div className="hero-copy">
             <p className="eyebrow">
diff --git a/apps/docs/lib/agent-pages.ts b/apps/docs/lib/agent-pages.ts
new file mode 100644
index 00000000..d1bfd9b9
--- /dev/null
+++ b/apps/docs/lib/agent-pages.ts
@@ -0,0 +1,30 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { type AgentPage, agentMarkdown } from "./agent";
+import { source } from "./source";
+
+// Next runs route handlers from the docs workspace directory at build time.
+const docsDir = resolve(process.cwd(), "content/docs");
+
+export function agentPages(): AgentPage[] {
+  return source
+    .getPages()
+    .map((page) => ({ url: page.url, title: page.data.title, description: page.data.description }));
+}
+
+/** Every docs page with its Markdown source, read from the same files GitHub renders. */
+export async function agentPagesWithMarkdown(): Promise<(AgentPage & { markdown: string })[]> {
+  return Promise.all(
+    source.getPages().map(async (page) => {
+      // Fumadocs sees README.md as index.md (see lib/source.ts); read the original file.
+      const sourcePath = page.path.replace(/(^|\/)index\.md$/, "$1README.md");
+      const raw = await readFile(resolve(docsDir, sourcePath), "utf8");
+      return {
+        url: page.url,
+        title: page.data.title,
+        description: page.data.description,
+        markdown: agentMarkdown(raw, sourcePath),
+      };
+    }),
+  );
+}
diff --git a/apps/docs/lib/agent.test.ts b/apps/docs/lib/agent.test.ts
new file mode 100644
index 00000000..44c33b51
--- /dev/null
+++ b/apps/docs/lib/agent.test.ts
@@ -0,0 +1,128 @@
+import { describe, expect, test } from "bun:test";
+import sdkPackage from "../../../packages/hyperliquid/package.json";
+import {
+  agentMarkdown,
+  homeStructuredData,
+  jsonLdScript,
+  llmsFullText,
+  llmsText,
+  organization,
+  pageUrl,
+} from "./agent";
+
+const site = "https://bloxwap.github.io/hyperliquid/";
+const pages = [
+  { url: "/docs/clients", title: "Clients", description: "Use the clients." },
+  { url: "/docs", title: "Introduction" },
+];
+
+describe("pageUrl", () => {
+  test("publishes routes under the project base path with a trailing slash", () => {
+    expect(pageUrl("/")).toBe(site);
+    expect(pageUrl("/docs")).toBe(`${site}docs/`);
+    expect(pageUrl("/docs/guides/market-orders/")).toBe(`${site}docs/guides/market-orders/`);
+  });
+});
+
+describe("llmsText", () => {
+  const text = llmsText(pages);
+
+  test("follows the llms.txt layout: H1, blockquote summary, then H2 sections", () => {
+    const lines = text.split("\n");
+    expect(lines[0]).toBe("# Hyperliquid SDK (@bloxwap/hyperliquid)");
+    expect(lines[2]?.startsWith("> ")).toBe(true);
+    expect(text.match(/^# /gm)).toHaveLength(1);
+    expect(text).toContain("\n## When to use this\n");
+    expect(text).toContain("\n## How to call it\n");
+    expect(text).toContain("\n## Docs\n");
+    expect(text).toContain("\n## Optional\n");
+  });
+
+  test("links every docs page by its published URL, in a stable order", () => {
+    const docs = text.split("\n## Docs\n\n")[1]?.split("\n\n")[1];
+    expect(docs).toBe(`- [Introduction](${site}docs/)\n- [Clients](${site}docs/clients/): Use the clients.`);
+  });
+
+  test("points at the full text, sitemap, and company trust pages", () => {
+    for (const url of [
+      `${site}llms-full.txt`,
+      `${site}sitemap.xml`,
+      organization.about,
+      organization.contact,
+      organization.privacy,
+    ]) {
+      expect(text).toContain(`](${url})`);
+    }
+    expect(organization.about).toBe(`${site}about/`);
+    expect(organization.contact).toBe(`${site}contact/`);
+    expect(organization.privacy).toBe(`${site}privacy/`);
+  });
+});
+
+describe("agentMarkdown", () => {
+  test("drops front matter", () => {
+    expect(agentMarkdown("---\ntitle: X\ndescription: Y\n---\n\n# X\n\nBody.\n", "clients.md")).toBe("# X\n\nBody.");
+  });
+
+  test("turns relative Markdown links into absolute website URLs", () => {
+    const raw = [
+      "[a](clients.md#info-endpoint)",
+      "[b](guides/README.md)",
+      "[c](../signing.md)",
+      "[d](README.md)",
+      "[e](https://example.com/x.md)",
+      "[f](#local)",
+    ].join("\n");
+    expect(agentMarkdown(raw, "README.md").split("\n").slice(0, 2)).toEqual([
+      `[a](${site}docs/clients/#info-endpoint)`,
+      `[b](${site}docs/guides/)`,
+    ]);
+    expect(agentMarkdown(raw, "guides/market-orders.md").split("\n")).toEqual([
+      `[a](${site}docs/guides/clients/#info-endpoint)`,
+      `[b](${site}docs/guides/guides/)`,
+      `[c](${site}docs/signing/)`,
+      `[d](${site}docs/guides/)`,
+      "[e](https://example.com/x.md)",
+      "[f](#local)",
+    ]);
+  });
+});
+
+describe("llmsFullText", () => {
+  test("concatenates every page with its source URL and links back to llms.txt", () => {
+    const text = llmsFullText(pages.map((page) => ({ ...page, markdown: `# ${page.title}` })));
+    expect(text).toContain(`${site}llms.txt`);
+    expect(text).toContain(`<!-- Source: ${site}docs/clients/ -->\n\n# Clients`);
+    expect(text).toContain(`<!-- Source: ${site}docs/ -->\n\n# Introduction`);
+  });
+});
+
+describe("homeStructuredData", () => {
+  const graph = homeStructuredData()["@graph"] as Record<string, unknown>[];
+  const byType = (type: string) => graph.find((node) => node["@type"] === type);
+
+  test("describes the SDK as free, MIT-licensed software published by the organization", () => {
+    const software = byType("SoftwareApplication");
+    expect(software).toMatchObject({
+      name: "@bloxwap/hyperliquid",
+      url: site,
+      applicationCategory: "DeveloperApplication",
+      license: "https://opensource.org/licenses/MIT",
+      offers: { "@type": "Offer", price: "0" },
+      publisher: { "@id": organization.id },
+    });
+    expect(software?.softwareVersion).toBe(sdkPackage.version);
+  });
+
+  test("gives the organization a contact point and shares its @id with the root site", () => {
+    expect(byType("Organization")).toMatchObject({
+      "@id": "https://bloxwap.com/#organization",
+      contactPoint: { "@type": "ContactPoint", contactType: "customer support", email: organization.email },
+    });
+  });
+
+  test("serializes safely inside a script element", () => {
+    expect(jsonLdScript({ a: "</script><script>" })).toBe('{"a":"\\u003c/script>\\u003cscript>"}');
+    expect(JSON.parse(jsonLdScript(homeStructuredData()))).toEqual(homeStructuredData());
+  });
+});
diff --git a/apps/docs/lib/agent.ts b/apps/docs/lib/agent.ts
new file mode 100644
index 00000000..cebc0e9c
--- /dev/null
+++ b/apps/docs/lib/agent.ts
@@ -0,0 +1,197 @@
+// Machine-readable files for AI agents and crawlers: llms.txt, llms-full.txt, and homepage JSON-LD.
+// GitHub Pages serves static files only, so everything here is rendered once at build time.
+import sdkPackage from "../../../packages/hyperliquid/package.json";
+import { homeDescription, siteUrl } from "./social";
+
+export const origin = siteUrl.origin;
+export const repository = "https://github.com/bloxwap/hyperliquid";
+export const npmPackage = "https://www.npmjs.com/package/@bloxwap/hyperliquid";
+
+/** Company facts shared with the bloxwap.github.io root site. Keep them true. */
+export const organization = {
+  id: "https://bloxwap.com/#organization",
+  name: "Bloxwap, Inc.",
+  url: "https://bloxwap.com",
+  email: "support@bloxwap.com",
+  sameAs: [
+    "https://x.com/bloxwap",
+    "https://github.com/bloxwap",
+    "https://t.me/bloxwap",
+    "https://discord.com/invite/cEfkcg6JHT",
+    "https://www.reddit.com/r/Bloxwap/",
+  ],
+  about: new URL("about/", siteUrl).href,
+  contact: new URL("contact/", siteUrl).href,
+  privacy: new URL("privacy/", siteUrl).href,
+};
+
+export type AgentPage = { url: string; title: string; description?: string };
+
+/** The published URL of a site path such as `/docs/clients/` or `llms.txt`. */
+export function absoluteUrl(path: string): string {
+  return new URL(path.replace(/^\/+/, ""), siteUrl).href;
+}
+
+/** The published URL of a page route such as `/docs/clients`, with the site's trailing slash. */
+export function pageUrl(url: string): string {
+  const path = url.replace(/^\/+|\/+$/g, "");
+  return absoluteUrl(path ? `${path}/` : "");
+}
+
+/** The llms.txt index (https://llmstxt.org): when to use the SDK, how to call it, and every docs page. */
+export function llmsText(pages: AgentPage[]): string {
+  const docs = [...pages]
+    .sort((a, b) => a.url.localeCompare(b.url))
+    .map((page) => `- [${page.title}](${pageUrl(page.url)})${page.description ? `: ${page.description}` : ""}`);
+
+  return `# Hyperliquid SDK (@bloxwap/hyperliquid)
+
+> ${homeDescription} \`@bloxwap/hyperliquid\` is an MIT-licensed, community-supported TypeScript client for the Hyperliquid exchange API, published on npm by Bloxwap, Inc.
+
+It covers the whole public Hyperliquid API: the Info endpoint (market data and account state), the Exchange endpoint (signed trading and account actions), WebSocket subscriptions, and the Explorer endpoint. Requests and responses are fully typed and validated. It runs on Bun 1.3.3+, Node.js 22.12+, modern browsers, and React Native, on mainnet or testnet.
+
+## When to use this
+
+Use \`@bloxwap/hyperliquid\` when an agent or developer, working in TypeScript or JavaScript, needs to:
+
+- Read Hyperliquid market data: mid prices, order books, candles, funding, asset metadata, and perp or spot contexts (\`InfoClient\`).
+- Read a user's positions, open orders, fills, balances, vault equity, or portfolio history (\`InfoClient\`).
+- Place, modify, or cancel orders; move funds; manage leverage, agent wallets, vaults, sub-accounts, or multi-sig accounts (\`ExchangeClient\`).
+- Stream live prices, trades, order books, and account events over WebSocket with automatic reconnection and resubscription (\`SubscriptionClient\`).
+- Look up blocks, transactions, and addresses (\`ExplorerClient\`).
+- Sign Hyperliquid L1 and user-signed actions with a viem account, a browser wallet, or a raw private key (\`@bloxwap/hyperliquid/signing\`).
+- Format prices and sizes to Hyperliquid's precision rules and map symbols to asset IDs (\`@bloxwap/hyperliquid/utils\`).
+
+Do not use it for other exchanges, for languages other than TypeScript or JavaScript (use Hyperliquid's official Python SDK instead), or as a hosted trading service: it is a client library that runs in your code and never holds keys or funds for you.
+
+## How to call it
+
+Install with \`npm i @bloxwap/hyperliquid\` (or \`bun add\`, \`pnpm add\`, \`yarn add\`), then:
+
+\`\`\`ts
+import { HttpTransport, InfoClient } from "@bloxwap/hyperliquid";
+
+const info = new InfoClient({ transport: new HttpTransport() });
+const mids = await info.allMids(); // { BTC: "…", ETH: "…", … }
+\`\`\`
+
+Trading needs a wallet. Test with \`new HttpTransport({ isTestnet: true })\` before using a funded key:
+
+\`\`\`ts
+import { ExchangeClient, HttpTransport } from "@bloxwap/hyperliquid";
+import { privateKeyToAccount } from "viem/accounts";
+
+const exchange = new ExchangeClient({ transport: new HttpTransport(), wallet: privateKeyToAccount("0x...") });
+await exchange.order({
+  orders: [{ a: 0, b: true, p: "50000", s: "0.01", r: false, t: { limit: { tif: "Gtc" } } }],
+  grouping: "na",
+});
+\`\`\`
+
+Every client method takes the Hyperliquid API's own request fields and returns its typed response. Errors are typed classes (\`ApiRequestError\`, \`HttpRequestError\`, \`WebSocketRequestError\`, \`ValidationError\`); see Error handling below.
+
+## Docs
+
+Every documentation page also has a Markdown mirror: append \`.md\` to its path without the trailing slash (for example, \`/hyperliquid/docs/clients/\` becomes \`/hyperliquid/docs/clients.md\`).
+
+${docs.join("\n")}
+
+## Optional
+
+- [Full documentation as Markdown](${absoluteUrl("llms-full.txt")}): Every docs page above in one plain-text file.
+- [Sitemap](${absoluteUrl("sitemap.xml")}): Every page on this site.
+- [Source code](${repository}): MIT-licensed repository and issue tracker.
+- [npm package](${npmPackage}): Current version ${sdkPackage.version}.
+- [About Bloxwap](${organization.about}): The company that maintains the SDK.
+- [Contact](${organization.contact}): ${organization.email}, GitHub issues, X, and Discord.
+- [Privacy](${organization.privacy}): No cookies or analytics on this site.
+`;
+}
+
+/**
+ * Prepares a docs source file for agents: drops YAML front matter and turns relative Markdown links
+ * (as written for GitHub, e.g. `../clients.md#info-endpoint`) into absolute website URLs.
+ * `sourcePath` is the file's path inside `docs/`, such as `guides/README.md`.
+ */
+export function agentMarkdown(raw: string, sourcePath: string): string {
+  const body = raw.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n+/, "");
+  const base = new URL(`docs/${sourcePath}`, "https://docs.invalid/");
+  return body
+    .replace(/\]\(([^)\s]+\.md(?:#[^)\s]*)?)\)/g, (match, href: string) => {
+      if (/^(?:[a-z][a-z\d+.-]*:|\/|#)/i.test(href)) return match;
+      const target = new URL(href, base);
+      const page = target.pathname.replace(/(^|\/)README\.md$/i, "$1").replace(/\.md$/i, "/");
+      return `](${absoluteUrl(page)}${target.hash})`;
+    })
+    .trim();
+}
+
+/** llms-full.txt: the llms.txt header followed by every docs page's Markdown. */
+export function llmsFullText(pages: (AgentPage & { markdown: string })[]): string {
+  const sections = pages.map((page) => `<!-- Source: ${pageUrl(page.url)} -->\n\n${page.markdown}`);
+  return `# Hyperliquid SDK (@bloxwap/hyperliquid): full documentation
+
+> ${homeDescription} The index of these pages, with guidance on when to use the SDK, is at ${absoluteUrl("llms.txt")}.
+
+${sections.join("\n\n---\n\n")}
+`;
+}
+
+/** Homepage JSON-LD: the SDK as a SoftwareApplication, published by the organization. */
+export function homeStructuredData(): Record<string, unknown> {
+  const home = siteUrl.href;
+  return {
+    "@context": "https://schema.org",
+    "@graph": [
+      {
+        "@type": "Organization",
+        "@id": organization.id,
+        name: organization.name,
+        alternateName: "Bloxwap",
+        url: organization.url,
+        logo: absoluteUrl("logos/bloxwap-symbol.svg"),
+        email: organization.email,
+        sameAs: organization.sameAs,
+        contactPoint: {
+          "@type": "ContactPoint",
+          contactType: "customer support",
+          email: organization.email,
+          url: organization.contact,
+          availableLanguage: "English",
+        },
+      },
+      {
+        "@type": "SoftwareApplication",
+        "@id": `${home}#software`,
+        name: sdkPackage.name,
+        alternateName: "Bloxwap Hyperliquid SDK",
+        description: homeDescription,
+        url: home,
+        applicationCategory: "DeveloperApplication",
+        applicationSubCategory: "API client library",
+        operatingSystem: "Node.js, Bun, Web browser, React Native",
+        programmingLanguage: "TypeScript",
+        softwareVersion: sdkPackage.version,
+        license: "https://opensource.org/licenses/MIT",
+        codeRepository: repository,
+        downloadUrl: npmPackage,
+        isAccessibleForFree: true,
+        offers: { "@type": "Offer", price: "0", priceCurrency: "USD" },
+        publisher: { "@id": organization.id },
+      },
+      {
+        "@type": "WebSite",
+        "@id": `${home}#website`,
+        name: "Hyperliquid SDK documentation",
+        url: home,
+        inLanguage: "en",
+        publisher: { "@id": organization.id },
+      },
+    ],
+  };
+}
+
+/** Serializes JSON-LD for a <script> element; `<` is escaped so content cannot close the tag. */
+export function jsonLdScript(data: unknown): string {
+  return JSON.stringify(data).replace(/</g, "\\u003c");
+}
diff --git a/apps/docs/lib/social.ts b/apps/docs/lib/social.ts
index 8d9c89ae..6c632af4 100644
--- a/apps/docs/lib/social.ts
+++ b/apps/docs/lib/social.ts
@@ -19,7 +19,8 @@ export function socialMetadata(pageUrl: string, title: string, description: stri
 
   return {
     description,
-    alternates: { canonical },
+    // Point agents at the plain-text index of the whole site from every page.
+    alternates: { canonical, types: { "text/plain": new URL("llms.txt", siteUrl).href } },
     openGraph: {
       type: "website",
       siteName: "Bloxwap",
diff --git a/apps/docs/package.json b/apps/docs/package.json
index ab22fc3f..09c88fd7 100644
--- a/apps/docs/package.json
+++ b/apps/docs/package.json
@@ -7,6 +7,7 @@
     "preview": "bun run scripts/preview.ts",
     "build": "fumadocs-mdx && next build && bun run scripts/export-markdown.ts && bun run scripts/verify-export.ts",
     "check": "bun run check:content && fumadocs-mdx && next typegen && tsc --noEmit",
+    "test": "bun test lib/",
     "check:content": "bun run scripts/check-content.ts && markdownlint-cli2 --config ../../.markdownlint-cli2.jsonc ../../README.md ../../packages/hyperliquid/README.md README.md \"content/**/*.md\""
   },
   "dependencies": {
diff --git a/apps/docs/public/llms.txt b/apps/docs/public/llms.txt
deleted file mode 100644
index cf855caa..00000000
--- a/apps/docs/public/llms.txt
+++ /dev/null
@@ -1,50 +0,0 @@
-# Hyperliquid SDK · Bloxwap
-
-> @bloxwap/hyperliquid is an open-source (MIT) TypeScript and JavaScript SDK for the Hyperliquid exchange API. It provides typed clients for market data (Info), trading (Exchange), real-time streams (Subscription/WebSocket), and explorer data, over HTTP or WebSocket transports, on Bun, Node.js, browsers, and React Native. Maintained by Bloxwap, Inc. and published on npm.
-
-## When to use this SDK
-
-Reach for this SDK when the task is to:
-
-- Read Hyperliquid market data (mids, order books, candles, funding) or account state from TypeScript/JavaScript.
-- Place, modify, or cancel Hyperliquid orders, manage vaults, or sign exchange actions with a wallet.
-- Subscribe to real-time market or account updates with automatic reconnection.
-- Build a trading bot, dashboard, or agent that calls the Hyperliquid API programmatically.
-
-Do not use it for non-Hyperliquid exchanges, or for custody of user funds; signing keys stay with the caller.
-
-## How an agent should use this site
-
-- Every documentation page has a Markdown mirror: append `.md` to the page path without its trailing slash (for example `/hyperliquid/docs/clients/` becomes `/hyperliquid/docs/clients.md`).
-- `llms-full.txt` contains the entire documentation as one Markdown file.
-- The npm package README doubles as the quick-start: https://www.npmjs.com/package/@bloxwap/hyperliquid
-
-## Documentation (Markdown)
-
-- [Documentation overview](https://bloxwap.github.io/hyperliquid/docs.md): SDK capabilities and install
-- [Connect to Hyperliquid (transports)](https://bloxwap.github.io/hyperliquid/docs/transports.md): HTTP and WebSocket transports, endpoints, timeouts
-- [Clients](https://bloxwap.github.io/hyperliquid/docs/clients.md): Info, Exchange, Subscription, and Explorer clients
-- [Error handling](https://bloxwap.github.io/hyperliquid/docs/error-handling.md): typed errors and retries
-- [Signing](https://bloxwap.github.io/hyperliquid/docs/signing.md): wallets, EIP-712 action signing
-- [Utilities](https://bloxwap.github.io/hyperliquid/docs/utilities.md): helpers for prices, sizes, and symbols
-- [Guides](https://bloxwap.github.io/hyperliquid/docs/guides.md): task-focused walkthroughs
-- [Agent wallets and vaults](https://bloxwap.github.io/hyperliquid/docs/guides/agent-wallets-and-vaults.md): delegated signing for agents
-- [Browser wallets](https://bloxwap.github.io/hyperliquid/docs/guides/browser-wallets.md): connect MetaMask-style wallets
-- [Market orders](https://bloxwap.github.io/hyperliquid/docs/guides/market-orders.md): place market orders correctly
-- [Tree-shaking](https://bloxwap.github.io/hyperliquid/docs/guides/tree-shaking.md): minimal bundles
-- [Reference](https://bloxwap.github.io/hyperliquid/docs/reference.md): API reference notes
-- [Known documentation drift](https://bloxwap.github.io/hyperliquid/docs/reference/known-drift.md): where the API differs from its docs
-
-## Machine-readable files
-
-- [llms-full.txt](https://bloxwap.github.io/hyperliquid/llms-full.txt): all documentation in one Markdown file
-- [Sitemap](https://bloxwap.github.io/hyperliquid/sitemap.xml): every published page
-- [Search index](https://bloxwap.github.io/hyperliquid/search-index.json): full-text search data as JSON
-
-## Project
-
-- [GitHub repository](https://github.com/bloxwap/hyperliquid): source, issues, and releases
-- [npm package](https://www.npmjs.com/package/@bloxwap/hyperliquid): @bloxwap/hyperliquid
-- [About](https://bloxwap.github.io/hyperliquid/about/): who maintains this SDK
-- [Contact](https://bloxwap.github.io/hyperliquid/contact/): support email and issue tracker
-- [Privacy](https://bloxwap.github.io/hyperliquid/privacy/): this site collects no data
diff --git a/apps/docs/scripts/export-markdown.ts b/apps/docs/scripts/export-markdown.ts
index 25b5e6f8..588ebacc 100644
--- a/apps/docs/scripts/export-markdown.ts
+++ b/apps/docs/scripts/export-markdown.ts
@@ -1,6 +1,6 @@
 /**
  * Export agent-readable Markdown to the static site: a `.md` mirror for every documentation
- * page (GitHub Pages serves them as text/markdown) and a single llms-full.txt. Runs after
+ * page (GitHub Pages serves them as text/markdown). Runs after
  * `next build` so verify-export.ts can check the results alongside everything else.
  */
 import { resolve } from "node:path";
@@ -8,7 +8,6 @@ import { resolve } from "node:path";
 const appDir = resolve(import.meta.dir, "..");
 const outDir = resolve(process.argv[2] ?? resolve(appDir, "out"));
 const contentDir = resolve(appDir, "content/docs");
-const publishedBase = "https://bloxwap.github.io/hyperliquid";
 
 // The page order follows the root meta.json; nested pages sort after their folder index.
 const meta: { pages?: string[] } = await Bun.file(resolve(contentDir, "meta.json")).json();
@@ -29,17 +28,6 @@ const files = (await Array.fromAsync(new Bun.Glob("**/*.md").scan({ cwd: content
     return rank(slugA) - rank(slugB) || slugA.localeCompare(slugB);
   });
 
-function stripFrontmatter(markdown: string): string {
-  return markdown.replace(/^---\n[\s\S]*?\n---\n+/, "");
-}
-
-const parts = [
-  "# Hyperliquid SDK · Bloxwap — full documentation",
-  "",
-  "> Complete @bloxwap/hyperliquid documentation in one Markdown file, generated from " +
-    `${publishedBase}/docs/. Individual pages are also available as .md mirrors ` +
-    "(append .md to a page path). See llms.txt for guidance.",
-];
 for (const file of files) {
   const slug = file
     .replace(/(^|\/)README\.md$/i, "$1")
@@ -48,13 +36,6 @@ for (const file of files) {
   const markdown = await Bun.file(resolve(contentDir, file)).text();
   const mirror = slug ? `docs/${slug}.md` : "docs.md";
   await Bun.write(resolve(outDir, mirror), markdown);
-  parts.push(
-    "",
-    `<!-- Source: ${publishedBase}/docs/${slug ? `${slug}/` : ""} -->`,
-    "",
-    stripFrontmatter(markdown).trim(),
-  );
 }
-await Bun.write(resolve(outDir, "llms-full.txt"), `${parts.join("\n")}\n`);
 
-console.log(`Exported ${files.length} Markdown mirrors and llms-full.txt.`);
+console.log(`Exported ${files.length} Markdown mirrors.`);
diff --git a/apps/docs/scripts/verify-export.ts b/apps/docs/scripts/verify-export.ts
index b24881dc..23026727 100644
--- a/apps/docs/scripts/verify-export.ts
+++ b/apps/docs/scripts/verify-export.ts
@@ -326,6 +326,10 @@ if (!files.has("llms.txt")) {
   if (!llms.startsWith("# ")) errors.add("llms.txt must start with an H1 project name.");
   if (!/when to use/i.test(llms)) errors.add("llms.txt: missing when-to-use guidance for agents.");
   if (!llms.includes(`${publishedBasePath}/llms-full.txt`)) errors.add("llms.txt: no link to llms-full.txt.");
+  for (const route of [...contentPages.values()].filter((route) => route.startsWith("/docs/"))) {
+    const expected = `${publishedOrigin}${publishedBasePath}${route}`;
+    if (!llms.includes(`](${expected})`)) errors.add(`llms.txt: missing a link to ${expected}.`);
+  }
   checkedAgentFiles++;
 }
 
@@ -334,6 +338,12 @@ if (!files.has("llms-full.txt")) {
 } else {
   const full = await readOut("llms-full.txt");
   if (full.length < 10_000) errors.add(`llms-full.txt looks incomplete (${full.length} characters).`);
+  for (const route of [...contentPages.values()].filter((route) => route.startsWith("/docs/"))) {
+    const expected = `${publishedOrigin}${publishedBasePath}${route}`;
+    if (!full.includes(`<!-- Source: ${expected} -->`)) errors.add(`llms-full.txt: missing ${expected}.`);
+  }
+  if (/-->\n\n---\r?\n/.test(full)) errors.add("llms-full.txt: frontmatter was not removed.");
+  if (/\]\((?![a-z]+:|\/|#)[^)]*\.md\b/i.test(full)) errors.add("llms-full.txt: has relative Markdown links.");
   checkedAgentFiles++;
 }
 
@@ -383,6 +393,7 @@ if (homepage) {
       if (!software?.name || !software.description || !software.url) {
         errors.add("index.html: SoftwareApplication JSON-LD needs name, description, and url.");
       }
+      if (!software?.softwareVersion) errors.add("index.html: SoftwareApplication JSON-LD needs the SDK version.");
       const organization = graph.find((node) => node["@type"] === "Organization") as
         | { contactPoint?: { email?: string; contactType?: string } }
         | undefined;