InkChamps + MCP

Use InkChamps — an AI book generator for coloring books, activity books, illustrated story books, and KDP-ready covers — from any MCP-compatible AI client: Claude, Claude Desktop, Claude Code, or Cursor.

This repository contains examples and workflows, not the MCP implementation itself. The InkChamps MCP server is hosted by InkChamps; you connect to it with an API key and a few lines of config.

What is InkChamps?

InkChamps turns a plain-language description into a print-ready PDF book:

• Coloring books — themed line art, 17 coloring directions (cute animals, mandalas, space, mythology, and more), 3 complexity levels
• Story coloring books — coloring pages with continuous story text
• Illustrated story books — fully illustrated children's books in 10 styles (Pixar 3D, anime, Ghibli-style painterly, Disney storybook, comic book, and more), written from your story or a one-line premise
• Activity books — mazes, sudoku, word search, tracing worksheets, spot-the-difference, connect-the-dots, drawing practice, or a mixed workbook combining several
• Custom activity pages — generated from your own description and a reference image
• KDP-ready covers — coordinated front/back paperback covers with correct spine width for your page count and paper type

Every order renders straight to a print-ready PDF — no manual page assembly.

Quick start

1. Create an InkChamps account at inkchamps.com
2. Mint an MCP API key at Settings → MCP
3. Add InkChamps to your MCP client:

claude mcp add --transport http inkchamps https://prod.api.inkchamps.com/mcp \
  --header "Authorization: Bearer ic_mcp_..."

Or in claude_desktop_config.json / ~/.cursor/mcp.json:

{
  "mcpServers": {
    "inkchamps": {
      "type": "http",
      "url": "https://prod.api.inkchamps.com/mcp",
      "headers": { "Authorization": "Bearer ic_mcp_..." }
    }
  }
}

4. Ask your AI client to create a book. See claude/getting-started.md.

Tools exposed over MCP

Tool	What it does
list_book_types	Full catalogue: book types, styles, activity types, trim sizes, credit costs
get_credits	Your available/reserved credits and a cost estimate for an order
create_coloring_book	Themed line-art coloring book
create_story_coloring_book	Coloring book with continuous story text
create_illustrated_story_book	Fully illustrated children's story book
create_activity_book	One activity type, or a mixed workbook
create_custom_activity_book	Custom activity pages from a description + reference image
create_cover_photo	Print-ready KDP paperback cover
get_job_status	Poll job progress; returns the presigned PDF URL when done
retry_job	Retry a failed generation job

MCP orders don't stop for manual approval — describe the book, and it runs straight through generation to a finished PDF. Poll get_job_status until it's ready.

In this repo

• claude/ — walkthroughs for each book type, from prompt to PDF
• use-cases/ — InkChamps for KDP publishers, Etsy sellers, teachers, homeschoolers, and printables sites
• prompts/ — copy-paste prompt templates for the main book types

Links

• InkChamps
• Free coloring book prompts — a companion repo of ready-to-use prompts by theme