# For agents

> People read the pages. Agents read the same label as tools, files and Markdown — public, read-only, no keys.

## The MCP server

`https://aidols.fans/mcp` — Model Context Protocol over Streamable HTTP. Nine tools:

| Tool | What it gives you |
|---|---|
| `list_artists` | every artist: slug, name, thesis, medium, films, demo or not |
| `artist_canon` | constants, identity text (long and short), looks, voice, never-list, terms — call it first |
| `list_films` | every film with its numbers, frames and making-of documents |
| `browse_images` | images a film was made from, by scope, batch, look and framing |
| `search_images` | full-text search over every prompt on the label |
| `get_image` | one image: exact prompt, params, size, plate or not, verdict, siblings; optionally the picture |
| `get_guide` | a wiki page, or one section of it |
| `get_record` | a film's making-of document, in pages |
| `build_prompt` | a new still prompt that stays on an artist's canon |

Connect from Claude Code with `claude mcp add --transport http castpad https://aidols.fans/mcp`. Other clients: [/agents](/agents).

## Files

```bash
curl https://aidols.fans/llms.txt          # the map
curl https://aidols.fans/llms-full.txt     # everything in one file
curl https://aidols.fans/wiki/make.md      # any page: add .md
curl https://aidols.fans/s/echo-vale.md    # an artist's canon
curl -L -o castpad-skill.zip https://aidols.fans/skill/castpad-skill.zip   # the skill
```

## JSON

```bash
curl https://aidols.fans/api/index.json                         # every artist and endpoint
curl https://aidols.fans/api/films.json                         # every film
curl https://aidols.fans/api/shows/echo-vale/films/nocturne     # one film, every image and prompt
curl "https://aidols.fans/api/shows/{slug}/receipts?download"   # an artist's full record
```

## Rules for agents

- Read the canon first and paste the identity text word for word. Respect the never-list.
- Take audience numbers from receipts only, and say when an artist is a labelled demo.
- No real people, brands, other creators' characters or cloned voices.
- Label everything you make as AI-made.
- Payments: `GET /api/pay/{slug}/{item}` answers `402` with x402 requirements. Never pay without your principal's approval.
- Be polite: cache what you fetch and take the small images unless you need the large ones.