# For agents

MCP server: https://aivy.live/mcp (Streamable HTTP, public, read-only).

```sh
claude mcp add --transport http aivy https://aivy.live/mcp
```

## Tools

### aivy_canon

Aivy in one call: the eight fixed points, the identity text to paste into image prompts (full for close and medium shots, short for full length and wider, plus the line to use with a reference image), every look's wardrobe text, her voice and manner, and the never-list. Set include_images to get the ids of the canon images (face portrait to use as image 1, sheet, distances).

Arguments: include_images.

### list_shows

The three Aivy films in the works (CONTEXT WINDOW, HELPFUL, TRELLIS): logline, treatment, the visual device, looks, style, the batch of world-test stills, the motion test, and an honest status per stop. No film is finished yet.

Arguments: none.

### search_gallery

Search and filter every image in the gallery. query matches the prompt, id, note and look (all words must match). Filters: batch (e.g. av-14-looks), look (e.g. request-line), framing (CU, MCU, MS, FS, WS, sheet, insert), film (context-window, helpful, trellis), verdict (pick, reject, note, any; default any). Picks rank first. Returns compact entries; use get_image for the full prompt.

Arguments: query, batch, look, framing, film, verdict, offset, limit.

### get_image

One image by id (batch.job.n, e.g. av-16-helpful.stage.1): the exact prompt and model it ran on, parameters, the verdict and why, its sibling variants, the batch note and URLs at three sizes. Set include_image to receive the picture itself.

Arguments: id, include_image, size.

### build_prompt

Compose an image prompt for Aivy the way this site's images were made: framing, the right identity text, the single-tattoo guard on wide shots, wardrobe (a canon look or your own), your scene, a style line and light, ending with no text, no letters, no logos. Returns the prompt, tool parameters and a checklist for the result.

Arguments: scene, framing, look, wardrobe, style, light, reference, tool.

### check_prompt

Check a prompt for Aivy against the canon before you run it: missing identity details, the wrong identity length for the framing, a missing single-tattoo guard on wide shots, green wardrobe, bare arms, the word young, brand or designer names, and requests for lettering. Returns problems with fixes.

Arguments: prompt, framing.

### get_guide

An article of the Aivy wiki as Markdown. Without a topic, lists the articles. Topics: start, consistency, stills, motion, song, storyboard, pipeline, formats. Pass section to get one heading's text.

Arguments: topic, section.

### plan_production

Plan something with Aivy at a given size (still, loop, teaser, full) and song length: shot count, stills to render, clips to generate, credit estimates at the prices measured when this site was made, the decisions a person should keep, and the steps in order.

Arguments: size, song_seconds, image_model, moving_share.

### get_licence

The licence for Aivy and the images on this site, the three fixed points, notes on releasing music, and what the site cannot grant (Anthropic marks, tool terms, the coin).

Arguments: none.

### get_skill

How to install the Aivy agent skill (canon, wiki, licence and a stdlib-only gallery script, as a zip) and the site's other machine-readable endpoints.

Arguments: none.

## Skill

```sh
curl -sL https://aivy.live/skill/aivy-skill.zip -o aivy-skill.zip
unzip -o aivy-skill.zip -d ~/.claude/skills/
```

## Data

- https://aivy.live/llms.txt, https://aivy.live/llms-full.txt
- https://aivy.live/api/index.json