Ask AI

Ask AI is enabled by default for all Scalar Docs projects. No setup required.

How it works#

When a user asks a question, Ask AI searches through all your published documentation. It can combine information from multiple sources to give a complete answer, even when the answer spans several pages.

AsyncAPI documents#

We do not currently support AsyncAPI for Ask AI. AsyncAPI documents render as API references on your site, but they are not part of the context Ask AI answers from, so it cannot describe your channels or messages.

Need it? Tell us on GitHub or email support@scalar.com.

MCP integration#

You can connect your docs AI to LLMs like Cursor, Claude Code, Windsurf, and other tools that support Model Context Protocol (MCP). This gives the LLM the full context of your documentation, so it can answer questions about your API and product without you copy-pasting docs into the chat.

Just add /mcp to your Scalar Docs domain.

Cursor#

Add the following to your .cursor/mcp.json:

{
  "mcpServers": {
    "scalar-docs": {
      "url": "https://<your-domain>/mcp"
    }
  }
}

Claude Code#

Add the MCP server to your Claude Code configuration:

claude mcp add scalar-docs https://<your-domain>/mcp

Other MCP clients#

Any MCP-compatible client can connect to your docs AI. Point it to:

https://<your-domain>/mcp

Configuration#

You can configure Ask AI in the Scalar Dashboard. Navigate to your Docs project and open the settings to enable or disable the feature, or to adjust its behavior.

Appearance options — the button, its sidebar placement, the floating widget position, and suggested questions — can also be set via siteConfig.agent in scalar.config.json. See site config for the full list of properties.

Usage tracking#

Track how users interact with Ask AI in the Scalar Dashboard. The dashboard shows the number of conversations, common questions, and usage trends over time.