From c3b79cddba4a2eb5a788d9c0edb6157f93b72a21 Mon Sep 17 00:00:00 2001
From: gsharp-aai <gsharp@assemblyai.com>
Date: Mon, 23 Mar 2026 14:59:01 -0700
Subject: [PATCH 1/3] Add MCP server and skill instructions to home.mdx for LLM
 agents

---
 fern/pages/home.mdx | 36 ++++++++++++++++++++++++++++++++++++
 1 file changed, 36 insertions(+)

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}>

From a6bef00d1835695d008df8a2d691e5cf792ad559 Mon Sep 17 00:00:00 2001
From: gsharp-aai <gsharp@assemblyai.com>
Date: Mon, 23 Mar 2026 16:49:34 -0700
Subject: [PATCH 2/3] Add MCP server build check to CI

---
 .github/workflows/ci.yml | 23 +++++++++++++++++++++++
 1 file changed, 23 insertions(+)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 4b7f893a..13229898 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -61,3 +61,26 @@ 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

From 2d238b50713800d4f94cda3a041f018e1220c17c Mon Sep 17 00:00:00 2001
From: gsharp-aai <gsharp@assemblyai.com>
Date: Mon, 23 Mar 2026 16:55:27 -0700
Subject: [PATCH 3/3] Add smoke test step to MCP server CI job

---
 .github/workflows/ci.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 13229898..8dd54eca 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -84,3 +84,7 @@ jobs:
       - name: Compile TypeScript
         working-directory: mcp-server
         run: npx tsc
+
+      - name: Smoke test
+        working-directory: mcp-server
+        run: npm test