Read an ebook
get_ebookRead one of the caller's existing Unplain ebooks by id, including its current styling under theme.design (colours, fonts, type sizes, spacing, cover layout, and which preset it resembles) in the same field names update_ebook accepts. cta reports the CTA page (layout, headline, body, button, showButton, link, social links, credit) in the names update_ebook accepts, and ctaLayoutDrawn the layout it draws (what 'auto' picked). ctaButtonInPdf says whether the exported PDF draws the button, and ctaButtonWarning, when present, why a shown button will not be in it (no real url). mode: 'outline' (default) returns every block's id, type and a truncated preview, which is what update_ebook's operations address; 'metadata' returns settings only, and is the cheap way to inspect a design before changing it; 'full' returns complete block text. Tables, buttons and images are readable in both: outline gives each table's rowCount, columnCount and headers, each button's text and href, and each image's sizePreset and align; full adds the whole table (headers, rows, align, in the shape set_table accepts) and the image's alt. outline and full return at most 'limit' blocks (default 150, max 500) starting at 'fromBlockId'; when blocks remain the result carries nextBlockId, to pass back as fromBlockId, and blockCount is always the total. Read every page before replacing the body with update_ebook's content. A block may carry a 'treatment' (pullQuote, callout, steps, stat or statCaption): styling chosen automatically at import that renders it more prominently, such as a stat drawn at display size in the accent colour. ALWAYS call this before update_ebook: it returns the block ids to edit and the version that makes the update safe against a simultaneous edit in the web app. If you only know the ebook by name, call list_ebooks first to get its projectId.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"projectId": "<projectId>"
},
"name": "get_ebook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | metadata: settings only, no content. outline: every block's id, type, any treatment, and truncated text (use this before editing). full: complete block text. | outline |
| limit | No | outline and full modes: most blocks to return (default 150, max 500). One more may be included so an image and its caption stay together. When blocks remain, the result carries nextBlockId. | |
| projectId | Yes | ||
| fromBlockId | No | outline and full modes: start the block list at this block (inclusive). Pass the nextBlockId a previous call returned to read the next page. Omit to start at the first block. |