docs(ai): Add Fern Agent and MCP docs

fern/docs.yml

@@ -534,27 +534,27 @@ redirects:
 
   # Docs AI features (renamed pages)
   - source: /learn/docs/ai/scribe-coming-soon
-    destination: /learn/docs/ai-features/fern-writer
+    destination: /learn/docs/ai-features/fern-agent
   - source: /learn/docs/ai/scribe
-    destination: /learn/docs/ai-features/fern-writer
+    destination: /learn/docs/ai-features/fern-agent
   - source: /learn/docs/ai/slack-app
-    destination: /learn/docs/ai-features/fern-writer
+    destination: /learn/docs/ai-features/fern-agent
   - source: /learn/docs/ai/writer
-    destination: /learn/docs/ai-features/fern-writer
+    destination: /learn/docs/ai-features/fern-agent
   - source: /learn/docs/ai/llms-txt
     destination: /learn/docs/ai-features/llms-txt
   - source: /learn/docs/ai/mcp-server
     destination: /learn/docs/ai-features/mcp-server
   - source: /learn/docs/ai-features/writer
-    destination: /learn/docs/ai-features/fern-writer
+    destination: /learn/docs/ai-features/fern-agent
   - source: /learn/docs/ai-features/mcp-server/overview
     destination: /learn/docs/ai-features/mcp-server
   - source: /learn/docs/seo/llms-txt
     destination: /learn/docs/ai-features/llms-txt
   - source: /learn/docs/developer-tools/view-markdown
     destination: /learn/docs/ai-features/markdown
   - source: /learn/docs/scribe-api/slack-scribe/get-scribe-slack-install-link
-    destination: /learn/docs/ai-features/fern-writer
+    destination: /learn/docs/ai-features/fern-agent
 
   # Docs self-hosted / alternatives
   - source: /learn/docs/enterprise/self-hosted
@@ -804,7 +804,7 @@ redirects:
   - source: /learn/ask-fern/features/slack-app
     destination: /learn/docs/ai-features/ask-fern/slack-app
   - source: /learn/ask-fern/features/scribe-slack-app
-    destination: /learn/docs/ai-features/fern-writer
+    destination: /learn/docs/ai-features/fern-agent
 
   # /learn/ask-fern/* other specifics
   - source: /learn/ask-fern/getting-started/what-is-ask-fern
@@ -834,6 +834,11 @@ redirects:
   - source: /learn/ask-fern/:slug*
     destination: /learn/docs/ai-features/ask-fern/:slug*
 
+  - source: /learn/docs/ai-features/fern-writer
+    destination: /learn/docs/ai-features/fern-agent
+  - source: /learn/docs/ai-features/fern-slack
+    destination: /learn/docs/ai-features/fern-agent
+
   # Ask Fern new-location cleanup (/learn/docs/ai-features/ask-fern/*)
   - source: /learn/docs/ai-features/ask-fern/how-it-works
     destination: /learn/docs/ai-features/ask-fern/overview

fern/fern.config.json

@@ -1,4 +1,4 @@
 {
   "organization": "fern",
-  "version": "5.90.1"
+  "version": "5.100.0"
 }

fern/products/cli-api-reference/pages/docs-commands.mdx

@@ -20,6 +20,7 @@ These commands build, preview, and publish a Fern documentation site, and valida
 | [`fern docs theme upload`](#fern-docs-theme-upload) | Upload a theme to Fern's registry |
 | [`fern docs link check`](#fern-docs-link-check) | Check for broken links on a live documentation site |
 | [`fern docs theme list`](#fern-docs-theme-list) | List all themes for your organization |
+| [`fern mcp install`](#fern-mcp-install) | Connect a coding agent to your organization's Fern MCP server |
 
 ## Detailed command documentation
 
@@ -387,4 +388,42 @@ These commands build, preview, and publish a Fern documentation site, and valida
     ```
 
   </Accordion>
-</AccordionGroup>
+
+  <Accordion title="fern mcp install">
+
+    Use `fern mcp install` to register [your organization's Fern MCP server](/learn/docs/ai-features/fern-mcp-servers) with a coding agent, giving it Fern's own documentation and configuration reference alongside your live sites, deployments, analytics, and reader activity — the same tools [Fern Agent](/learn/docs/ai-features/fern-agent) works from.
+
+    <CodeBlock title="terminal">
+    ```bash
+    fern mcp install [--client claude|cursor|codex] [--org <org>]
+    ```
+    </CodeBlock>
+
+    The command configures every supported agent installed on the machine, adding a `fern` server entry that holds the server URL and an `Authorization` header. Other entries and surrounding content in each file are preserved.
+
+    | Client | Config file |
+    |--------|-------------|
+    | Claude Code | `~/.claude.json` |
+    | Cursor | `~/.cursor/mcp.json` |
+    | Codex | `~/.codex/config.toml` |
+
+    The token doesn't refresh, so re-run `fern login && fern mcp install` if the agent's Fern tools start failing.
+
+    ### client
+
+    Use `--client` to configure specific agents instead of every one detected. Repeat the flag to name more than one.
+
+    ```bash
+    fern mcp install --client claude --client cursor
+    ```
+
+    ### org
+
+    Use `--org` to override the organization ID from `fern.config.json`. The organization scopes the server URL to `https://fai.buildwithfern.com/organizations/<org>/mcp`. Outside a Fern project, the command falls back to the unscoped `https://fai.buildwithfern.com/mcp`.
+
+    ```bash
+    fern mcp install --org my-org
+    ```
+
+  </Accordion>
+</AccordionGroup>

fern/products/docs/docs.yml

@@ -182,14 +182,18 @@ navigation:
     contents:
       - page: Overview
         path: ./pages/ai/overview.mdx
-      - page: Fern Writer
-        path: ./pages/ai/writer.mdx
+      - page: Fern Agent
+        path: ./pages/ai/fern-agent.mdx
+        slug: fern-agent
       - page: AI-generated examples
         path: ./pages/ai/ai-examples.mdx
         slug: ai-examples
       - page: Markdown access
         path: ./pages/ai/markdown.mdx
         slug: markdown
+      - page: API catalog discovery
+        path: ./pages/ai/api-catalog.mdx
+        slug: api-catalog
       - section: llms-txt
         collapsed: open-by-default
         skip-slug: true
@@ -204,26 +208,29 @@ navigation:
           - page: Analytics and integration
             path: ./pages/ai/llms-txt/analytics-integration.mdx
             slug: llms-txt-analytics
-      - page: MCP server
-        path: ./pages/ai/mcp-server.mdx
-        slug: mcp-server
-      - page: API catalog discovery
-        path: ./pages/ai/api-catalog.mdx
-        slug: api-catalog
-      - section: Agent skills
+      - section: MCP
         collapsed: open-by-default
+        skip-slug: true
+        contents:
+          - page: For your site
+            path: ./pages/ai/mcp-server.mdx
+            slug: mcp-server
+          - page: For building with Fern
+            path: ./pages/ai/fern-mcp-servers.mdx
+            slug: fern-mcp-servers
+      - section: Agent skills
         skip-slug: true
         contents:
           - page: Agent setup
             path: ./pages/ai/agent-setup.mdx
             slug: agent-setup
             hidden: true
-          - page: fern-docs skill
-            path: ./pages/ai/agent-skills.mdx
-            slug: agent-skills
-          - page: Custom skills
+          - page: For your site
             path: ./pages/ai/host-skills.mdx
             slug: host-skills
+          - page: For building with Fern
+            path: ./pages/ai/agent-skills.mdx
+            slug: agent-skills
       - section: Ask Fern
         slug: ask-fern
         contents:

fern/products/docs/pages/ai/agent-setup.mdx

@@ -1,6 +1,6 @@
 ---
 title: Agent setup
-description: Copy-paste commands to connect a coding agent to the Fern CLI, the fern-docs agent skill, and Fern's two MCP servers.
+description: Copy-paste commands to connect a coding agent to the Fern CLI, the fern-docs agent skill, and Fern's MCP server.
 ---
 
 If you're an agent reading this page, run these commands yourself rather than asking the user to run them. The only step that needs a human is the browser login that `fern login` opens.
@@ -11,7 +11,6 @@ If you're an agent reading this page, run these commands yourself rather than as
 npm install -g fern-api
 fern login
 npx skills add fern-api/skills --skill fern-docs -a claude-code
-claude mcp add --transport http fern-docs https://buildwithfern.com/learn/_mcp/server
 fern mcp install --client claude
 ```
 
@@ -24,23 +23,12 @@ npx skills add fern-api/skills --skill fern-docs -a cursor
 fern mcp install --client cursor
 ```
 
-`fern mcp install` registers the organization server. Add the documentation server to `.cursor/mcp.json`:
-
-```json
-{
-  "mcpServers": {
-    "fern-docs": { "url": "https://buildwithfern.com/learn/_mcp/server" }
-  }
-}
-```
-
 ## Codex
 
 ```bash
 npm install -g fern-api
 fern login
 npx skills add fern-api/skills --skill fern-docs -a codex
-codex mcp add fern-docs --url https://buildwithfern.com/learn/_mcp/server
 fern mcp install --client codex
 ```
 
@@ -52,12 +40,11 @@ fern login
 npx skills add fern-api/skills --skill fern-docs -a github-copilot
 ```
 
-[`fern mcp install`](/learn/cli-api-reference/cli-reference/sdk-commands) supports Claude Code, Cursor, and Codex only, so register both servers in `.vscode/mcp.json` and complete the browser login that the organization server prompts for on first use:
+[`fern mcp install`](/learn/cli-api-reference/cli-reference/commands) supports Claude Code, Cursor, and Codex only, so register the server in `.vscode/mcp.json` and complete the browser login it prompts for on first use:
 
 ```json
 {
   "servers": {
-    "fern-docs": { "url": "https://buildwithfern.com/learn/_mcp/server" },
     "fern-org": { "url": "https://fai.buildwithfern.com/organizations/YOUR_ORGANIZATION/mcp" }
   }
 }
@@ -67,11 +54,6 @@ npx skills add fern-api/skills --skill fern-docs -a github-copilot
 
 ## Other MCP clients
 
-Claude Desktop, Windsurf, VS Code, and any other client take the server URLs directly:
-
-| Server | URL | Auth |
-|--------|-----|------|
-| Fern documentation | `https://buildwithfern.com/learn/_mcp/server` | None |
-| Your organization | `https://fai.buildwithfern.com/organizations/YOUR_ORGANIZATION/mcp` | Browser login on first use |
+Claude Desktop, Windsurf, VS Code, and any other client take the server URL directly: `https://fai.buildwithfern.com/organizations/YOUR_ORGANIZATION/mcp`, with a browser login on first use.
 
-Install the skill with `npx skills add fern-api/skills --skill fern-docs -g`, which writes it to the shared `.agents/skills/` location instead of a single agent's directory.
+Install the skill with `npx skills add fern-api/skills --skill fern-docs -g`, which writes it to the shared `.agents/skills/` location instead of a single agent's directory.

fern/products/docs/pages/ai/agent-skills.mdx

@@ -1,5 +1,5 @@
 ---
-title: fern-docs skill
+title: Skills for using Fern Docs
 description: Install the fern-docs agent skill to teach coding agents how to author and edit Fern Docs sites.
 availability: beta
 ---
@@ -68,7 +68,7 @@ The skill's `SKILL.md` is an index that agents read first. It contains:
 - **URL preservation rules** for setting up [redirects](/learn/docs/seo/redirects) when an edit moves, renames, or deletes a page
 - **Cross-referencing guidelines** for connecting related pages
 - **Authentication and RBAC guidance** for gating pages and inline content by role, wiring in an auth method, and understanding which config lives in the repo versus the Dashboard
-- **Pointers to Fern resources** the agent can query at runtime, like the [MCP server](/learn/docs/ai-features/mcp-server) and [`llms.txt`](/learn/docs/ai-features/llms-txt), along with the convention for fetching any page as [Markdown](/learn/docs/ai-features/markdown) by appending `.md` to its URL
+- **Pointers to Fern resources** the agent can query at runtime, like [Fern's MCP server](/learn/docs/ai-features/fern-mcp-servers) and [`llms.txt`](/learn/docs/ai-features/llms-txt), along with the convention for fetching any page as [Markdown](/learn/docs/ai-features/markdown) by appending `.md` to its URL
 
 ### References