starlight-agentready

starlight-agentready

Starlight plugin that submits your docs site to AgentReady after every build, making it instantly queryable by AI agents (Claude, Cursor, Windsurf, and any MCP client) with cited, multi-page answers.

Installation

npm install starlight-agentready

Usage

Add the plugin to your astro.config.mjs:

import { defineConfig } from 'astro/config'
import starlight from '@astrojs/starlight'
import agentready from 'starlight-agentready'

export default defineConfig({
  site: 'https://docs.yoursite.com',  // used to infer domain automatically
  integrations: [
    starlight({
      title: 'My Docs',
      plugins: [agentready()],
    }),
  ],
})

If you don't have site set, specify the domain explicitly:

plugins: [agentready({ domain: 'docs.yoursite.com' })]

After each astro build:

[AgentReady] ✓ Indexed docs.yoursite.com. AI agents can now query it.
[AgentReady]   MCP:  https://www.agentready.it.com/api/mcp

How it works

After your site builds, the plugin posts your domain to AgentReady's indexing webhook. AgentReady crawls your docs and makes them queryable via:

• MCP server — https://www.agentready.it.com/api/mcp (works in Claude, Cursor, Windsurf, and any MCP client)
• REST endpoint — POST https://www.agentready.it.com/api/sites/{id}/ask
• llms.txt — https://www.agentready.it.com/api/sites/{id}/llms.txt

Connecting to your AI tools

Claude Code / Claude Desktop

claude mcp add agentready npx @agentreadyweb/mcp

VS Code (GitHub Copilot)

// .vscode/mcp.json
{
  "servers": {
    "agentready": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@agentreadyweb/mcp"]
    }
  }
}

Then ask your AI: "Ask agentready: how do I configure X in [your docs]?"

Configuration

Option	Default	Description
domain	(inferred from site)	Domain of your docs site (e.g. docs.example.com)

License

MIT © AgentReady