Skip to content

Clarify MCP server tool/credits, Download children, Mintlify subtitle m… #6821

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Draft
fern-api wants to merge 1 commit into
base: main
Choose a base branch
from
Draft

Clarify MCP server tool/credits, Download children, Mintlify subtitle m… #6821

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 8 additions & 0 deletions fern/products/docs/pages/ai/mcp-server.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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:
Expand Down
4 changes: 4 additions & 0 deletions fern/products/docs/pages/component-library/default-components/download.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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](.)`.

@github-actions github-actions Bot Sep 2, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] <Microsoft.UIVerbs> reported by reviewdog 🐶
Use 'select' instead of the input-specific verb 'click'.

@github-actions github-actions Bot Sep 2, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🚫 [vale] <Microsoft.Contractions> reported by reviewdog 🐶
Use 'doesn't' instead of 'does not'.

Suggested change
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](.)`.
The child content is plain text or a React element. Write `<Download src="...">click here</Download>` directly; the text doesn't need to be wrapped in a Markdown link like `[click here](.)`.

@github-actions github-actions Bot Sep 2, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ [vale] <Microsoft.UIVerbs> reported by reviewdog 🐶
Use 'select' instead of the input-specific verb 'click'.

</Tip>

### File in a button

Wrap a `<Button>` to style the download trigger.
Expand Down
4 changes: 4 additions & 0 deletions fern/products/docs/pages/navigation/frontmatter.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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

Expand Down
Loading