diff --git a/fern/products/docs/pages/ai/mcp-server.mdx b/fern/products/docs/pages/ai/mcp-server.mdx
index f9e516711a..1a260d927c 100644
--- a/fern/products/docs/pages/ai/mcp-server.mdx
+++ b/fern/products/docs/pages/ai/mcp-server.mdx
@@ -9,6 +9,14 @@ This is the server your readers connect to, and it serves your content. To point
 
 Your MCP server is available at `your-documentation-site.com/_mcp/server`. For example, the MCP server for this site is at [https://buildwithfern.com/learn/_mcp/server](https://buildwithfern.com/learn/_mcp/server).
 
+## What the MCP server does
+
+The server exposes a single tool, `ask_docs`. It accepts a natural-language question and returns an answer grounded in your documentation using Retrieval Augmented Generation (RAG). Each answer includes citations that link back to the source pages.
+
+Retrieval is semantic, not keyword search: the server embeds the question, finds the most relevant passages in your documentation by vector similarity, and generates the answer from those passages.
+
+MCP queries run through Ask Fern and consume 2 [AI credits](/learn/docs/ai-features/overview#ai-credits) per message, the same as Ask Fern chat. Credits are shared with your site's Ask Fern usage.
+
 ## Connect to your MCP server
 
 For Claude Code and Cursor, [page action](/learn/docs/configuration/site-level-settings#page-actions-configuration) buttons let users connect in one click:
diff --git a/fern/products/docs/pages/component-library/default-components/download.mdx b/fern/products/docs/pages/component-library/default-components/download.mdx
index bf3ad25c49..3a125d7496 100644
--- a/fern/products/docs/pages/component-library/default-components/download.mdx
+++ b/fern/products/docs/pages/component-library/default-components/download.mdx
@@ -24,6 +24,10 @@ For information on how to embed images, PDFs, and other assets, check out the do
 <Download src="./assets/all-about-ferns.pdf">Download PDF</Download>
 ```
 
+<Tip>
+  The child content is plain text or a React element. Write `<Download src="...">click here</Download>` directly; the text does not need to be wrapped in a Markdown link like `[click here](.)`.
+</Tip>
+
 ### File in a button
 
 Wrap a `<Button>` to style the download trigger.
diff --git a/fern/products/docs/pages/navigation/frontmatter.mdx b/fern/products/docs/pages/navigation/frontmatter.mdx
index 11f7da40bf..1001c73a99 100644
--- a/fern/products/docs/pages/navigation/frontmatter.mdx
+++ b/fern/products/docs/pages/navigation/frontmatter.mdx
@@ -130,6 +130,10 @@ description: Use frontmatter to set a variety of page properties and metadata.
   When `description` is not set, Fern uses `subtitle` as the meta description. When [`og:description`](#seo-metadata) is not set, Fern uses `description` as the OpenGraph description for social sharing previews.
 </ParamField>
 
+<Note title="Migrating from Mintlify?">
+  In Mintlify, `description` is the visible subtitle and `og:description` is the meta description. In Fern, `subtitle` is the visible text shown on the page, `description` is the HTML meta description (not shown on the page), and `og:description` is the OpenGraph description for social sharing. When `description` is not set, Fern falls back to `subtitle` for the meta description; when `og:description` is not set, Fern falls back to `description`.
+</Note>
+
 
 ## Last updated