ColoringBookify

Get the current plan, available credits, and API capabilities. Include account name and email only when the user asks to identify the connected account.

get_account

Get one owned book, ordered page identities, coloring-scene versus PDF numbering, source revisions, and export readiness without a widget. Use for conversational page selection and edits.

get_book

Deliver a ready book in chat without an embedded widget: returns its PDF and ALL page images by default, including covers, ownership and ending pages. Download and attach every pages[].file, not just coloring scenes; image_file_count is the number to transfer. Pass cumulative delivered_page_versions from successful earlier transfers to omit duplicates. Set include_images false only for an explicit PDF-only request. Never call show_book to complete delivery. Costs 0 credits.

get_book_files

Get a short-lived, owner-authorized download_url and MCP resource URI for the final printable PDF. Download the URL for binary bytes instead of serializing resources/read output as text. The page_size must match the book aspect. Costs 0 credits.

get_book_pdf

Read metadata for one owned reusable character. To display its reference image, call get_character_image.

get_character

Retrieve an existing character reference as a signed download_url and MCP resource link without a widget. Download and attach the actual file to your reply when the host supports files; otherwise provide the authorized link. Never claim an attachment or visible image from a URL alone. Costs 0 credits.

get_character_image

Retrieve a saved quote or its already-started operation without a widget. Use to resume a conversation or review the exact current cost. Costs 0 credits.

get_confirmation

Get an asynchronous operation and refresh its stored status from existing results, including progress, charged/refunded credits, and safe errors. Costs 0 credits and never starts generation.

get_operation

Read metadata for one owned page. To display its image, call get_page_image; metadata alone does not show a page.

get_page

Get progress and review state for an owned proposed image edit. Costs 0 credits.

get_page_edit

Retrieve the original or proposed edit image for review in chat. Download and present both before asking whether to accept or discard. Costs 0 credits.

get_page_edit_image

Retrieve an existing coloring page as a signed download_url and MCP resource link without a widget. Download and attach the actual file to your reply when the host supports files; otherwise provide the authorized link. Never claim an attachment or visible image from a URL alone. Costs 0 credits.

get_page_image

User-interface data refresh and navigation. Returns workspace data without creating another chat card. Never generates images or consumes credits.

get_workspace

Import a finished JPEG, PNG, or WebP page created outside ColoringBookify. Costs 0 credits.

import_page

List owned book metadata for lookup or filtering. To show covers and browse visually, use show_books.

list_books

Look up active or archived reusable character metadata. To show reference sheets, use show_characters once instead of fetching each image.

list_characters

List asynchronous generation operations and refresh their stored progress from existing results. Costs 0 credits and never starts generation. Poll get_operation until status is terminal.

list_operations

List standalone and book pages owned by the account.

list_pages

List every supported PDF trim size, compatible aspect, and recommended generation dimensions.

list_print_formats

Plan a book without generating images or spending credits. Return scenes, options, coloring-scene and total PDF page counts, and an exact expiring quote. Present the plan in chat and ask for confirmation. After explicit consent use execute_confirmation; do not call prepare_book_quote again. Costs 0 credits.

plan_book

Prepare an exact quote without generation or charge. Present it in chat; call execute_confirmation only after explicit user consent. Quote creation of a page for an existing book for explicit user approval. Optional source_image converts an attached photo directly into this page without creating a character. Generation costs exactly 1 credit after approval. May also assemble a missing back cover once the book has at least four coloring pages.

prepare_book_page_quote

Prepare a quote for an explicitly specified complete book without generating or charging. Use plan_book for idea-based planning. If a plan already returned a confirmation, execute that confirmation after consent instead of calling this tool. Present the quote in chat.

prepare_book_quote

Prepare an exact quote without generation or charge. Present it in chat; call execute_confirmation only after explicit user consent. Quote creation of a reusable character only when the user requests one. Do not use for photo-to-coloring-page requests; use prepare_page_quote with source_image instead. Character generation costs 1 credit after approval and does not create a coloring page.

prepare_character_quote

Prepare an exact quote without generation or charge. Present it in chat; call execute_confirmation only after explicit user consent. Quote regeneration of an existing reusable character. Generation costs exactly 1 credit after approval; this call only saves a pending quote.

prepare_character_regeneration_quote

Prepare an exact quote without generation or charge. Present it in chat; call execute_confirmation only after explicit user consent. Prepare a 1-credit edit of a selected interior coloring page using its current image and the requested change. Present the exact quote and obtain confirmation in chat before generation. Original stays unchanged until the user accepts the proposed image.

request_page_edit

Prepare an exact quote without generation or charge. Present it in chat; call execute_confirmation only after explicit user consent. Quote creation of a single coloring page for explicit user approval. For photo-to-coloring-page requests, pass the attached photo as source_image directly to this tool; do not create a reusable character first. After approval, generation costs exactly 1 credit and returns an asynchronous operation.

prepare_page_quote

Prepare an exact quote without generation or charge. Present it in chat; call execute_confirmation only after explicit user consent. Quote regeneration of an existing page. Generation costs exactly 1 credit after approval; this call only saves a pending quote.

prepare_page_regeneration_quote

Replace the ordered list of all pages in a book. Costs 0 credits.

reorder_book_pages

Replace a page image with a finished external JPEG, PNG, or WebP. Costs 0 credits.

replace_page_image

Restore an archived reusable character when the plan limit allows it. Costs 0 credits.

restore_character

Accept or discard an existing proposed edit after showing the original and proposal and obtaining the user's decision in chat. Pass review_revision from get_page_edit. Acceptance updates every listed affected book and rejects a changed source. Costs 0 additional credits; discarding a successful preview does not refund its generation cost.

review_page_edit

Revise a pending book plan and replace its approval with a new exact quote. No images are generated. Existing approval becomes invalid.

revise_book_plan

Open an embedded interactive book gallery ONLY when the user explicitly requests that gallery/viewer. Do not use after generation, for downloads, to announce completion, or merely because the user wants a book or its images. Use get_book_files to deliver all images and the PDF in chat. This tool creates an iframe; user_requested_gallery must attest to an explicit gallery request. Costs 0 credits.

show_book

Display an inline cover carousel only when the user explicitly asks to browse an interactive book library. Never use to complete generation or deliver book files; use get_book_files for that. Opens the newest books by default; optionally supply up to 12 owned book IDs after filtering list_books results. Clicking a cover opens its page viewer. Costs 0 credits.

show_books

Display existing reusable character reference sheets together in one gallery. Prefer this for requests to see characters; do not call get_character_image for each character or download them merely to display the gallery. Accepts limit up to 100 but returns at most 12 previews per page. Use next_cursor when has_more is true; query.limit reports the effective page size. Omit limit for the default gallery. Does not generate images. Missing previews are identified individually. Costs 0 credits.

show_characters

Display an optional interactive confirmation card only when the user requests visual review. The normal workflow presents the quote and obtains confirmation in chat. Costs 0 credits.

show_confirmation

Display the original and proposed page image for comparison and the user's accept or discard decision. May show processing progress. Costs 0 credits.

show_page_edit

Update book metadata or its reusable character selection. Costs 0 credits.

update_book

Update a character name or public preview setting. Costs 0 credits.

update_character

Update page metadata or reusable character selection. Costs 0 credits.

update_page