Get book figures
calibre_get_figuresRead-only
List an ebook's figures with captions and page numbers, then fetch up to three selected figures as images to view them directly.
Instructions
List a book's figures — images the text references, identified by caption (Figure 1-2 / Рис. 3.1) — with page + caption per figure, then fetch chosen ones as images via indexes (≤3 per call). Captions let you pick figures before spending image tokens. In MCP Apps hosts the fetched figures also render for the user in an in-chat viewer, so you can point at them by figure number — but describe only what the pixels you received actually show.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| bookId | No | ||
| detail | No | Image resolution: standard ≤1024px longest side (default), high ≤1568px. | standard |
| format | No | Source format override (epub or pdf). Default: epub if present, else pdf. | |
| indexes | No | Figure indexes from a previous list call — returns those figures as images (≤3 per call). Omit to list. Indexes are per-format; re-list after changing format. | |
| library | No | ||
| include_uncaptioned | No | Also list/fetch images with no caption (covers, decorations, equation images). |