# llms.txt and agents

> Machine-readable docs artifacts for grounding an AI assistant.

Every Pixelhooks doc page is plain markdown, and the whole site is indexed in two
artifacts at the site root so an AI assistant can read the documentation directly
rather than scraping HTML:

- [`/llms.txt`](https://hooks.pixelhop.io/llms.txt) — a curated index of every doc
  page, with links and one-line descriptions.
- [`/llms-full.txt`](https://hooks.pixelhop.io/llms-full.txt) — the full text of
  every page concatenated into a single file.

These follow the [llms.txt convention](https://llmstxt.org) and are generated at
build time, so they always reflect the current docs.

## Any page as markdown

Every doc page is also available as raw markdown — just **append `.md` to its
URL**. For example, this page is at
[`/docs/agents/llms-and-agents.md`](/docs/agents/llms-and-agents.md), and the MCP
setup guide is at `/docs/agents/mcp-setup.md`. The links in `/llms.txt` point
straight at these `.md` files, so an agent can fetch exactly the page it needs
without parsing HTML.

Every doc page also has a **"Copy page"** menu (top-right) that copies the
markdown to your clipboard, copies an agent-fetchable link, opens the raw
markdown, or launches the page directly in ChatGPT or Claude.

## Using them

Point your assistant at `/llms.txt` to discover what exists, then have it fetch
the specific page it needs. For a one-shot grounding, feed it `/llms-full.txt` —
the entire documentation in one request.

```bash
curl https://hooks.pixelhop.io/llms.txt
```

::callout{type="info"}
If you want an agent to _act_ on Pixelhooks — create bins, inspect requests — use
the [MCP server](/docs/agents/mcp-setup) instead. `llms.txt` is for _reading_ the
docs; MCP is for _driving_ the service.
::

## What's next

- [MCP setup](/docs/agents/mcp-setup) — give an agent the tools to create bins
  and wait for requests.