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 chatbot 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 freeSelf-serveLive in 15 min

Biel.ai chatbot

Assistant

Hi! how can I help you?

Three ways to ship Biel on Astro

A floating chatbot 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 chatbot 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 chatbot 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

Every Biel project can expose the same indexed content through a hosted MCP endpoint for compatible assistants and development tools.

→Hosted MCP server, no self-hosting
→Same index as the chatbot and page search
→Works with Claude, Cursor, Cline, 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"
    }
  }
}

Things teams ask during evaluation

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 chatbot separately, or place Biel page search beside it. The Ask AI action carries a question into the chatbot 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

Build your assistant 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.