# Atelier — full documentation for agents

Atelier turns slide HTML/CSS written by an AI agent into native slides in a deck app.
The agent stays where it already is; slides appear on the canvas, editable.

---

## Destinations

- Figma Slides: available
- Google Slides: available
- PowerPoint: not available yet
- Canva: not available yet

---

## Connecting

Add the remote MCP server at https://mcp.atelierdeck.app/mcp to your agent.

### Claude Code

File: `.mcp.json`

```
{
  "mcpServers": {
    "atelier": {
      "type": "http",
      "url": "https://mcp.atelierdeck.app/mcp"
    }
  }
}
```

### Codex

File: `~/.codex/config.toml`

```
[mcp_servers.atelier]
url = "https://mcp.atelierdeck.app/mcp"
```

### Cursor / VS Code

File: `.cursor/mcp.json`

```
{
  "mcpServers": {
    "atelier": {
      "url": "https://mcp.atelierdeck.app/mcp"
    }
  }
}
```

### OpenCode

File: `opencode.json`

```
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "atelier": {
      "type": "remote",
      "url": "https://mcp.atelierdeck.app/mcp",
      "enabled": true
    }
  }
}
```

Writing to Figma Slides also needs the Figma plugin, added from Community and signed in once:
https://www.figma.com/community/plugin/1665799770586714070/atelier-create-slides-with-your-ai-agent

Writing to Google Slides needs no plugin.

---

## Tools

12 tools are available over the remote MCP endpoint.

- `whoami` — Official-aligned identity check.
- `get_metadata` — Official get_metadata pattern for Figma Slides: sparse deck outline (slide ids, names, indices, optional text previews).
- `get_slide` — Read one slide in detail (text nodes, optional nodes[] tree).
- `html_to_figma` — Convert real CSS HTML (1920×1080) to FigmaNodeSpec via headless Chromium (render-container) WITHOUT writing to Figma.
- `create_slides` — The single slide-creation tool: render real CSS HTML (flex/grid/gradient/shadow) at 1920×1080 via headless Chromium (render-container service), convert to FigmaNodeSpec, and create one or more Figm...
- `edit_slide` — In-place edit of one slide.
- `reorder_slides` — Reorder deck grid.
- `get_screenshot` — Official-aligned PNG/JPG capture for agent visual verification.
- `apply_theme` — Re-render slides with a new color palette — either a known slide-kit paletteId (atelier-blue / atelier-midnight / atelier-warm / atelier-light-mono / atelier-dark) or a full custom 12-color palette.
- `delete_slide` — Remove one slide from the deck grid.
- `slide_design` — Agentic design phase BEFORE any Figma writes.
- `list_slide_patterns` — スライドの作り方を選ぶための一覧を返す。Figma非書込・純粋読み取り。**HTMLを書く前に必ず1回呼ぶ。** 作り方は3つあり、1回の呼び出しで3つとも返るので見比べて選ぶ: (1) `routes` — 3つの作り方（pattern=構図まるごと / compose=部品を組み合わせる / freehand=自由に書く）と、それぞれいつ選ぶか。まずここを読む。

---

## Authoring rules

The rules for writing slide HTML are served as MCP prompts, not duplicated here:

- `create_slides_guide` — how to write a slide, what CSS is supported, and the required pipeline.
- `review_slides_guide` — the 47-check rubric used to grade a deck before it is called done.

Read those prompts through your MCP client. They are the authority; anything restated on this
site would drift out of date.

The parts that never change:

- One slide is one self-contained HTML document, rendered at 1920x1080.
- Real CSS layout runs in a headless browser, so flex, grid, gradients, and shadows work.
- Text, simple shapes, and images become native objects — they are not flattened into a picture.
- Grade the deck with the review tool and fix what it flags before reporting completion.

---

## Pages

- https://atelierdeck.app/ — What Atelier is, where decks can land, and how to connect an agent.
- https://atelierdeck.app/gallery — Slides Atelier actually generated, with a note on each one.
- https://atelierdeck.app/pricing — What each tier includes. Paid pricing is not settled yet.
- https://atelierdeck.app/releases — Shipped changes, generated from the repository CHANGELOG.
- https://atelierdeck.app/privacy — Privacy policy.
- https://atelierdeck.app/terms — Terms of service.
- https://atelierdeck.app/security — How data is handled and what the plugin can reach.