> ## Documentation Index
> Fetch the complete documentation index at: https://astronomer.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Use these docs with AI

> Connect an AI agent to Astronomer's documentation through an MCP server, raw Markdown pages, or llms.txt.

You can read Astronomer's documentation the way you always have, by browsing the site. If you're working with an AI agent, you have three additional ways to bring this documentation into its context: a hosted MCP server, raw Markdown pages, and `llms.txt` index files.

## MCP server

Astronomer hosts a Model Context Protocol (MCP) server at `https://www.astronomer.io/docs/mcp`. Connect an MCP-compatible client to it and the agent can search this documentation and pull specific pages into its context as it works, instead of relying on what it already knows.

<Note>
  Opening `https://www.astronomer.io/docs/mcp` in a browser returns a large JSON file. That's expected — it's an API endpoint for MCP clients, not a page meant to be viewed directly.
</Note>

The server exposes three tools:

* **`search_astronomer`** — full-text search across the documentation and API references.
* **`query_docs_filesystem_astronomer`** — read-only, shell-like queries against a virtual filesystem of every documentation page and OpenAPI spec.
* **`submit_feedback`** — report a page that's incorrect, outdated, confusing, or incomplete.

### Connect a client

<Tabs>
  <Tab title="Claude Code">
    ```bash theme={null}
    claude mcp add --transport http astronomer-docs https://www.astronomer.io/docs/mcp
    ```
  </Tab>

  <Tab title="Claude Desktop">
    Go to **Settings** > **Connectors** > **Add custom connector**, and enter `https://www.astronomer.io/docs/mcp` as the server URL.
  </Tab>

  <Tab title="Cursor">
    Open the command palette with <kbd>⌘</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> (or <kbd>Ctrl</kbd>+<kbd>Shift</kbd>+<kbd>P</kbd> on Windows/Linux), run **Open MCP settings**, then **Add custom MCP** and enter `https://www.astronomer.io/docs/mcp` as the server URL.
  </Tab>

  <Tab title="VS Code">
    Add an entry to your MCP configuration:

    ```json theme={null}
    {
      "servers": {
        "astronomer-docs": {
          "url": "https://www.astronomer.io/docs/mcp",
          "type": "http"
        }
      }
    }
    ```
  </Tab>
</Tabs>

## Markdown pages

Every documentation page is also available as raw Markdown. Append `.md` to any page's URL to fetch its plain-text source instead of the rendered HTML, for example `https://www.astronomer.io/docs/astro/overview.md`.

On the page itself, use the contextual menu in the top right to copy the page as Markdown or open it directly in ChatGPT or Claude.

## llms.txt

The root [llms.txt](/docs/llms.txt) file is an index of pointers to each product's documentation, in the format proposed by the [llms.txt standard](https://llmstxt.org/). Each product has its own nested `llms.txt`, and versioned products like Astro Private Cloud and the Astro CLI nest one level deeper, with a file per version:

```text theme={null}
/llms.txt                              Index of all products
/astro/llms.txt                        All Astro pages
/runtime/llms.txt                      All Astro Runtime pages
/cli/llms.txt                          Index of CLI versions
  /cli/v1.43/llms.txt                  Astro CLI v1.43 pages
/astro-private-cloud/llms.txt          Index of APC versions
  /astro-private-cloud/v-2-x/llms.txt  Astro Private Cloud v2.x pages
```

These files are generated to cover every supported and archived version of every product, including versions that aren't the default on the site.