AI & LLMs

Docs for LLMCopy Anchor Link

Serve your docs as Markdown for LLMs and AI agents:

npx @fumadocs/cli feature llms

It enables processed Markdown on your docs collection, adds docsLlms to lib/source.ts, and creates the routes below. The generated files are listed here if you prefer a manual setup.

docsLlmsCopy Anchor Link

llms() renders your docs for LLMs. renderPage turns one page into Markdown, from the processed document rather than the raw file content:

import { llms } from 'fumadocs-core/source';

export const docsLlms = llms(source, {
  renderPage: async (page) => `# ${page.data.title} (${page.url})

${await page.data.getText('processed')}`,
});

renderPage reads the processed Markdown of pages, so enable includeProcessedMarkdown:

import { defineDocs } from 'fumadocs-mdx/config';

export const docs = defineDocs({
  dir: 'content/docs',
  docs: { 
    postprocess: {
      includeProcessedMarkdown: true,
    },
  },
});

MDX components appear as JSX syntax by default. Render them into meaningful Markdown with the output option.

Runtime content sources like @fumadocs/local-md resolve on demand. Pass their getSource and the CLI generates the same routes:

export const docsLlms = llms(getSource, {
  renderPage: (page) => `# ${page.data.title} (${page.url})

${page.data.content}`,
});

With getSource, index() and indexNode() return a promise instead of a string.

llms.txtCopy Anchor Link

An index of all pages, generated from the page tree.

import { docsLlms } from '@/lib/source';

export async function loader() {
  return new Response(await docsLlms.index());
}

llms-full.txtCopy Anchor Link

The content of all pages in a single file.

import { docsLlms } from '@/lib/source';

export async function loader() {
  return new Response(await docsLlms.full());
}

*.mdCopy Anchor Link

The Markdown of a single page, for AI agents.

import { createGetUrl } from 'fumadocs-core/source';

export const docsContentRoute = '/llms.mdx/docs';

const getContentUrl = createGetUrl(docsContentRoute);

export function getPageMarkdownUrl(page: { slugs: string[]; locale?: string }) {
  const segments = [...page.slugs, 'content.md'];

  return { segments, url: getContentUrl(segments, page.locale) };
}

AcceptCopy Anchor Link

AI agents can ask for Markdown with the Accept header. Serve the Markdown of a page when the request prefers it:

import { isMarkdownPreferred, rewritePath } from 'fumadocs-core/negotiation';
import type { Route } from './+types/root';

const { rewrite: rewriteLLM } = rewritePath('/docs{/*path}', '/llms.mdx/docs{/*path}/content.md');
const serverMiddleware: Route.MiddlewareFunction = async ({ request }, next) => {
  const url = new URL(request.url);
  const path = isMarkdownPreferred(request) && rewriteLLM(url.pathname);

  // the headers of `Response.redirect()` are immutable, build the response directly
  if (path)
    return new Response(null, {
      status: 302,
      headers: { Location: new URL(path, url).toString(), Vary: 'Accept' }, 
    });

  return next();
};

export const middleware = [serverMiddleware];

The same URL now has two representations, so the response needs Vary: Accept to prevent cache collisions.

Page ActionsCopy Anchor Link

Page actions let readers copy the Markdown of a page, or open the page in AI apps. They require the *.md route.

Return the Markdown URL from the loader of your docs page, and render them in the page:

import { MarkdownCopyButton, ViewOptionsPopover } from 'fumadocs-ui/layouts/docs/page';
import { getPageMarkdownUrl } from '@/lib/shared';

// in your loader
return {
  path: page.path,
  markdownUrl: getPageMarkdownUrl(page).url,
};

// in your page
<div className="flex flex-row gap-2 items-center border-b pt-2 pb-6">
  <MarkdownCopyButton markdownUrl={markdownUrl} />
  <ViewOptionsPopover
    markdownUrl={markdownUrl}
    githubUrl={`https://github.com/${owner}/${repo}/blob/main/content/docs/${encodeURI(path)}`}
  />
</div>;

MCP ServerCopy Anchor Link

Expose your docs to AI agents through a MCP server, with tools to list, search and read pages.

npx @fumadocs/cli feature mcp

It creates a /api/mcp route with the streamable HTTP transport, on top of the LLM routes above.

The tools come from fumadocs-core/mcp.

import type { Route } from './+types/api.mcp';
import { createMcpHandler, McpServer } from '@modelcontextprotocol/server';
import { registerSearchTool, registerSourceTools } from 'fumadocs-core/mcp';
import { createFromSource } from 'fumadocs-core/search/server';
import { docsLlms, source } from '@/lib/source';

const handler = createMcpHandler(() => {
  const mcp = new McpServer(
    {
      name: 'docs',
      version: '1.0.0',
    },
    // the tools never change, a stream to watch them would hold a serverless function open
    { capabilities: { tools: { listChanged: false } } },
  );

  registerSourceTools(mcp, source, docsLlms);
  registerSearchTool(mcp, createFromSource(source));

  return mcp;
});

export async function loader({ request }: Route.LoaderArgs) {
  return handler.fetch(request);
}

export async function action({ request }: Route.ActionArgs) {
  return handler.fetch(request);
}

Connect an agent to it with:

{
  "mcpServers": {
    "docs": { "url": "https://your-site.com/api/mcp" }
  }
}

WebMCPCopy Anchor Link

Where the MCP server above serves agents connecting to your site, WebMCP exposes tools to the AI agent of the browser, on the page the reader is viewing.

npx @fumadocs/cli feature webmcp

It creates a WebMCP component on top of the LLM routes. Render it inside <RootProvider />.

• search_docs queries the search API route. You can replace fetchClient with other clients.
• read_page fetches the Markdown of a page, from /llms.mdx/docs/page/content.md.

Ask AICopy Anchor Link

You can install the AI chat dialog using Fumadocs CLI.

npx @fumadocs/cli add ai/openrouter

Docs layouts render the chat from their aiChat option. The option takes client state, so create a client component for your layout and use it in place of the original layout:

'use client';
// or the Notebook, Glass and Spacious layouts
import { DocsLayout as Layout, type DocsLayoutProps } from 'fumadocs-ui/layouts/docs';
// the installed components
import { AIChat, AIChatPanel, useAIChat } from './search';

export function DocsLayout(props: DocsLayoutProps) {
  return (
    <AIChat>
      <ChatLayout {...props} />
    </AIChat>
  );
}

function ChatLayout(props: DocsLayoutProps) {
  const { open, setOpen } = useAIChat();

  return (
    <Layout
      {...props}
      aiChat={{ open, onOpenChange: setOpen, panel: <AIChatPanel />, trigger: true }}
    />
  );
}