# Illustrator: web app, CLI and MCP

## What it does
Decorate a document as a book: a style-driven colored cover, page borders and small ornaments in empty areas. Generates AI illustrations for sections of a PDF.

## Inputs and limits
**Command line options**

* `--count` (int, default 3): Number of illustrations to generate (default 3).
* `--language` (string, default "en"): ISO language code (default 'en').
* `--need-cover` (bool, default false): Also generate a cover image.

**MCP parameters of `add_illustrations`**

* `fileUrl` (string, required): Public URL of the document
* `style` (string): Decoration style: modern-classic, classic, romantic, gothic, childrens, minimal, fantasy. Empty = auto-detect from the text.
* `genre` (string): Story genre hint (tale, fantasy, adventure, etc.); aids auto-detection
* `needCover` (boolean): Add a colored cover page with title and author
* `borders` (boolean): Draw a decorative border in each page margin
* `ornaments` (boolean): Place small ornaments in large empty areas
* `paintings` (boolean): Generate AI paintings (simple emblems) for the cover, empty spots and plate pages

## Web app
Open the web app: [Add illustrations to a PDF](https://products.documentize.ai/ai-illustrator).

## Command line (CLI)
The `Documentize.Illustrator` plugin: Generates AI illustrations for sections of a PDF.

Replace `input-file` with your file and add the options listed above after `--task-id job1`.

```bash
# Linux / macOS (needs the .NET 10 runtime and documentize.lic next to the DLL)
export PLUGIN_INPUT_DIR=./work/input
export PLUGIN_OUTPUT_DIR=./work/output
mkdir -p "$PLUGIN_INPUT_DIR/job1"
cp input-file "$PLUGIN_INPUT_DIR/job1/"
dotnet Documentize.Illustrator.dll --task-id job1
ls "$PLUGIN_OUTPUT_DIR/job1"
```

```powershell
# Windows PowerShell
$env:PLUGIN_INPUT_DIR  = "$PWD\work\input"
$env:PLUGIN_OUTPUT_DIR = "$PWD\work\output"
New-Item -ItemType Directory -Force "$env:PLUGIN_INPUT_DIR\job1" | Out-Null
Copy-Item input-file "$env:PLUGIN_INPUT_DIR\job1\"
dotnet Documentize.Illustrator.dll --task-id job1
Get-ChildItem "$env:PLUGIN_OUTPUT_DIR\job1"
```

All command line plugins: [Documentize CLI plugins](https://products.documentize.ai/pdf-cli).

## MCP
`add_illustrations`: Decorate a document as a book: a style-driven colored cover, page borders and small ornaments in empty areas. Returns a task ID.

Client configuration (the key comes from your Documentize account):

```json
{
  "mcpServers": {
    "documentize": {
      "url": "https://api.documentize.app/mcp",
      "headers": {
        "Authorization": "Bearer dmk_YOUR_KEY_HERE"
      }
    }
  }
}
```

Tool call (`tools/call`). The tool returns a task id; poll `get_task_status` until it reports 200, then download the file from `uploadFileName`:

```json
{
  "name": "add_illustrations",
  "arguments": {
    "fileUrl": "https://example.org/document.pdf"
  }
}
```

About the MCP server: [Documentize MCP server](https://products.documentize.ai/pdf-mcp).

## Related guides

* [Advisor: web app](/docs/advisor)
* [Assembly Chat: web app and CLI](/docs/assembly-chat)
* [Code Graph: web app](/docs/code-graph)
* [Fork Sync: web app](/docs/fork-sync)
* [NuGet Updater: web app](/docs/nuget-updater)
* [Personal Engineer: web app](/docs/personal-engineer)

## Verification status
**Not verified.** This guide is built from the product documentation and the app's own page. The commands and calls above have not been run successfully, so they may need changes, and the file names in them are placeholders. Written on 2026-11-04; a verified guide replaces this page when the app passes the checks.