For Astro sites

Ask AI for your Astro site

Q: How long does installation take?

Install astro-biel and add one integration block to astro.config.mjs. Indexing time depends on the size of the site.

Install astro-biel for a source-linked assistant on any Astro site. Add Biel page search to your layout and keep both surfaces connected to the same documentation index.

Add Biel to Astro See the install code

14-day free trialNo credit card required

Biel.ai assistant

Assistant

Hi! How can I help you?

What is Biel?

Assistant

How to try Biel?

Assistant

Start your 14-day trial Request a demo

Assistant is typing…Assistant is typing…

Used by documentation and developer-experience teams

Install

Three ways to ship Biel on Astro

A floating assistant through the native Astro integration, page search placed in your layout, or a hosted MCP endpoint for AI tools.

Full installation guide

Install the native astro-biel integration

Add astro-biel to astro.config.mjs. It loads a floating Ask AI assistant on every page and follows Astro ClientRouter navigation.

→Works with any Astro template or UI framework
→No layout or script-tag edits required for chat
→Supports ClientRouter and view transitions
→Uses the same widget configuration as other Biel integrations

astro.config.mjs

// 1. npm install astro-biel

import { defineConfig } from 'astro/config'
import biel from 'astro-biel'

export default defineConfig({
  integrations: [
    biel({
      project: '<YOUR_PROJECT_ID>',
      headerTitle: 'Documentation AI',
      buttonPosition: 'bottom-right',
    }),
  ],
})

Place page search in your Astro layout

The integration loads the required assets. Add <biel-search-button> wherever your layout renders site search. It returns matching pages and hands questions to Ask AI.

→Place the trigger in any Astro component or layout
→Page results with an Ask AI handoff
→Can run beside an existing site-search interface
→Shares the assistant project and indexed content

src/layouts/Layout.astro

<header>
  <biel-search-button
    project="<YOUR_PROJECT_ID>"
    header-title="Documentation AI"
    button-style="rounded">
      Search
  </biel-search-button>
</header>

Make your Astro content available to AI tools

Hosted MCP is available from $150/month and lets compatible AI tools query the same indexed documentation.

→Hosted MCP server, no self-hosting
→Same index as the assistant and page search
→Works with Codex, Claude Code, Cursor, and other MCP clients
→Project-scoped endpoint and authentication

mcp.json

{
  "mcpServers": {
    "biel-ai": {
      "name": "Biel.ai",
      "type": "http",
      "url": "https://mcp.biel.ai/v2/YOUR_PROJECT_SLUG/mcp"
    }
  }
}

Before you install

Should a Starlight site use astro-biel?

Use the dedicated starlight-biel plugin for Starlight. It integrates through Starlight’s plugin API. Use astro-biel for other Astro sites.

Does it work with Astro ClientRouter and view transitions?

Yes. The integration keeps the widget available across client-side navigation, including sites using Astro ClientRouter.

Can we keep our existing site search?

Yes. Keep your current search and add the Biel assistant separately, or place Biel page search beside it. The Ask AI action carries a question into the assistant when page results are not enough.

Does it depend on a particular Astro UI framework?

No. The integration loads the widget at the Astro level and works with any template or component framework used inside the site.

Does it work on static and server-rendered Astro sites?

Yes. The widget runs in the browser after the page loads. Biel indexes the public URLs you connect, regardless of whether Astro generated them statically or rendered them on demand.

How long does installation take?

Install astro-biel and add one integration block to astro.config.mjs. Indexing time depends on the size of the site.

Make your Astro site answer questions

Try Biel with your docs Book a demo

14-day free trial · No credit card required

Use a different platform? See our integration pages for Starlight, Docusaurus, MkDocs, Next.js, and Gatsby.