# TinyTales

TinyTales turns a signed-in customer’s photos into a printable coloring book. Call tinytales_account action get first. Tools are resources with an action param. Read scopes: account:read, books:read, orders:read. Writes: books:write, books:manage, checkout:write, profile:write. books:delete is an alias for books:manage. tools/list includes a tool when the token holds any of its action scopes; other actions return 403 insufficient_scope. Upload with tinytales_images_write action upload. Checkout is a Polar link; no MCP tool charges a card. Approve with tinytales_checkout action approve, then create. State the total from tinytales_account action pricing first. Signed preview URLs expire in 15 minutes. Skill version catalog-d61af5c8. Re-fetch https://tinytaleslab.com/mcp/skill.md if your saved copy's version differs. How-to: https://tinytaleslab.com/mcp.

- [Assistant skill](https://tinytaleslab.com/mcp/skill.md): current tools and actions (also https://tinytaleslab.com/SKILL.md)
- [MCP](https://tinytaleslab.com/mcp): parent how-to plus developer reference
- Endpoint: https://tinytaleslab.com/mcp

## Tools

### Read

- [Account](https://tinytaleslab.com/mcp/tools/tinytales_account): Read this account or Polar print pricing (does not charge a card). Actions: get, pricing. Read saved book notes with tinytales_profile action get.
- [Books](https://tinytaleslab.com/mcp/tools/tinytales_books): List or load coloring books, generation progress, or a print shipping quote (does not charge a card). Actions: list, get, progress, quote.
- [Images](https://tinytaleslab.com/mcp/tools/tinytales_images): List coloring images, check generation status, or get a 15-minute preview URL (no image bytes). Actions: list, status, preview.
- [Orders](https://tinytaleslab.com/mcp/tools/tinytales_orders): List print orders or load one order, including tracking when the printer has provided it. Actions: list, get.
- [Share](https://tinytaleslab.com/mcp/tools/tinytales_share): Read a book’s invite link, list collaborators, or preview an invite without joining. Actions: get, collaborators, preview_join.

### Write

- [Edit books](https://tinytaleslab.com/mcp/tools/tinytales_books_write): Create or update a draft coloring book, or queue generation. Actions: create, update, process. Add photos with tinytales_images_write.
- [Pages](https://tinytaleslab.com/mcp/tools/tinytales_pages): Add a page, change captions, reorder, set the cover, or retry a failed page. Actions: add, update_caption, reorder, set_cover, retry.
- [Upload a photo](https://tinytaleslab.com/mcp/tools/tinytales_images_write): Add one photo to a draft book and queue a coloring page. Action: upload. JPEG, PNG, WebP, or HEIC up to 10 MB. Undecodable, blank, or noise files are rejected.
- [Share write](https://tinytaleslab.com/mcp/tools/tinytales_share_write): Create or return a collaborator invite link, or join a book from a token. Actions: create, join. Preview first with tinytales_share action preview_join.
- [Checkout](https://tinytaleslab.com/mcp/tools/tinytales_checkout): Approve a preview, make a Polar checkout or reprint link, or join the waitlist if ordering is paused. Actions: approve, create, reprint, waitlist. Does not charge a card.
- [Curation profile](https://tinytaleslab.com/mcp/tools/tinytales_profile): Read or save optional photo-curation notes and buyer defaults. Actions: get, update. Omit a field on update to leave it unchanged.

### Manage

- [Publish, delete, and share links](https://tinytaleslab.com/mcp/tools/tinytales_delete): Publish a book; delete a book, page, or image; rotate or revoke a share link; or remove a collaborator. Actions: book, page, image, publish, rotate_share, revoke_share, remove_collaborator.