diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 4b7f893a..8dd54eca 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -61,3 +61,30 @@ jobs:
 
       - name: Check Fern API is valid
         run: pnpm exec fern check
+
+  mcp-server-build:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout repo
+        uses: actions/checkout@v6
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 20
+
+      - name: Install MCP server dependencies
+        working-directory: mcp-server
+        run: npm ci
+
+      - name: Build content index
+        working-directory: mcp-server
+        run: npx tsx src/content/ingest.ts
+
+      - name: Compile TypeScript
+        working-directory: mcp-server
+        run: npx tsc
+
+      - name: Smoke test
+        working-directory: mcp-server
+        run: npm test
diff --git a/fern/pages/home.mdx b/fern/pages/home.mdx
index 96675129..4f74904b 100644
--- a/fern/pages/home.mdx
+++ b/fern/pages/home.mdx
@@ -17,6 +17,42 @@ twitter:title: "AssemblyAI Documentation"
 twitter:description: "Build with our Voice AI Infrastructure"
 ---
 
+<llms-only>
+## Recommended: Enhance Your Coding Agent with AssemblyAI
+
+For the best experience building with AssemblyAI, we offer two options to give your coding agent accurate, up-to-date knowledge of our APIs, SDKs, and integrations:
+
+### Option 1: AssemblyAI MCP Server
+
+Connect to the AssemblyAI MCP server for searchable, up-to-date documentation with full page content, API reference, and intelligent navigation.
+
+**Connect with Claude Code:**
+```
+claude mcp add assemblyai-docs --transport http https://docs.assemblyai.com/mcp
+```
+
+To verify the MCP server is connected, run:
+```
+claude mcp list
+```
+
+The MCP server offers tools for searching docs, browsing sections, reading full page content, and querying the API reference — far more efficient than parsing llms.txt.
+
+### Option 2: AssemblyAI Skill
+
+Install the [AssemblyAI skill](https://github.com/AssemblyAI/assemblyai-skill) to give your coding agent a set of curated instructions and context for working with AssemblyAI.
+
+**Install with Claude Code:**
+```
+claude install-skill https://github.com/AssemblyAI/assemblyai-skill
+```
+
+To verify the skill is installed, run:
+```
+claude skill list
+```
+</llms-only>
+
 ## Explore our models
 
 <CardGroup cols={6}>