---
name: colorbooklabs
description: Create a printed coloring book from photos the customer chooses. Add photos, show a preview, request edits, and let the customer review and pay on the ColorBookLabs order page. Ships within the United States.
---

# ColorBookLabs

ColorBookLabs turns the customer's chosen photos into a printed coloring book. Each photo becomes a coloring page. The customer can review a preview, ask for changes, order, and review the complete book before printing.

## Connection

- MCP endpoint: `https://api.colorbooklabs.com/mcp`
- Transport: Streamable HTTP. Connection authentication: none; no account sign-in or API key is required.
- `start_book` returns a private `book_token` for that book. Retain it for subsequent tool calls. Never put it in a public link, expose it in customer-facing text, or share it with another service.
- Discover the current tool schemas with `tools/list`; do not guess arguments. Use the tool responses for prices, availability, limits, delivery estimates, and next steps.

## Workflow

1. Ask for the book title and the customer's email address. Confirm which photos they want to use. Call `start_book` once, then continue that same book for the entire conversation. A `recent_preview` result identifies an existing book to continue.
2. Add only photos the customer attached or explicitly chose. Use `add_photo_file` when the host provides a supported file attachment. Use `add_photo` only when you possess the real file bytes and can encode them completely; its base64 transport is intended for files up to about 6 MB decoded. Never invent, guess, truncate, or reconstruct photo bytes.
3. If the host cannot pass files, share the `upload_url` returned by `start_book`, `book_status`, or `get_upload_link`. The customer opens it and selects photos on ColorBookLabs. Wait for them to return, then call `book_status` on the same book. A link expires after 30 minutes; request a fresh one when needed. The browser upload path is available only while the unpaid book is accepting photos, before its preview or checkout starts.
4. Once at least 3 photos are accepted, call `make_preview`. While actively waiting, check `book_status` every 20–30 seconds and show the returned cover and sample pages. Check status before retrying after a timeout. If the preview is paused or fails, explain the actual result and follow the customer's choice; do not start a replacement book or imply a preview exists.
5. For a requested change, call `edit_page` with the page and the customer's instructions. Keep a stable `request_id` when retrying the same edit. Check `edit_status`, then show the result. Use `undo_edit` only when the customer asks to restore the previous version. Explain any edit-credit cost reported by the service before proceeding.
6. When the customer asks to order, call `open_checkout` and share `checkout_page_url`. On the ColorBookLabs order page, the customer chooses pages and copies, enters their US shipping address, reviews the exact total and delivery estimate, and continues to the secure payment page. Do not ask for card details in chat. `start_checkout` remains available for clients that already collect a shipping address, but prefer the order-page handoff.
7. When the customer says they have paid, call `confirm_payment`; the customer's message alone is not proof of payment. Check `book_status` for the rest of the book and show the completed pages when ready.
8. Obtain the customer's explicit approval before `approve_for_print`. Let them review and request changes first. Explain that paid books are scheduled to print automatically five days after their pages are ready if no action is taken. Once production starts, the order cannot be cancelled.
9. Use `book_status` for printing and shipping progress. Follow the customer's requested stopping point at every step.

## Limits and sensitive actions

- Printed books ship within the United States. Customers must be 18 or older to order; state this when eligibility or consent is relevant, without repeating it in preview or promotional copy.
- Start with 3–30 photos. Supported file types: JPEG, PNG, WebP, and HEIC. File attachments and the browser upload accept up to 9 MB per photo; the base64 path has the smaller practical limit described above.
- Orders offer 15 or 30 pages and 1–10 copies. Quote the actual options and totals from tool results. This connector does not supply a standalone digital download.
- Use only photos the customer has the right to use, including parent or guardian permission for children pictured. Never search for or pull photos from other accounts or services. Do not upload unlawful, infringing, explicit, abusive, or otherwise objectionable content.
- Changes, checkout, and printing need the customer's approval. Never make a payment or approve printing on the customer's behalf without their explicit instruction. Do not substitute an inferred “yes” for approval.
- Private upload and order links are for this customer. Never log or publish access tokens, temporary file links, private photos, or shipping details.
- Refused or unreadable photos must be replaced or re-exported; a failed upload does not count as an accepted photo.

## Tools

| Tool | Purpose |
| --- | --- |
| `get_offer` | Read current products, prices, shipping, and policies. |
| `start_book` | Start the named book and return its private token. |
| `add_photo_file` | Add a real photo attachment supplied by the assistant host. |
| `add_photo` | Add a complete real photo encoded as base64. |
| `get_upload_link` | Get a short-lived upload page for an eligible unpaid book. |
| `make_preview` | Start the preview from accepted photos. |
| `book_status` | Read accepted-photo counts, progress, pages, and next steps. |
| `edit_page` | Apply a requested page change. |
| `edit_status` | Check that edit's progress. |
| `undo_edit` | Restore the previous page version. |
| `open_checkout` | Get the ColorBookLabs order-page link. |
| `start_checkout` | Legacy checkout path with a supplied shipping address. |
| `confirm_payment` | Verify payment and continue the paid book. |
| `approve_for_print` | Send the approved book to printing. |
| `policies` | Read current service, support, privacy, and deletion information. |
| `contact_support` | Send a problem, content report, or deletion request to the team. |

## Support, reporting, and deletion

When the customer asks, call `contact_support` with their own words and the relevant kind:

- `problem`: something went wrong with the book or order.
- `report_content`: a photo or page is objectionable or should not be there.
- `delete_my_data`: request deletion of this book's photos and pages.

The response confirms a request was recorded, not that deletion is complete. A person reviews it and follows up by email. Requested data is deleted within 30 days, except records required by law and information still needed to fulfill a paid order. For multiple books or other personal data, direct the customer to email support. Deleting ColorBookLabs data does not delete the assistant's own conversation or copies.

Support: [colorbooklabs.com/support](https://colorbooklabs.com/support) · [hello@colorbooklabs.com](mailto:hello@colorbooklabs.com)

Guide: [colorbooklabs.com/assistants](https://colorbooklabs.com/assistants) · [Privacy](https://colorbooklabs.com/privacy) · [Terms](https://colorbooklabs.com/terms)
