Endpoints: 76,849MCP servers: 32,729Payout addresses: 3,825Paid calls: 6,153Letters: 84Defects: 3,893counted 2 min ago
teppi

Server definition

Hash
sha256:94534d4f3d50ac8ca64dad6d12c1b01e4fc9ff3a797c9f14962439ec8b514f5a
What it is
What a remote MCP server returned when asked what it offers: 20 tools

The blob, as servednamed by its sha256

{ "instructions": null, "tools": [ { "description": "Create an activity book exactly as the website's Activity Book Builder does: any mix of mazes, word search, sudoku, tracing, spot the difference, shadow matching, connect the dots, ABC pages (one letter a page, always black and white), color by number (a picture in line art with a number in every area and a colour key, always black and white), hidden pictures (a themed scene with small things hidden in it and a strip of what to find), letter tracing (a letter, number or word a page as dotted letters on handwriting lines, always black and white), cut and paste (a scene with dashed-outline holes and the pictures to cut out and glue in) and coloring pages, every page decorated around the book's theme. Before ordering, ask the customer: who it is for (ageGroup), what it is about (description), which activities, how many pages, colour or black and white for each activity (inkByType), which page quality (highQuality) and, when there are mazes, which maze styles (mazeStyles). Optionally the pages for each activity (pagesByType) and their own characters on one picture (characterReferenceSheet). If the customer wants another book in a series, or the same characters as an earlier book, find it with list_my_books and pass its jobId as seriesSourceJobId rather than describing the characters again.", "inputSchema": { "additionalProperties": false, "properties": { "activities": { "description": "The activities in the book, in the order they should appear. Ask the customer. coloring_book adds drawn coloring pages.", "items": { "enum": [ "maze_book", "sudoku_book", "word_search_book", "tracing_worksheet_book", "spot_the_difference_book", "shadow_matching_book", "connect_the_dots_book", "abc_book", "color_by_number_book", "hidden_pictures_book", "letter_tracing_book", "cut_and_paste_book", "coloring_book" ], "type": "string" }, "maxItems": 13, "minItems": 1, "type": "array", "uniqueItems": true }, "activityType": { "deprecated": true, "description": "Not needed: every activity book is a builder book. Accepted as workbook only.", "enum": [ "workbook" ], "type": "string" }, "ageGroup": { "description": "Target age band, read by its youngest reader. Required, because it is not guessable and it changes the drawing: the four bands the page rules are written for are 3-6, 6-9, 9-13 and 13+, and line weight, how much background a page carries and how small the colourable areas get all step with them. Ask who the book is for rather than assuming the youngest band.", "examples": [ "3-6", "6-9", "9-13", "13-18", "adult" ], "type": "string" }, "bleed": { "description": "Print bleed. Defaults to true, as on the website: activity pages keep their artwork inside the print margins, so the bleed edge is plain paper.", "type": "boolean" }, "characterReferenceByType": { "additionalProperties": { "type": "boolean" }, "description": "Only with characterReferenceSheet, optional: false for an activity whose pages should not show the characters. Activities left out show them.", "propertyNames": { "enum": [ "maze_book", "sudoku_book", "word_search_book", "tracing_worksheet_book", "spot_the_difference_book", "shadow_matching_book", "connect_the_dots_book", "abc_book", "color_by_number_book", "hidden_pictures_book", "letter_tracing_book", "cut_and_paste_book", "coloring_book" ] }, "type": "object" }, "characterReferenceSheet": { "additionalProperties": false, "description": "Optional: the customer's characters on one picture, drawn into the activities' pages. Pass exactly one of s3Key (returned by upload_image, or a picture uploaded on the website) or data (the PNG or JPEG itself, base64, at most 4 MB).", "properties": { "data": { "description": "Base64 PNG or JPEG bytes, optionally as a data: URI.", "maxLength": 5592534, "type": "string" }, "fileName": { "description": "Original file name.", "type": "string" }, "mimeType": { "description": "image/png or image/jpeg.", "type": "string" }, "s3Key": { "description": "Key returned by upload_image.", "type": "string" } }, "type": "object" }, "createSeries": { "description": "True to make this book part of a series. A series book's files are kept for good instead of being deleted after the usual retention period, so a later book can link to it at any time. Ask the customer if they want this when they mention more books to come. A book with seriesSourceJobId is always in a series, with or without this.", "type": "boolean" }, "description": { "description": "What the book is about, in the customer's words — the theme every page is decorated around, and any words, topics or instructions they want. Ask; do not invent one.", "maxLength": 12000, "minLength": 1, "type": "string" }, "highQuality": { "description": "Page quality — ask the customer, as the website does on every order. false = Standard, 1 credit a page: clean bold line art. true = Premium, 2 credits a coloring page or a black-and-white hidden-pictures or spot-the-difference page, every other page staying at 1 credit a page: finer detail and crisper lines.", "type": "boolean" }, "inkByType": { "additionalProperties": { "enum": [ "color", "black_and_white" ], "type": "string" }, "description": "Colour or black and white for each chosen activity except coloring_book, abc_book, letter_tracing_book and color_by_number_book (always black and white). Ask the customer — the website asks this for every activity, e.g. {\"maze_book\": \"color\", \"word_search_book\": \"black_and_white\"}.", "propertyNames": { "enum": [ "maze_book", "sudoku_book", "word_search_book", "tracing_worksheet_book", "spot_the_difference_book", "shadow_matching_book", "connect_the_dots_book", "abc_book", "color_by_number_book", "hidden_pictures_book", "letter_tracing_book", "cut_and_paste_book", "coloring_book" ] }, "type": "object" }, "mazeStyles": { "description": "Required when activities includes maze_book, and only then: which maze styles to draw. Ask the customer. walls = classic line maze, tube = rounded corridors, square_tube = square corridors, round = circular maze (not drawn for ages 3-6).", "items": { "enum": [ "walls", "tube", "square_tube", "round" ], "type": "string" }, "maxItems": 4, "minItems": 1, "type": "array", "uniqueItems": true }, "numberOfPages": { "description": "Number of interior pages to generate.", "maximum": 120, "minimum": 2, "type": "integer" }, "pageSize": { "description": "Trim size such as 8.5x11. The supported sizes are returned by list_book_types. A4 is not one of them and is rejected: for A4 or any metric paper, pass 8.5x11 with bleed false, which prints on A4 either way.", "type": "string" }, "pagesByType": { "additionalProperties": { "maximum": 120, "minimum": 0, "type": "integer" }, "description": "Optional: pages for each chosen activity, e.g. {\"maze_book\": 8, \"coloring_book\": 4}. Must add up to numberOfPages. Omit it to share the pages out across the activities.", "propertyNames": { "enum": [ "maze_book", "sudoku_book", "word_search_book", "tracing_worksheet_book", "spot_the_difference_book", "shadow_matching_book", "connect_the_dots_book", "abc_book", "color_by_number_book", "hidden_pictures_book", "letter_tracing_book", "cut_and_paste_book", "coloring_book" ] }, "type": "object" }, "seriesSourceJobId": { "description": "The jobId of the customer's earlier book that this one continues. The new book starts with that book's characters, their pictures, its look and what happened in it, so pass it instead of re-uploading them. The customer's words for this book outrank all of it: they can change anything, add new characters in characterDetails, or say to leave someone out. A new character with the same name replaces the earlier one. list_my_books gives jobIds and says which books canContinueSeries; when it is not clear which book they mean, ask.", "type": "string" }, "standardQualityConfirmed": { "description": "Only with highQuality false: true once you have told the customer the Premium suggestion for books meant for sale and they chose to keep Standard (\"Print home quality\"). A Standard order without it is answered with that suggestion and not created.", "type": "boolean" } }, "required": [ "activities", "numberOfPages", "ageGroup", "description", "inkByType", "highQuality" ], "type": "object" }, "name": "create_activity_book", "outputSchema": null }, { "description": "Create a printable picture-bingo game pack for a class or a party, on any theme (for example Halloween). The pack is: a how-to-play page; the player cards, one a page, each a 5x5 grid under a B I N G O header with a FREE centre square and every card a different arrangement; calling cards to cut out; a page of themed chips to cover squares with; and a caller's checklist. The AI picks about thirty pictures that suit the theme and the players' age and draws each one once. A pack is the player cards plus 5 pages, at 1 credit a page — 10 cards is 15 credits, 20 cards is 25 credits, 30 cards is 35 credits, 50 cards is 55 credits. Before ordering, ask the customer the theme, who is playing (ageGroup), how many player cards, and colour or black and white. The order runs straight through to a PDF.", "inputSchema": { "additionalProperties": false, "properties": { "ageGroup": { "description": "Target age band, read by its youngest reader. Required, because it is not guessable and it changes the drawing: the four bands the page rules are written for are 3-6, 6-9, 9-13 and 13+, and line weight, how much background a page carries and how small the colourable areas get all step with them. Ask who the book is for rather than assuming the youngest band.", "examples": [ "3-6", "6-9", "9-13", "13-18", "adult" ], "type": "string" }, "bingoCardCount": { "description": "How many player cards to print, one a page. Every card is different.", "enum": [ 10, 20, 30, 50 ], "type": "integer" }, "bingoLabels": { "description": "picture = the pictures alone; picture_word = each picture with its word printed under it. Defaults to picture for ages 3-6 and picture_word for older players. Calling cards and the checklist always print the word.", "enum": [ "picture", "picture_word" ], "type": "string" }, "bleed": { "description": "Add print bleed to the pages. Defaults to true: every mark stays inside the margins either way, so the bleed edge is white paper.", "type": "boolean" }, "colorMode": { "description": "color = full-colour pictures; black_and_white = clean black outlines the players can colour in. Ask the customer.", "enum": [ "color", "black_and_white" ], "type": "string" }, "description": { "description": "Optional instructions in the customer's words — pictures they want included, anything to keep in mind. They come first over the AI's own choices.", "type": "string" }, "pageSize": { "description": "Trim size such as 8.5x11. The supported sizes are returned by list_book_types. A4 is not one of them and is rejected: for A4 or any metric paper, pass 8.5x11 with bleed false, which prints on A4 either way.", "type": "string" }, "theme": { "description": "The pack's theme in the customer's words, for example Halloween, farm animals or space.", "maxLength": 120, "minLength": 1, "type": "string" } }, "required": [ "theme", "ageGroup", "bingoCardCount", "colorMode" ], "type": "object" }, "name": "create_bingo_book", "outputSchema": null }, { "description": "Create a printable coloring book from a theme or description. Pages are generated as clean line art and the order continues automatically through image generation and PDF creation. To put the customer's own characters in the book, pass them in characterDetails, as the website's \"Who is in your book?\" step does. Before ordering, call list_my_characters; if they have saved characters, ask which of them to use, if any, and send those as { savedCharacterId }. Anyone else takes a name and one picture. Writing a saved character's name as @Name in the description or storyPrompt picks them too. If the customer wants to keep a new character for later books, save them with save_my_character first. If the customer wants another book in a series, or the same characters as an earlier book, find it with list_my_books and pass its jobId as seriesSourceJobId rather than describing the characters again.", "inputSchema": { "additionalProperties": false, "anyOf": [ { "required": [ "description" ] }, { "required": [ "theme" ] }, { "required": [ "style" ] } ], "properties": { "additionalInstructions": { "description": "Extra direction for the generator, up to 600 characters.", "maxLength": 600, "type": "string" }, "ageGroup": { "description": "Target age band, read by its youngest reader. Required, because it is not guessable and it changes the drawing: the four bands the page rules are written for are 3-6, 6-9, 9-13 and 13+, and line weight, how much background a page carries and how small the colourable areas get all step with them. Ask who the book is for rather than assuming the youngest band.", "examples": [ "3-6", "6-9", "9-13", "13-18", "adult" ], "type": "string" }, "bleed": { "description": "Add print bleed to the interior pages. Defaults to false: leave it off for home printing and for A4 paper — bleed makes the page 8.625x11.25in with artwork running to the paper edge, and an A4 printer cuts 0.179in off each side of that. (Activity books describe their own default.)", "type": "boolean" }, "characterDetails": { "description": "Optional. The customer's own characters, up to eight, exactly as the website's \"Who is in your book?\" step takes them. Each entry is either a saved character, { savedCharacterId } with the characterId from list_my_characters and nothing else, which brings its saved name, description and picture; or a new character with a name, a short description and one picture. The two can be mixed. Every page that shows a character draws it from its picture, so each new picture must be of that character alone and the name must match it. Cannot be combined with characterReferenceSheet.", "items": { "anyOf": [ { "additionalProperties": false, "properties": { "savedCharacterId": { "description": "A characterId from list_my_characters.", "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "savedCharacterId" ], "type": "object" }, { "additionalProperties": false, "properties": { "description": { "description": "What the character is and looks like, e.g. \"a tabby cat with a red collar\".", "maxLength": 400, "type": "string" }, "name": { "description": "The character's name as it appears in the story or description.", "maxLength": 80, "minLength": 1, "type": "string" }, "referenceImage": { "additionalProperties": false, "description": "This character's picture. Pass exactly one of s3Key (returned by upload_image, or a picture uploaded on the website) or data (the PNG or JPEG itself, base64, at most 4 MB).", "properties": { "data": { "description": "Base64 PNG or JPEG bytes, optionally as a data: URI.", "maxLength": 5592534, "type": "string" }, "fileName": { "description": "Original file name.", "type": "string" }, "mimeType": { "description": "image/png or image/jpeg.", "type": "string" }, "s3Key": { "description": "Key returned by upload_image.", "type": "string" } }, "type": "object" } }, "required": [ "name", "referenceImage" ], "type": "object" } ], "type": "object" }, "maxItems": 8, "minItems": 1, "type": "array" }, "complexity": { "description": "How intricate the pages should be.", "enum": [ "easy", "medium", "hard" ], "type": "string" }, "createSeries": { "description": "True to make this book part of a series. A series book's files are kept for good instead of being deleted after the usual retention period, so a later book can link to it at any time. Ask the customer if they want this when they mention more books to come. A book with seriesSourceJobId is always in a series, with or without this.", "type": "boolean" }, "description": { "description": "What the book should be about.", "type": "string" }, "highQuality": { "description": "Page quality — ask the customer, as the website does on every order. false = Standard, 1 credit a page: clean bold line art. true = Premium, 2.5 credits a page: finer detail and crisper lines.", "type": "boolean" }, "numberOfPages": { "description": "Number of interior pages to generate.", "maximum": 120, "minimum": 2, "type": "integer" }, "pageCategory": { "description": "coloring_book only: page structure. Defaults to auto, which classifies the description. instructional = one habit/rule per page with a short printed caption; concept = one alphabet/number/shape per page with its name printed; narrative = one continuous picture story; thematic = varied scenes on a theme, no captions.", "enum": [ "auto", "thematic", "narrative", "instructional", "concept" ], "type": "string" }, "pageSize": { "description": "Trim size such as 8.5x11. The supported sizes are returned by list_book_types. A4 is not one of them and is rejected: for A4 or any metric paper, pass 8.5x11 with bleed false, which prints on A4 either way.", "type": "string" }, "printOption": { "description": "Only send this when the person ordering has actually asked for it. Leave it out and the book type decides: coloring, story coloring and drawing books print one side per sheet with a blank back, because colour goes through the paper and would ruin the drawing behind it; every other type prints both sides. Sending \"both\" for a coloring book overrides that and gives them pages backed by pages.", "enum": [ "both", "single" ], "type": "string" }, "seriesSourceJobId": { "description": "The jobId of the customer's earlier book that this one continues. The new book starts with that book's characters, their pictures, its look and what happened in it, so pass it instead of re-uploading them. The customer's words for this book outrank all of it: they can change anything, add new characters in characterDetails, or say to leave someone out. A new character with the same name replaces the earlier one. list_my_books gives jobIds and says which books canContinueSeries; when it is not clear which book they mean, ask.", "type": "string" }, "standardQualityConfirmed": { "description": "Only with highQuality false: true once you have told the customer the Premium suggestion for books meant for sale and they chose to keep Standard (\"Print home quality\"). A Standard order without it is answered with that suggestion and not created.", "type": "boolean" }, "style": { "description": "Coloring direction. Use a value from the coloringStyles returned by list_book_types, such as cute_animals, anime_characters, fairy_tale, mandala_abstract, or general_coloring.", "enum": [ "cute_animals", "cute_birds", "cute_insects", "mandala_animal", "mandala_sea", "mandala_birds", "mandala_abstract", "jungle_adventure", "story", "anxiety_motivation", "food_fun", "universe_space", "anime_characters", "inspirational", "mythology", "christmas", "fairy_tale", "general_coloring" ], "type": "string" }, "theme": { "description": "Short subject line, for example dinosaurs or outer space.", "type": "string" }, "title": { "description": "Book title. Generated from the content when omitted.", "type": "string" } }, "required": [ "numberOfPages", "ageGroup", "highQuality" ], "type": "object" }, "name": "create_coloring_book", "outputSchema": null }, { "description": "Create a print-ready KDP paperback cover photo. Generate a coordinated front and back cover from a description, or supply either side as an image. Every side is kept inside KDP's trim and safe lines. When get_job_status shows IMAGES_READY, call generate_pdf with the same jobId to build the cover's print PDF. To fix the edges of a cover the customer already has, use fit_cover_to_kdp — never order a new cover for that, because a new cover is drawn again and its art changes. To print text on the spine, say so in the description and give the title and the author's name for it. Every spine is laid out by the same rule, so the books of a series line up on a shelf: the title reads top to bottom starting 0.25in below the top, the author's name ends 0.25in above the bottom, and both are lettered at the same size inside KDP's spine margins. The description may set the spine's colours (its background and its lettering). A picture or icon goes on the spine only when the description asks for one, and then it sits upright above the title; never add one the customer did not ask for. Spine text needs a spine at least 0.25in wide (56 sheets on white paper, 50 on cream, 54 on colour); a thinner book that asks for spine text is refused with that reason. If the cover is for a book the customer made here, link it with sourceJobId so the cover is drawn with that book's own characters and the character pictures they uploaded; without it the characters are invented from the description and will not match the book. A linked book also sizes the spine: leave sheetCount out and it is read from that book's PDF. Send sheetCount only for an interior made elsewhere. Find the book with list_my_books. If the customer has not said whether the cover is for one of their books, or more than one book could be the one, ask them which book before ordering — show them the titles from list_my_books.", "inputSchema": { "additionalProperties": false, "properties": { "backCoverImage": { "additionalProperties": false, "description": "Optional supplied cover art for this side; omit it to generate that side. A supplied side must have the shape of this book's cover side — the trim plus KDP's 0.125in bleed on its three outer edges — and at least 300 dpi: 8.5x11 book: 8.625x11.25in, 2588x3375 pixels; 8.5x8.5 book: 8.625x8.75in, 2588x2625 pixels; 6x9 book: 6.125x9.25in, 1838x2775 pixels. Larger at the same shape is fine. A side of another shape is refused (no credits are charged) with the size to make it, because it would otherwise be centred on the cover with a blurred strip of the picture filling the gap; a side of the right shape but fewer pixels is accepted and prints soft, and the result says so. Each image must be under 4 MB (a request limit), which for a print-size photo or painting means JPEG; PNG is fine when it fits. Pass exactly one of s3Key (returned by upload_image, or a picture uploaded on the website) or data (the PNG or JPEG itself, base64, at most 4 MB).", "properties": { "data": { "description": "Base64 PNG or JPEG bytes, optionally as a data: URI.", "maxLength": 5592534, "type": "string" }, "fileName": { "description": "Original file name.", "type": "string" }, "mimeType": { "description": "image/png or image/jpeg.", "type": "string" }, "s3Key": { "description": "Key returned by upload_image.", "type": "string" } }, "type": "object" }, "bleed": { "deprecated": true, "description": "DEPRECATED and ignored: a KDP paperback cover always has 0.125in bleed on every side, even for a no-bleed interior, and every cover is built with it.", "type": "boolean" }, "bookType": { "description": "Interior book type, which directs the cover art. It no longer affects the spine — sheetCount says how thick the book is on its own.", "enum": [ "coloring_book", "story_book", "novel", "puzzle", "word_search" ], "type": "string" }, "description": { "description": "The book theme and visual direction used to generate the cover art and title.", "minLength": 1, "type": "string" }, "frontCoverImage": { "additionalProperties": false, "description": "Optional supplied cover art for this side; omit it to generate that side. A supplied side must have the shape of this book's cover side — the trim plus KDP's 0.125in bleed on its three outer edges — and at least 300 dpi: 8.5x11 book: 8.625x11.25in, 2588x3375 pixels; 8.5x8.5 book: 8.625x8.75in, 2588x2625 pixels; 6x9 book: 6.125x9.25in, 1838x2775 pixels. Larger at the same shape is fine. A side of another shape is refused (no credits are charged) with the size to make it, because it would otherwise be centred on the cover with a blurred strip of the picture filling the gap; a side of the right shape but fewer pixels is accepted and prints soft, and the result says so. Each image must be under 4 MB (a request limit), which for a print-size photo or painting means JPEG; PNG is fine when it fits. Pass exactly one of s3Key (returned by upload_image, or a picture uploaded on the website) or data (the PNG or JPEG itself, base64, at most 4 MB).", "properties": { "data": { "description": "Base64 PNG or JPEG bytes, optionally as a data: URI.", "maxLength": 5592534, "type": "string" }, "fileName": { "description": "Original file name.", "type": "string" }, "mimeType": { "description": "image/png or image/jpeg.", "type": "string" }, "s3Key": { "description": "Key returned by upload_image.", "type": "string" } }, "type": "object" }, "interiorPaperType": { "description": "The interior's KDP paper, which sets how thick the spine is. white: black & white on white paper, or KDP standard colour (same white paper). cream: black & white on cream. color: KDP premium colour paper only — for standard colour send white.", "enum": [ "white", "cream", "color" ], "type": "string" }, "numberOfPages": { "deprecated": true, "description": "DEPRECATED — send sheetCount instead. Ordered interior pages, converted to sheets using printOption. Ignored when sheetCount is given.", "maximum": 828, "minimum": 1, "type": "integer" }, "pageSize": { "description": "Interior trim size such as 8.5x11.", "type": "string" }, "printOption": { "deprecated": true, "description": "DEPRECATED — send sheetCount instead. This was never a property of a cover: it only said how to turn numberOfPages into sheets. Ignored when sheetCount is given.", "enum": [ "both", "single" ], "type": "string" }, "sheetCount": { "description": "Leave out when sourceJobId links one of the customer's books: the sheets are read from that book's PDF. Otherwise required: how many SHEETS of paper are in the interior. A sheet is one physical piece of paper, and the spine is as thick as the stack of them — this is the only quantity the spine width is computed from. Count it from the interior itself: a book printed on both sides puts two pages on each sheet, so 24 pages is 12 sheets; a coloring or drawing book printed one side per sheet puts one page on each, so 24 pages is 24 sheets. Equivalently, it is the finished interior PDF's page count divided by two.", "maximum": 414, "minimum": 1, "type": "integer" }, "sourceJobId": { "description": "The jobId of the customer's own book this cover is for. Pass it whenever the cover belongs to a book made here: the cover is then drawn with that book's own characters — including any character pictures the customer uploaded — and its style and story, instead of characters invented from the description. The book must belong to the customer, must not be another cover, and must have its pages drawn. The description still says what the cover shows and overrides the book where they differ. list_my_books lists the customer's books with their jobIds and says which can be linked; when it is not clear which book the cover is for, ask the customer.", "type": "string" }, "title": { "description": "Book title. Generated from the description when omitted.", "type": "string" } }, "required": [ "description" ], "type": "object" }, "name": "create_cover_photo", "outputSchema": null }, { "description": "Create an educational coloring book that teaches one concept step by step, such as how bees make honey or how a glacier forms. Every page covers one idea: a black-and-white line drawing to color, with some text explaining it. The AI decides what each page shows, how it is laid out and what it says; anything the customer asks for on the pages goes in the description. Before ordering, ask the customer who it is for (ageGroup), what it should teach (description) and which page quality (highQuality). The order runs straight through to a PDF.", "inputSchema": { "additionalProperties": false, "properties": { "ageGroup": { "description": "Target age band, read by its youngest reader. Required, because it is not guessable and it changes the drawing: the four bands the page rules are written for are 3-6, 6-9, 9-13 and 13+, and line weight, how much background a page carries and how small the colourable areas get all step with them. Ask who the book is for rather than assuming the youngest band.", "examples": [ "3-6", "6-9", "9-13", "13-18", "adult" ], "type": "string" }, "bleed": { "description": "Add print bleed to the interior pages. Defaults to false: leave it off for home printing and for A4 paper — bleed makes the page 8.625x11.25in with artwork running to the paper edge, and an A4 printer cuts 0.179in off each side of that. (Activity books describe their own default.)", "type": "boolean" }, "description": { "description": "What the book teaches, in the customer's words — a process, an idea or a topic, and anything they want on the pages. Any stages, facts or wording they gave are used as given.", "type": "string" }, "highQuality": { "description": "Page quality — ask the customer, as the website does on every order. false = Standard, 1 credit a page: clean bold line art. true = Premium, 2.5 credits a page: finer detail and crisper lines.", "type": "boolean" }, "numberOfPages": { "description": "Number of interior pages to generate.", "maximum": 120, "minimum": 2, "type": "integer" }, "pageSize": { "description": "Trim size such as 8.5x11. The supported sizes are returned by list_book_types. A4 is not one of them and is rejected: for A4 or any metric paper, pass 8.5x11 with bleed false, which prints on A4 either way.", "type": "string" }, "pageTemplateImage": { "additionalProperties": false, "description": "Optional. An example page showing how the customer wants the pages to look. It is inspiration, not a page to copy: the book takes its design — the background, where the picture and the text sit, how the text boxes look, the lettering — and draws every page's own picture and text in it. Pass exactly one of s3Key (returned by upload_image, or a picture uploaded on the website) or data (the PNG or JPEG itself, base64, at most 4 MB).", "properties": { "data": { "description": "Base64 PNG or JPEG bytes, optionally as a data: URI.", "maxLength": 5592534, "type": "string" }, "fileName": { "description": "Original file name.", "type": "string" }, "mimeType": { "description": "image/png or image/jpeg.", "type": "string" }, "s3Key": { "description": "Key returned by upload_image.", "type": "string" } }, "type": "object" }, "standardQualityConfirmed": { "description": "Only with highQuality false: true once you have told the customer the Premium suggestion for books meant for sale and they chose to keep Standard (\"Print home quality\"). A Standard order without it is answered with that suggestion and not created.", "type": "boolean" } }, "required": [ "numberOfPages", "ageGroup", "description", "highQuality" ], "type": "object" }, "name": "create_educational_coloring_book", "outputSchema": null }, { "description": "Create printable picture flashcards for young learners on any topic (for example farm animals, fruit, vehicles or feelings). Square cards on US Letter sheets with dashed lines to cut along, printed at home. Two templates: picture_word prints the picture with its word under it, 6 cards a sheet; fold_and_glue prints the picture on one half and the word with one short fact on the other, 3 cards a sheet, to cut out, fold and glue into a two-sided card without a duplex printer. The AI picks one thing a card for the topic and the child's age and draws each picture once; every word is typeset, so it is spelled exactly. The words are written in whatever language the customer asks for in the theme or description, or the language they wrote the theme in, and English otherwise. 1 credit a card, whichever template — 12 cards is 12 credits, 24 cards is 24 credits, 36 cards is 36 credits, 48 cards is 48 credits. Before ordering, ask the customer the topic, the child's age (ageGroup), how many cards, the template, and colour or black and white. The order runs straight through to a PDF.", "inputSchema": { "additionalProperties": false, "properties": { "ageGroup": { "description": "Target age band, read by its youngest reader. Required, because it is not guessable and it changes the drawing: the four bands the page rules are written for are 3-6, 6-9, 9-13 and 13+, and line weight, how much background a page carries and how small the colourable areas get all step with them. Ask who the book is for rather than assuming the youngest band.", "examples": [ "3-6", "6-9", "9-13", "13-18", "adult" ], "type": "string" }, "colorMode": { "description": "color = full-colour pictures; black_and_white = clean black outlines the child colours in before cutting the cards out. Ask the customer.", "enum": [ "color", "black_and_white" ], "type": "string" }, "description": { "description": "Optional instructions in the customer's words — cards they want included, the language to print the words in, anything to keep in mind. They come first over the AI's own choices.", "type": "string" }, "flashcardCount": { "description": "How many cards to print. Every card is a different thing.", "enum": [ 12, 24, 36, 48 ], "type": "integer" }, "flashcardTemplate": { "description": "picture_word = the picture with its word under it, 6 a sheet; fold_and_glue = picture on the front, word and a short fact on the back, 3 a sheet. Defaults to picture_word.", "enum": [ "picture_word", "fold_and_glue" ], "type": "string" }, "pageTemplateImage": { "additionalProperties": false, "description": "Optional. A sample card the customer uploaded (upload_image first and send its s3Key): the deck is made like it, not copied. Its pictures' drawing style and its design (card colour, border, corners, where the word sits and its colour) carry over; what it shows and the word on it never do. On fold-and-glue cards the design is on the picture half. Pass exactly one of s3Key (returned by upload_image, or a picture uploaded on the website) or data (the PNG or JPEG itself, base64, at most 4 MB).", "properties": { "data": { "description": "Base64 PNG or JPEG bytes, optionally as a data: URI.", "maxLength": 5592534, "type": "string" }, "fileName": { "description": "Original file name.", "type": "string" }, "mimeType": { "description": "image/png or image/jpeg.", "type": "string" }, "s3Key": { "description": "Key returned by upload_image.", "type": "string" } }, "type": "object" }, "theme": { "description": "What the flashcards are about, in the customer's words, for example farm animals, fruit or the alphabet.", "maxLength": 120, "minLength": 1, "type": "string" } }, "required": [ "theme", "ageGroup", "flashcardCount", "colorMode" ], "type": "object" }, "name": "create_flashcard_book", "outputSchema": null }, { "description": "Create a fully illustrated children's story book from your story or a story prompt. Your own story is printed exactly as written. By default it is a picture book: one picture runs across each pair of facing pages and every page's words are typeset in a band along the top of that page, over the picture; the band grows with the reader's age. Other arrangements are available with pageTemplate — typeset under or above the picture, lettered into the artwork itself, typeset into a calm area of one connected image, or given a page of their own facing the picture. The order continues straight through illustration and PDF creation — nothing pauses for approval. To put the customer's own characters in the book, pass them in characterDetails, as the website's \"Who is in your book?\" step does. Before ordering, call list_my_characters; if they have saved characters, ask which of them to use, if any, and send those as { savedCharacterId }. Anyone else takes a name and one picture. Writing a saved character's name as @Name in the description or storyPrompt picks them too. If the customer wants to keep a new character for later books, save them with save_my_character first. A black-and-white saved character is coloured automatically. If the customer wants another book in a series, or the same characters as an earlier book, find it with list_my_books and pass its jobId as seriesSourceJobId rather than describing the characters again.", "inputSchema": { "additionalProperties": false, "anyOf": [ { "required": [ "storyText" ] }, { "required": [ "storyPrompt" ] }, { "required": [ "description" ] } ], "properties": { "additionalInstructions": { "description": "Extra direction for the generator, up to 600 characters.", "maxLength": 600, "type": "string" }, "ageGroup": { "description": "Target age band, read by its youngest reader. Required, because it is not guessable and it changes the drawing: the four bands the page rules are written for are 3-6, 6-9, 9-13 and 13+, and line weight, how much background a page carries and how small the colourable areas get all step with them. Ask who the book is for rather than assuming the youngest band.", "examples": [ "3-6", "6-9", "9-13", "13-18", "adult" ], "type": "string" }, "bleed": { "description": "Add print bleed to the interior pages. Defaults to false: leave it off for home printing and for A4 paper — bleed makes the page 8.625x11.25in with artwork running to the paper edge, and an A4 printer cuts 0.179in off each side of that. (Activity books describe their own default.)", "type": "boolean" }, "characterDetails": { "description": "Optional. The customer's own characters, up to fifteen, exactly as the website's \"Who is in your book?\" step takes them. Each entry is either a saved character, { savedCharacterId } with the characterId from list_my_characters and nothing else, which brings its saved name, description and picture; or a new character with a name, a short description and one picture. The two can be mixed. Every page that shows a character draws it from its picture, so each new picture must be of that character alone and the name must match it. Cannot be combined with characterReferenceSheet.", "items": { "anyOf": [ { "additionalProperties": false, "properties": { "savedCharacterId": { "description": "A characterId from list_my_characters.", "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "savedCharacterId" ], "type": "object" }, { "additionalProperties": false, "properties": { "description": { "description": "What the character is and looks like, e.g. \"a tabby cat with a red collar\".", "maxLength": 400, "type": "string" }, "name": { "description": "The character's name as it appears in the story or description.", "maxLength": 80, "minLength": 1, "type": "string" }, "referenceImage": { "additionalProperties": false, "description": "This character's picture. Pass exactly one of s3Key (returned by upload_image, or a picture uploaded on the website) or data (the PNG or JPEG itself, base64, at most 4 MB).", "properties": { "data": { "description": "Base64 PNG or JPEG bytes, optionally as a data: URI.", "maxLength": 5592534, "type": "string" }, "fileName": { "description": "Original file name.", "type": "string" }, "mimeType": { "description": "image/png or image/jpeg.", "type": "string" }, "s3Key": { "description": "Key returned by upload_image.", "type": "string" } }, "type": "object" } }, "required": [ "name", "referenceImage" ], "type": "object" } ], "type": "object" }, "maxItems": 15, "minItems": 1, "type": "array" }, "characterReferenceSheet": { "additionalProperties": false, "description": "Optional. One picture showing the book's characters together, used to keep them looking the same on every page. Cannot be combined with characterDetails. Pass exactly one of s3Key (returned by upload_image, or a picture uploaded on the website) or data (the PNG or JPEG itself, base64, at most 4 MB).", "properties": { "data": { "description": "Base64 PNG or JPEG bytes, optionally as a data: URI.", "maxLength": 5592534, "type": "string" }, "fileName": { "description": "Original file name.", "type": "string" }, "mimeType": { "description": "image/png or image/jpeg.", "type": "string" }, "s3Key": { "description": "Key returned by upload_image.", "type": "string" } }, "type": "object" }, "createSeries": { "description": "True to make this book part of a series. A series book's files are kept for good instead of being deleted after the usual retention period, so a later book can link to it at any time. Ask the customer if they want this when they mention more books to come. A book with seriesSourceJobId is always in a series, with or without this.", "type": "boolean" }, "description": { "description": "What the book should be about.", "type": "string" }, "highQuality": { "description": "Page quality — ask the customer, as the website does on every order. false = Standard, 2 credits a page: clean bold line art. true = Premium, 2.5 credits a page: finer detail and crisper lines.", "type": "boolean" }, "numberOfPages": { "description": "Number of interior pages to generate.", "maximum": 120, "minimum": 2, "type": "integer" }, "pageSize": { "description": "Trim size such as 8.5x11. The supported sizes are returned by list_book_types. A4 is not one of them and is rejected: for A4 or any metric paper, pass 8.5x11 with bleed false, which prints on A4 either way.", "type": "string" }, "pageTemplate": { "default": "words_top", "description": "Where the words sit. words_top (the default, and what the website makes for every age) is a picture book: one picture shared by every two pages (pages 1 and 2, 3 and 4, ...), cut down the middle, with only an odd book's last page drawn alone; every page's own words are typeset in a band along the top of that page over the picture's calm sky, and the band deepens and the type shrinks as the reader's age goes up. image_top_text_bottom and image_bottom_text_top typeset the story beside the picture. words_top_page is the same band on one picture per page, never across the fold, typeset by the PDF for every age. text_in_image makes each page one full-bleed illustration with words lettered into the art. full_page_image makes one connected image spanning both facing pages and typesets the story into a quiet area of the artwork. text_left_image_right draws the picture on the right-hand page and carries its background colour across onto the left, which becomes a whole page for the story. Every layout prints a story you wrote (storyText) except full_page_image, and every layout can write one from storyPrompt or description.", "enum": [ "image_top_text_bottom", "image_bottom_text_top", "text_in_image", "full_page_image", "text_left_image_right", "words_top", "words_top_page" ], "type": "string" }, "printOption": { "description": "Only send this when the person ordering has actually asked for it. Leave it out and the book type decides: coloring, story coloring and drawing books print one side per sheet with a blank back, because colour goes through the paper and would ruin the drawing behind it; every other type prints both sides. Sending \"both\" for a coloring book overrides that and gives them pages backed by pages.", "enum": [ "both", "single" ], "type": "string" }, "seriesSourceJobId": { "description": "The jobId of the customer's earlier book that this one continues. The new book starts with that book's characters, their pictures, its look and what happened in it, so pass it instead of re-uploading them. The customer's words for this book outrank all of it: they can change anything, add new characters in characterDetails, or say to leave someone out. A new character with the same name replaces the earlier one. list_my_books gives jobIds and says which books canContinueSeries; when it is not clear which book they mean, ask.", "type": "string" }, "standardQualityConfirmed": { "description": "Only with highQuality false: true once you have told the customer the Premium suggestion for books meant for sale and they chose to keep Standard (\"Print home quality\"). A Standard order without it is answered with that suggestion and not created.", "type": "boolean" }, "storyPrompt": { "description": "A premise or direction for InkChamps to write and illustrate. With neither storyText nor storyPrompt, the description is used as the premise.", "type": "string" }, "storyText": { "description": "Your own story to illustrate, printed exactly as written — split across the pages in code, never reworded. Use either storyText or storyPrompt, not both. Every pageTemplate prints it except full_page_image.", "type": "string" }, "style": { "description": "Illustration style, and the most visible decision in the book — ask rather than pick. Call list_book_types for the complete catalogue with a sentence describing each one. hand_drawn_2d, chibi_art, paper_cutout_collage are retired: use one only to match an earlier book already drawn in it.", "enum": [ "pixar_3d", "watercolor", "ghibli_painterly", "anime", "chibi_kawaii", "comic_book", "disney_storybook", "colored_pencil_sketch", "paper_collage", "flat_graphic", "claymation", "crayon_doodle", "mid_century_retro", "hand_drawn_2d", "chibi_art", "paper_cutout_collage" ], "type": "string" }, "theme": { "description": "Short subject line, for example dinosaurs or outer space.", "type": "string" }, "title": { "description": "Book title. Generated from the content when omitted.", "type": "string" } }, "required": [ "numberOfPages", "ageGroup", "style", "highQuality" ], "type": "object" }, "name": "create_illustrated_story_book", "outputSchema": null }, { "description": "Create a Pixel Reveal book: a hidden picture on every page, one subject each, picked from the customer's theme. monochrome = a grid of numbered squares, each marked with one black pen (a slash, a cross, three slashes or filled in); multicolor = a black page of dots, each with a code from a standard marker set. The grid gets finer, and the marks or colours more, with the reader's age. The answers print at the back, four to a page, free. 1 credit a puzzle page, with one tier only (no page quality to ask). Before ordering, ask the customer the theme, who it is for (ageGroup), monochrome or multicolor, and how many puzzle pages. The order runs straight through to a PDF.", "inputSchema": { "additionalProperties": false, "properties": { "ageGroup": { "description": "Target age band, read by its youngest reader. Required, because it is not guessable and it changes the drawing: the four bands the page rules are written for are 3-6, 6-9, 9-13 and 13+, and line weight, how much background a page carries and how small the colourable areas get all step with them. Ask who the book is for rather than assuming the youngest band.", "examples": [ "3-6", "6-9", "9-13", "13-18", "adult" ], "type": "string" }, "bleed": { "description": "Add print bleed to the pages. Defaults to true: every mark stays inside the margins either way, so the bleed edge is white paper.", "type": "boolean" }, "description": { "description": "Optional instructions in the customer's words — pictures they want, anything to keep in mind. They come first over the AI's own choices.", "maxLength": 2000, "type": "string" }, "numberOfPages": { "description": "Puzzle pages, one hidden picture each. The answer pages at the back are added on top and are not charged.", "enum": [ 10, 20, 30, 50 ], "type": "integer" }, "pageSize": { "description": "Trim size such as 8.5x11. The supported sizes are returned by list_book_types. A4 is not one of them and is rejected: for A4 or any metric paper, pass 8.5x11 with bleed false, which prints on A4 either way.", "type": "string" }, "pixelRevealStyle": { "description": "How the picture is revealed. monochrome = numbered squares marked with one black pen; multicolor = coded dots on a black page, coloured with markers from the key. Ask the customer; the website starts on monochrome.", "enum": [ "monochrome", "multicolor" ], "type": "string" }, "printOption": { "description": "Only send this when the customer has asked for it. Left out, a monochrome book prints on both sides (pen marks do not soak through) and a multicolor book one side per sheet (markers do).", "enum": [ "both", "single" ], "type": "string" }, "theme": { "description": "The book's theme in the customer's words, for example flowers, farm animals or space. A different picture is picked from it for every page.", "maxLength": 120, "minLength": 1, "type": "string" } }, "required": [ "theme", "ageGroup", "pixelRevealStyle", "numberOfPages" ], "type": "object" }, "name": "create_pixel_reveal_book", "outputSchema": null }, { "description": "Create a coloring book with story continuity across its pages. Put the story in description: a finished story the customer wrote is printed word for word, or a premise is written into one. The story coloring order continues automatically through illustration and PDF creation. To put the customer's own characters in the book, pass them in characterDetails, as the website's \"Who is in your book?\" step does. Before ordering, call list_my_characters; if they have saved characters, ask which of them to use, if any, and send those as { savedCharacterId }. Anyone else takes a name and one picture. Writing a saved character's name as @Name in the description or storyPrompt picks them too. If the customer wants to keep a new character for later books, save them with save_my_character first. If the customer wants another book in a series, or the same characters as an earlier book, find it with list_my_books and pass its jobId as seriesSourceJobId rather than describing the characters again.", "inputSchema": { "additionalProperties": false, "anyOf": [ { "required": [ "description" ] }, { "required": [ "theme" ] }, { "required": [ "style" ] } ], "properties": { "additionalInstructions": { "description": "Extra direction for the generator, up to 600 characters.", "maxLength": 600, "type": "string" }, "ageGroup": { "description": "Target age band, read by its youngest reader. Required, because it is not guessable and it changes the drawing: the four bands the page rules are written for are 3-6, 6-9, 9-13 and 13+, and line weight, how much background a page carries and how small the colourable areas get all step with them. Ask who the book is for rather than assuming the youngest band.", "examples": [ "3-6", "6-9", "9-13", "13-18", "adult" ], "type": "string" }, "bleed": { "description": "Add print bleed to the interior pages. Defaults to false: leave it off for home printing and for A4 paper — bleed makes the page 8.625x11.25in with artwork running to the paper edge, and an A4 printer cuts 0.179in off each side of that. (Activity books describe their own default.)", "type": "boolean" }, "characterDetails": { "description": "Optional. The customer's own characters, up to fifteen, exactly as the website's \"Who is in your book?\" step takes them. Each entry is either a saved character, { savedCharacterId } with the characterId from list_my_characters and nothing else, which brings its saved name, description and picture; or a new character with a name, a short description and one picture. The two can be mixed. Every page that shows a character draws it from its picture, so each new picture must be of that character alone and the name must match it. Cannot be combined with characterReferenceSheet.", "items": { "anyOf": [ { "additionalProperties": false, "properties": { "savedCharacterId": { "description": "A characterId from list_my_characters.", "maxLength": 64, "minLength": 1, "type": "string" } }, "required": [ "savedCharacterId" ], "type": "object" }, { "additionalProperties": false, "properties": { "description": { "description": "What the character is and looks like, e.g. \"a tabby cat with a red collar\".", "maxLength": 400, "type": "string" }, "name": { "description": "The character's name as it appears in the story or description.", "maxLength": 80, "minLength": 1, "type": "string" }, "referenceImage": { "additionalProperties": false, "description": "This character's picture. Pass exactly one of s3Key (returned by upload_image, or a picture uploaded on the website) or data (the PNG or JPEG itself, base64, at most 4 MB).", "properties": { "data": { "description": "Base64 PNG or JPEG bytes, optionally as a data: URI.", "maxLength": 5592534, "type": "string" }, "fileName": { "description": "Original file name.", "type": "string" }, "mimeType": { "description": "image/png or image/jpeg.", "type": "string" }, "s3Key": { "description": "Key returned by upload_image.", "type": "string" } }, "type": "object" } }, "required": [ "name", "referenceImage" ], "type": "object" } ], "type": "object" }, "maxItems": 15, "minItems": 1, "type": "array" }, "createSeries": { "description": "True to make this book part of a series. A series book's files are kept for good instead of being deleted after the usual retention period, so a later book can link to it at any time. Ask the customer if they want this when they mention more books to come. A book with seriesSourceJobId is always in a series, with or without this.", "type": "boolean" }, "description": { "description": "What the book should be about.", "type": "string" }, "highQuality": { "description": "Page quality — ask the customer, as the website does on every order. false = Standard, 2 credits a page: clean bold line art. true = Premium, 2.5 credits a page: finer detail and crisper lines.", "type": "boolean" }, "numberOfPages": { "description": "Number of interior pages to generate.", "maximum": 120, "minimum": 2, "type": "integer" }, "pageSize": { "description": "Trim size such as 8.5x11. The supported sizes are returned by list_book_types. A4 is not one of them and is rejected: for A4 or any metric paper, pass 8.5x11 with bleed false, which prints on A4 either way.", "type": "string" }, "printOption": { "description": "Only send this when the person ordering has actually asked for it. Leave it out and the book type decides: coloring, story coloring and drawing books print one side per sheet with a blank back, because colour goes through the paper and would ruin the drawing behind it; every other type prints both sides. Sending \"both\" for a coloring book overrides that and gives them pages backed by pages.", "enum": [ "both", "single" ], "type": "string" }, "seriesSourceJobId": { "description": "The jobId of the customer's earlier book that this one continues. The new book starts with that book's characters, their pictures, its look and what happened in it, so pass it instead of re-uploading them. The customer's words for this book outrank all of it: they can change anything, add new characters in characterDetails, or say to leave someone out. A new character with the same name replaces the earlier one. list_my_books gives jobIds and says which books canContinueSeries; when it is not clear which book they mean, ask.", "type": "string" }, "standardQualityConfirmed": { "description": "Only with highQuality false: true once you have told the customer the Premium suggestion for books meant for sale and they chose to keep Standard (\"Print home quality\"). A Standard order without it is answered with that suggestion and not created.", "type": "boolean" }, "storyFontSizePoints": { "description": "Optional, and only when the person asked for a particular text size: the story text in points, replacing the size chosen from the reader's age (22pt up to age 5, 18pt for 6-7, 16pt for 8-9, 14pt after). Leave it out for the age default. The story is typeset by the PDF at that size. A bigger size fits fewer words on each page.", "enum": [ 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34, 36 ], "type": "integer" }, "style": { "description": "Coloring direction. Use a value from coloringStyles returned by list_book_types.", "enum": [ "cute_animals", "cute_birds", "cute_insects", "mandala_animal", "mandala_sea", "mandala_birds", "mandala_abstract", "jungle_adventure", "story", "anxiety_motivation", "food_fun", "universe_space", "anime_characters", "inspirational", "mythology", "christmas", "fairy_tale", "general_coloring" ], "type": "string" }, "theme": { "description": "Short subject line, for example dinosaurs or outer space.", "type": "string" }, "title": { "description": "Book title. Generated from the content when omitted.", "type": "string" } }, "required": [ "numberOfPages", "ageGroup", "highQuality" ], "type": "object" }, "name": "create_story_coloring_book", "outputSchema": null }, { "description": "Bring an existing paperback cover inside KDP's trim and safe lines WITHOUT redrawing it: every word, character and the whole design stay exactly as they are, only made a little smaller and moved where something crossed a line, with the freed edge filled to match. Use it when a cover the customer likes was refused by KDP or has its title, characters or objects too close to the edge — never order a new cover or redraw a side just to fix the edges, because a redraw changes the art. A side already inside is left untouched. Runs in the background: poll get_job_status with the same jobId until it is IMAGES_READY again, then call generate_pdf to rebuild the cover's PDF.", "inputSchema": { "additionalProperties": false, "properties": { "jobId": { "description": "The cover's jobId, as create_cover_photo or list_my_books returned it.", "type": "string" } }, "required": [ "jobId" ], "type": "object" }, "name": "fit_cover_to_kdp", "outputSchema": null }, { "description": "Build or rebuild the printable PDF for a book from its current page images, or for a paperback cover from its current sides. Call it once a cover is IMAGES_READY to get the cover's print PDF, and again after fit_cover_to_kdp or regenerate_image on it. Needed after regenerate_image: regenerating a page replaces that page's image but does NOT rebuild the PDF, so the download stays stale until this runs. Regenerate every page you want to fix first, wait for get_job_status to show IMAGES_READY, then call this once: it is refused while a page is still being redrawn. Poll get_job_status with the same jobId for the new pdfUrl. Costs no credits.", "inputSchema": { "additionalProperties": false, "properties": { "jobId": { "description": "The jobId of the book to rebuild, as returned by a book creation tool or get_job_status.", "type": "string" }, "storyFontSizePoints": { "description": "Story coloring books only, and only when the person asked for a different text size: rebuild with the story text at this size in points, kept for later rebuilds. null goes back to the size chosen by the reader's age. Leave it out to keep the book's current size. Works on a finished book too.", "enum": [ 14, 16, 18, 20, 22, 24, 26, 28, 30, 32, 34, 36, null ], "type": [ "integer", "null" ] } }, "required": [ "jobId" ], "type": "object" }, "name": "generate_pdf", "outputSchema": null }, { "description": "Read the account's available credits. If bookType and numberOfPages are provided, also calculate the credit cost and whether the account can afford the order.", "inputSchema": { "additionalProperties": false, "properties": { "activities": { "description": "workbook only: the activities as they will be ordered, so Premium is priced on the coloring pages.", "items": { "type": "string" }, "type": "array" }, "bookType": { "description": "Optional book type to price. An activity book is workbook.", "enum": [ "coloring_book", "coloring_book_with_story", "color_to_learn_book", "illustrative_story_book", "illustrative_story_book_text_in_image", "illustrative_story_book_spread", "workbook", "bingo_book", "flashcard_book", "pixel_reveal_book" ], "type": "string" }, "hasReferenceImage": { "description": "No longer affects the price — uploaded characters cost nothing extra. Accepted for older clients.", "type": "boolean" }, "highQuality": { "description": "Price the order at the higher-quality tier: 2.5 credits a page for a coloring book, story coloring, educational coloring and illustrated story books. An activity book (workbook) charges 2 a page on its coloring pages and its black-and-white hidden-pictures and spot-the-difference pages, and 1 on every other page, so send its activities (and pagesByType) to price it.", "type": "boolean" }, "inkByType": { "description": "workbook only: each activity's ink, \"black_and_white\" or \"color\". Premium upgrades hidden-pictures and spot-the-difference pages only in black and white.", "type": "object" }, "numberOfPages": { "description": "Optional page count to price.", "maximum": 120, "minimum": 2, "type": "integer" }, "pagesByType": { "additionalProperties": { "minimum": 0, "type": "integer" }, "description": "workbook only: pages of each activity, as they will be ordered.", "type": "object" } }, "type": "object" }, "name": "get_credits", "outputSchema": null }, { "description": "Get the status of a book order. When the job is complete, returns a presigned S3 PDF URL that the agent can fetch. While pages are being redrawn the status is PROCESSING and pendingRedraws says how many are left; generate_pdf works once the status is IMAGES_READY.", "inputSchema": { "additionalProperties": false, "properties": { "jobId": { "description": "The jobId returned by one of the book creation tools.", "type": "string" } }, "required": [ "jobId" ], "type": "object" }, "name": "get_job_status", "outputSchema": null }, { "description": "List the book creation tools, supported book types, credit rates, activity options, coloring directions, illustration styles, and shared print options available through MCP.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "list_book_types", "outputSchema": null }, { "description": "List the customer's own books, newest first: jobId, title, type, status, the named characters and how many character pictures the customer uploaded. Use it to find the book a cover is for — pass that book's jobId as create_cover_photo's sourceJobId — and to show the customer their books when you need to ask which one they mean. canLinkCover says whether a cover can be linked to the book now; coverLinkNote says why not. It also finds the book a new one continues: pass that jobId as seriesSourceJobId on a create tool. canContinueSeries says whether a new book can continue from it now; seriesNote says why not; isSeriesBook marks a book kept for good.", "inputSchema": { "additionalProperties": false, "properties": { "cursor": { "description": "nextCursor from the previous call, to read the next page.", "type": "string" }, "limit": { "description": "How many books to return. Defaults to 20.", "maximum": 50, "minimum": 1, "type": "integer" } }, "type": "object" }, "name": "list_my_books", "outputSchema": null }, { "description": "List the characters the customer has saved in My Characters on the website: characterId, name, description and isColor. To put one in a coloring book, story coloring book or illustrated story book, tell the customer who is saved, ask which of them to use, and send the choice in that order's characterDetails as { savedCharacterId: characterId }. Never choose for them. isColor false means the saved picture is black and white: it can still go in an illustrated story book, which colours it automatically. Listing costs no credits.", "inputSchema": { "additionalProperties": false, "properties": {}, "type": "object" }, "name": "list_my_characters", "outputSchema": null }, { "description": "Regenerate the illustration on a single page of an existing book, replacing the current image for that page. Use when one page came out wrong and the rest of the book is fine — it costs one page's worth of credits instead of rerunning the whole book. The description says what should change; it is combined with that page's original prompt, so describe the fix ('make the dog smaller and move it to the left'), not the whole scene from scratch. On an activity book, a built page's puzzle — the maze, the word search grid and words, the sudoku's numbers, the letters to trace — always stays exactly as it is; the change is made to the picture and the page around it. This does NOT rebuild the PDF. The job is PROCESSING until every page being redrawn has finished, and generate_pdf is refused until then, so regenerate every page you want to fix, poll get_job_status until the job is IMAGES_READY, and then call generate_pdf once.", "inputSchema": { "additionalProperties": false, "properties": { "description": { "description": "What should change about this page, in plain language. Combined with the page's original prompt rather than replacing it. Write a saved character's name from list_my_characters as @Name to draw them from their saved picture.", "type": "string" }, "jobId": { "description": "The jobId of the book containing the page, as returned by a book creation tool or get_job_status.", "type": "string" }, "pageNumber": { "description": "Which interior page to regenerate, counting from 1. Must be within the book's page count.", "minimum": 1, "type": "integer" } }, "required": [ "jobId", "pageNumber", "description" ], "type": "object" }, "name": "regenerate_image", "outputSchema": null }, { "description": "Retry a book job that has FAILED. Reads the original workflow input from the job's stored Step Functions execution and starts a fresh execution of the same state machine in rerun mode, so page images that were already generated are reused instead of being paid for again. Only works on jobs in FAILED status; check with get_job_status first. Returns the job with its new status and execution.", "inputSchema": { "additionalProperties": false, "properties": { "jobId": { "description": "The jobId of the failed job, as returned by a book creation tool or get_job_status.", "type": "string" } }, "required": [ "jobId" ], "type": "object" }, "name": "retry_job", "outputSchema": null }, { "description": "Save a character to the customer's My Characters, so any later book can use them. Do this only when the customer asks to keep this character, because the picture often shows a real person and is kept until they delete it on the website. The picture should show this character alone. The name must be new: an @Name has to point at one character. Returns a characterId to send in an order's characterDetails as { savedCharacterId: characterId }. Saving costs no credits. Editing and deleting are on the website's My Characters page.", "inputSchema": { "additionalProperties": false, "properties": { "description": { "description": "What the character is and looks like, e.g. \"a tabby cat with a red collar\".", "maxLength": 400, "type": "string" }, "image": { "additionalProperties": false, "description": "This character's picture. An s3Key from upload_image needs purpose character. Pass exactly one of s3Key (returned by upload_image, or a picture uploaded on the website) or data (the PNG or JPEG itself, base64, at most 4 MB).", "properties": { "data": { "description": "Base64 PNG or JPEG bytes, optionally as a data: URI.", "maxLength": 5592534, "type": "string" }, "fileName": { "description": "Original file name.", "type": "string" }, "mimeType": { "description": "image/png or image/jpeg.", "type": "string" }, "s3Key": { "description": "Key returned by upload_image.", "type": "string" } }, "type": "object" }, "name": { "description": "The character's name, as the customer would write it after an @.", "maxLength": 80, "minLength": 1, "type": "string" } }, "required": [ "name", "image" ], "type": "object" }, "name": "save_my_character", "outputSchema": null }, { "description": "Upload a PNG or JPEG (at most 4 MB) to this InkChamps account and get back an s3Key to pass in a book order — a character's picture (characterDetails[].referenceImage), a character sheet (characterReferenceSheet), a page template (pageTemplateImage) or cover art (frontCoverImage / backCoverImage). Upload once and reuse the key in as many orders as you like. Costs no credits. Every image field also accepts the picture inline as data, so this step is optional. Each image must be under 4 MB (a request limit), which for a print-size photo or painting means JPEG; PNG is fine when it fits. A cover side must have the shape of the book's cover side (the trim plus KDP's 0.125in bleed on its outer edges, e.g. 8.625x11.25in for 8.5x11) at 300 dpi or more (2588x3375 pixels for 8.5x11); see frontCoverImage on create_cover_photo for every trim.", "inputSchema": { "additionalProperties": false, "properties": { "data": { "description": "The PNG or JPEG bytes, base64, optionally as a data: URI.", "minLength": 1, "type": "string" }, "fileName": { "description": "Original file name.", "type": "string" }, "purpose": { "description": "Where the key will be used: character (one character's picture in characterDetails), character_sheet (characterReferenceSheet), page_template (pageTemplateImage), cover (frontCoverImage or backCoverImage). A key only works in the field its purpose names.", "enum": [ "character", "character_sheet", "page_template", "cover" ], "type": "string" } }, "required": [ "purpose", "data" ], "type": "object" }, "name": "upload_image", "outputSchema": null } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:94534d4f3d50ac8ca64dad6d12c1b01e4fc9ff3a797c9f14962439ec8b514f5a | sha256sum