From 4c8ff692b3d024339f5c02f2cae8a3c9929d7359 Mon Sep 17 00:00:00 2001 From: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com> Date: Wed, 2 Sep 2026 17:45:03 +0000 Subject: [PATCH] docs: clarify MCP server tool/credits, Download children, Mintlify subtitle mapping Co-Authored-By: bot_apk --- fern/products/docs/pages/ai/mcp-server.mdx | 8 ++++++++ .../component-library/default-components/download.mdx | 4 ++++ fern/products/docs/pages/navigation/frontmatter.mdx | 4 ++++ 3 files changed, 16 insertions(+) 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 PDF ``` + + The child content is plain text or a React element. Write `click here` directly; the text does not need to be wrapped in a Markdown link like `[click here](.)`. + + ### File in a button Wrap a `