# For the Cult — LLMs.txt (machine index)

> This file follows the common **llms.txt** convention (plural `llms`), not `llm.txt`. Same-origin paths below are relative to the site that served this file (e.g. https://forthecult.store).

## Start here (recommended order)

1. **Human + agent hub (HTML):** `/for-agents` — MCP, REST entry points, optional JSON summary in-page.
2. **Plain overview:** `/llm/overview.txt` — what the store is, concepts, and pointers.
3. **API cheat sheet:** `/llm/api.txt` — endpoints and flows in prose.
4. **Sitemap:** `/sitemap.xml` — all crawlable URLs including `/for-agents` and `/mcp`.
5. **HTML sitemap:** `/site-map` — curated links for humans and tools that parse anchors.

## Agent-facing host (subdomain)

When deployed, the agent experience may use a dedicated origin (e.g. **https://ai.forthecult.store**): root redirects to `/for-agents`. Use the same `/llms.txt` and `/llm/*` paths on that host when mirrored, or follow redirects to the canonical storefront.

## REST API (JSON)

- `GET /api/agent/capabilities` — features, payment options, endpoint list, `forAgentsPage` URL (call from tooling; not a substitute for reading `/llms.txt` first).
- `GET /api/agent/summary` — compact JSON summary for agents.
- `GET /api/openapi.json` — OpenAPI 3.0.
- `GET /api/docs` — Swagger UI.

## MCP (Model Context Protocol)

- **Storefront guide (canonical):** `/mcp` — remote HTTPS MCP, local `npx`, links to GitHub and API repo guides.
- **Hosted MCP (remote):** `https://mcp.forthecult.store` — streamable HTTP; POST path `/mcp` on that host; `GET .../healthz` for liveness.
- **Local stdio package:** `npx -y @forthecult/mcp`
- **Public npm package + examples:** https://github.com/forthecult/mcp
- **API repo MCP guide (skills / integration copy):** https://github.com/forthecult/api/blob/main/guides/mcp.md — skills and prompts live under the **forthecult/api** repo (`skills/`).

## Companion product (end users, not agent automation)

- **`/ai`** — marketing for the in-store **Companion** assistant (private-by-default chat; separate from MCP and `/for-agents`).
- **`/chat`** — signed-in or guest chat UI.

## Robots note

`robots.txt` may disallow `/api/` for generic crawlers; **HTTP clients used by agents** are not limited by robots rules. Discovery for agents should rely on **this file**, **`/sitemap.xml`**, **`/for-agents`**, and visible navigation—not on `/api/` being crawlable.