EBookBrew MCP

Make a complete book from your agent

Connect once. Then create projects, review outlines, write chapters, manage covers, check credits, and export finished books without changing tools.

Connect a client Browse 27 tools

Hosted server

https://mcp.ebookbrew.com/mcp

27tools

3export types

1credit balance

Start here

Connect a client

Add the server, confirm access in your browser, and return to your agent. Your password is never shared with the MCP client.

01
Add
Add the hosted server to your MCP client.
02
Confirm
Sign in and review the requested access.
03
Brew
Ask your agent to list or create a book.

Claude Code

Run one command in your terminal.

claude mcp add --transport http ebookbrew https://mcp.ebookbrew.com/mcp

Codex

Run one command in your terminal.

codex mcp add ebookbrew --url https://mcp.ebookbrew.com/mcp

Cursor

Add this object in Cursor MCP settings.

{
  "mcpServers": {
    "ebookbrew": {
      "url": "https://mcp.ebookbrew.com/mcp"
    }
  }
}

Other clients

Choose a custom remote MCP server and enter this address.

https://mcp.ebookbrew.com/mcp

If your client does not support remote MCP servers, run npx ebookbrew-mcp login once. Then configure npx -y ebookbrew-mcp as a local server.

Try a prompt

Start with intent, not tool names

A capable agent can choose the right EBookBrew tools. State what you want, where approval is needed, and when the agent must stop.

List my books and tell me what is incomplete.
Create a workbook for new managers. Show me the outline before you approve it.
Write chapters 1 and 2 only. Report the credit use after each chapter.
Make a minimal cover, activate it, and export the book as EPUB.

Clear controls

Costs and safety

Safe retries

Every change needs an idempotency key. Reuse a key only for the same attempted action.

No MCP fee

Tool calls are free. Generation uses the normal price: brief 2, text chapter 1, coloring page 2, and cover 3 credits.

Free exports

PDF, EPUB, and DOCX exports are free after the account buys a plan or credit pack.

Reference

All MCP tools

Each tool has structured input and output. Errors return a stable code and a safe message.

27 tools

list_projects

Free

List EBookBrew projects

Use this when the user wants to find or review their EBookBrew projects. Do not use it to create or change a project.

Scope: read

Example input

{
  "page": 1,
  "pageSize": 20
}

Example output

{
  "projects": [],
  "page": 1,
  "pageSize": 20,
  "total": 0,
  "hasMore": false
}

get_project

Free

Get an EBookBrew project

Use this when the user wants one project with its brief, chapter status, cover versions, and cached exports. Chapter text is omitted to keep this response small; call get_chapter for one full chapter.

Scope: read

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111"
}

Example output

{
  "project": {
    "id": "11111111-1111-4111-8111-111111111111",
    "concept": "A guide to quiet launches",
    "format": "guide",
    "audience": null,
    "tone": null,
    "status": "draft",
    "headingPageBreak": "none",
    "interiorTheme": "classic",
    "pageSize": "a5",
    "designFont": "source-serif",
    "textColor": "ink",
    "fontSize": null,
    "lineHeight": null,
    "title": null,
    "writeAll": {
      "active": false,
      "stopReason": null
    },
    "createdAt": "2026-08-23T12:00:00.000Z",
    "updatedAt": "2026-08-23T12:00:00.000Z"
  },
  "brief": null,
  "chapters": [],
  "covers": [],
  "exports": []
}

get_chapter

Free

Get one EBookBrew chapter

Use this when the user or agent needs the full text or page image for one chapter position.

Scope: read

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 1
}

Example output

{
  "chapter": {
    "id": "33333333-3333-4333-8333-333333333333",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "position": 1,
    "kind": "chapter",
    "title": "Start small",
    "summary": "Define a narrow promise",
    "guidance": null,
    "content": "# Start small\n\nA focused launch begins...",
    "imageUrl": null,
    "version": 1,
    "wordCount": 820,
    "status": "done"
  }
}

create_project

Free

Create an EBookBrew project

Use this when the user has a book concept and wants a new EBookBrew project. This saves the concept only; call generate_brief next to create an outline.

Scope: generate

Example input

{
  "concept": "A practical guide to quiet product launches",
  "format": "guide",
  "audience": "solo founders",
  "tone": "calm and direct",
  "idempotencyKey": "launch-guide-001"
}

Example output

{
  "project": {
    "id": "11111111-1111-4111-8111-111111111111",
    "concept": "A practical guide to quiet product launches",
    "format": "guide",
    "audience": "solo founders",
    "tone": "calm and direct",
    "status": "draft",
    "headingPageBreak": "none",
    "interiorTheme": "classic",
    "pageSize": "a5",
    "designFont": "source-serif",
    "textColor": "ink",
    "fontSize": null,
    "lineHeight": null,
    "title": null,
    "writeAll": {
      "active": false,
      "stopReason": null
    },
    "createdAt": "2026-08-23T12:00:00.000Z",
    "updatedAt": "2026-08-23T12:00:00.000Z"
  }
}

update_project

Free

Update an EBookBrew project

Use this to change the source concept, format, audience, or tone before a brief exists. After brief generation, update the brief instead so the plan and manuscript stay consistent.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "audience": "first-time founders",
  "tone": "concise",
  "idempotencyKey": "project-edit-001"
}

Example output

{
  "project": {
    "id": "11111111-1111-4111-8111-111111111111",
    "concept": "A practical guide to quiet product launches",
    "format": "guide",
    "audience": "solo founders",
    "tone": "calm and direct",
    "status": "draft",
    "headingPageBreak": "none",
    "interiorTheme": "classic",
    "pageSize": "a5",
    "designFont": "source-serif",
    "textColor": "ink",
    "fontSize": null,
    "lineHeight": null,
    "title": null,
    "writeAll": {
      "active": false,
      "stopReason": null
    },
    "createdAt": "2026-08-23T12:00:00.000Z",
    "updatedAt": "2026-08-23T12:00:00.000Z"
  }
}

archive_project

Free

Remove an EBookBrew project from the library

Use this only when the user asks to remove a project from their library. This archives the project and blocks access, but keeps its data and audit records.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "idempotencyKey": "archive-project-001"
}

Example output

{
  "archived": true,
  "projectId": "11111111-1111-4111-8111-111111111111"
}

generate_brief

2 credits

Generate an EBookBrew brief

Use this when a project needs its first title options, chapter plan, and writing brief. Do not call it after approval; use update_brief for later changes.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "targetChapterCount": 12,
  "idempotencyKey": "brief-001"
}

Example output

{
  "brief": {
    "id": "22222222-2222-4222-8222-222222222222",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "title": "The Quiet Launch",
    "titleOptions": [
      "The Quiet Launch",
      "Launch Without Noise",
      "Small Audience, Strong Launch"
    ],
    "subtitle": "A practical guide for solo founders",
    "authorName": null,
    "targetWordCount": 9000,
    "chapterPlan": [],
    "approvedAt": null
  }
}

update_brief

Free

Update an EBookBrew brief

Use this when the user wants to edit the title, author, word count, or chapter plan before or after approval. This can invalidate an active cover when title data changes.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "title": "The Quiet Launch",
  "subtitle": "Launch well without a large audience",
  "authorName": "A. Writer",
  "targetWordCount": 9000,
  "chapterPlan": [
    {
      "position": 1,
      "title": "Start small",
      "summary": "Define a narrow promise",
      "guidance": null
    }
  ],
  "idempotencyKey": "brief-edit-001"
}

Example output

{
  "brief": {
    "id": "22222222-2222-4222-8222-222222222222",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "title": "The Quiet Launch",
    "titleOptions": [],
    "subtitle": "Launch well without a large audience",
    "authorName": "A. Writer",
    "targetWordCount": 9000,
    "chapterPlan": [],
    "approvedAt": null
  }
}

approve_brief

Free

Approve an EBookBrew brief

Use this only after the user accepts the title and chapter plan. Approval creates the chapter records and opens chapter writing.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "title": "The Quiet Launch",
  "subtitle": "Launch well without a large audience",
  "authorName": "A. Writer",
  "targetWordCount": 9000,
  "chapterPlan": [
    {
      "position": 1,
      "title": "Start small",
      "summary": "Define a narrow promise",
      "guidance": null
    }
  ],
  "idempotencyKey": "brief-approve-001"
}

Example output

{
  "approved": true,
  "projectId": "11111111-1111-4111-8111-111111111111"
}

write_chapter

1 credit (2 credits for a coloring_book page)

Write an EBookBrew chapter

Use this when an approved brief has a pending chapter that the user wants written. Write one chapter per call; do not loop without the user's requested chapter range. In a coloring_book project the chapter is a drawn page and costs 2 credits.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 1,
  "idempotencyKey": "chapter-1-write-001"
}

Example output

{
  "chapter": {
    "id": "33333333-3333-4333-8333-333333333333",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "position": 1,
    "kind": "chapter",
    "title": "Start small",
    "summary": "Define a narrow promise",
    "guidance": null,
    "content": "# Start small\n\nA focused launch begins...",
    "imageUrl": null,
    "version": 1,
    "wordCount": 820,
    "status": "done"
  }
}

write_all

1 credit per chapter (2 credits per coloring_book page), charged as each chapter starts

Write every pending EBookBrew chapter

Use this when the user wants the whole book written. The server writes the pending and failed chapters in order, one charge per chapter (1 credit; 2 credits per coloring_book page), and this call returns at once. Poll get_project: the chain has finished when project.writeAll.active is false. project.writeAll.stopReason is null after a clean finish; insufficient_credits, rate_limited, chapter_failed, or error means it stopped early and the remaining chapters are still pending or failed.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "idempotencyKey": "write-all-001"
}

Example output

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "queuedChapterCount": 8
}

stop_write_all

Free

Stop EBookBrew write-all

Use this when the user asks to stop an active write-all run. The current chapter can finish, but no later chapter will start.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "idempotencyKey": "stop-write-all-001"
}

Example output

{
  "stopped": true,
  "projectId": "11111111-1111-4111-8111-111111111111"
}

regenerate_chapter

1 credit (2 credits for a coloring_book page)

Regenerate an EBookBrew chapter

Use this when the user wants another version of an existing chapter. Include concrete revision guidance when the user gave it. In a coloring_book project this redraws the page and costs 2 credits.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 1,
  "revisionGuidance": "Add one concrete example and shorten the opening.",
  "idempotencyKey": "chapter-1-revise-001"
}

Example output

{
  "chapter": {
    "id": "33333333-3333-4333-8333-333333333333",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "position": 1,
    "kind": "chapter",
    "title": "Start small",
    "summary": "Define a narrow promise",
    "guidance": null,
    "content": "# Start small\n\nStart with one reader...",
    "imageUrl": null,
    "version": 2,
    "wordCount": 790,
    "status": "done"
  }
}

list_chapter_versions

Free

List saved EBookBrew chapter versions

Use this before restoring an earlier generated chapter or coloring page. It returns version IDs and revision notes, but not duplicate manuscript text.

Scope: read

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 1
}

Example output

{
  "versions": [
    {
      "id": "66666666-6666-4666-8666-666666666666",
      "version": 2,
      "revisionGuidance": "Shorten the opening.",
      "createdAt": "2026-08-23T12:30:00.000Z"
    }
  ]
}

restore_chapter_version

Free

Restore an EBookBrew chapter version

Use this only when the user chooses an earlier saved version. It makes that version the current chapter without deleting any saved versions.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 1,
  "versionId": "66666666-6666-4666-8666-666666666666",
  "idempotencyKey": "restore-chapter-001"
}

Example output

{
  "chapter": {
    "id": "33333333-3333-4333-8333-333333333333",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "position": 1,
    "kind": "chapter",
    "title": "Start small",
    "summary": "Define a narrow promise",
    "guidance": null,
    "content": "# Start small\n\nStart with one reader...",
    "imageUrl": null,
    "version": 2,
    "wordCount": 790,
    "status": "done"
  }
}

update_chapter

Free

Update an EBookBrew chapter

Use this when the user supplies manual chapter edits or metadata changes. This overwrites the current editable chapter, so do not call it without the user's replacement text or requested changes.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 1,
  "content": "# Start small\n\nEdited chapter text.",
  "idempotencyKey": "chapter-1-edit-001"
}

Example output

{
  "chapter": {
    "id": "33333333-3333-4333-8333-333333333333",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "position": 1,
    "kind": "chapter",
    "title": "Start small",
    "summary": "Define a narrow promise",
    "guidance": null,
    "content": "# Start small\n\nEdited chapter text.",
    "imageUrl": null,
    "version": 1,
    "wordCount": 6,
    "status": "done"
  }
}

add_manual_content

Free

Add manual EBookBrew content

Use this when the user wants to insert authored text into an approved manuscript. A manual chapter is numbered; a section is unnumbered and uses only its title.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "kind": "section",
  "title": "Credits",
  "position": 9,
  "idempotencyKey": "credits-001"
}

Example output

{
  "chapter": {
    "id": "55555555-5555-4555-8555-555555555555",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "position": 9,
    "kind": "section",
    "title": "Credits",
    "summary": "",
    "guidance": null,
    "content": "",
    "imageUrl": null,
    "version": 0,
    "wordCount": 0,
    "status": "draft"
  }
}

delete_content

Free

Delete EBookBrew content

Use this only when the user asks to permanently delete a chapter or section and its saved versions. At least one manuscript item must remain.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 9,
  "idempotencyKey": "delete-credits-001"
}

Example output

{
  "deleted": true,
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 9
}

generate_cover

3 credits

Generate an EBookBrew cover

Use this when the user wants AI cover artwork for a project with a brief. Omit sourceCoverId to create new artwork from the prompt and style; pass sourceCoverId with revisionGuidance to edit the current artwork. Both charge credits; do not use it for text-only edits.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "prompt": "One paper boat crossing a calm dark lake",
  "style": "minimal",
  "idempotencyKey": "cover-001"
}

Example output

{
  "cover": {
    "id": "44444444-4444-4444-8444-444444444444",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "imageUrl": "https://example.public.blob.vercel-storage.com/cover.jpg",
    "promptUsed": "One paper boat...",
    "editable": true,
    "style": "minimal",
    "direction": "One paper boat crossing a calm dark lake",
    "textSettings": {
      "font": "serif",
      "fade": 0.6,
      "title": {
        "scale": 1,
        "color": "#FFFFFF",
        "alignment": "left"
      },
      "subtitle": {
        "scale": 1,
        "color": "#FFFFFF"
      },
      "author": {
        "scale": 1,
        "color": "#FFFFFF",
        "alignment": "left"
      },
      "titlePosition": {
        "x": 0.1,
        "y": 0.11
      },
      "authorPosition": {
        "x": 0.1,
        "y": 0.88
      }
    },
    "trim": "1600x2560",
    "isActive": true,
    "createdAt": "2026-08-23T12:00:00.000Z"
  }
}

update_cover_text

Free

Update EBookBrew cover text

Use this to change the font, fade strength, or the per-block size, color, and alignment of the title, subtitle, and author on an editable cover. This re-renders the cover in place without an AI call or credit charge.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "coverId": "44444444-4444-4444-8444-444444444444",
  "textSettings": {
    "font": "sans",
    "fade": 0.6,
    "title": {
      "scale": 1.1,
      "color": "#F6EEE1",
      "alignment": "center"
    },
    "subtitle": {
      "scale": 1,
      "color": "#F6EEE1"
    },
    "author": {
      "scale": 1,
      "color": "#E8C46A",
      "alignment": "center"
    },
    "titlePosition": {
      "x": 0.5,
      "y": 0.12
    },
    "authorPosition": {
      "x": 0.5,
      "y": 0.88
    }
  },
  "idempotencyKey": "cover-text-001"
}

Example output

{
  "cover": {
    "id": "44444444-4444-4444-8444-444444444444",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "imageUrl": "https://example.public.blob.vercel-storage.com/cover.jpg",
    "promptUsed": "One paper boat...",
    "editable": true,
    "style": "minimal",
    "direction": "One paper boat crossing a calm dark lake",
    "textSettings": {
      "font": "serif",
      "fade": 0.6,
      "title": {
        "scale": 1,
        "color": "#FFFFFF",
        "alignment": "left"
      },
      "subtitle": {
        "scale": 1,
        "color": "#FFFFFF"
      },
      "author": {
        "scale": 1,
        "color": "#FFFFFF",
        "alignment": "left"
      },
      "titlePosition": {
        "x": 0.1,
        "y": 0.11
      },
      "authorPosition": {
        "x": 0.1,
        "y": 0.88
      }
    },
    "trim": "1600x2560",
    "isActive": true,
    "createdAt": "2026-08-23T12:00:00.000Z"
  }
}

activate_cover

Free

Activate an EBookBrew cover

Use this when the user chooses one existing cover version for export. Editable covers are re-rendered with the current book title before activation.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "coverId": "44444444-4444-4444-8444-444444444444",
  "idempotencyKey": "activate-cover-001"
}

Example output

{
  "cover": {
    "id": "44444444-4444-4444-8444-444444444444",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "imageUrl": "https://example.public.blob.vercel-storage.com/cover.jpg",
    "promptUsed": "One paper boat...",
    "editable": true,
    "style": "minimal",
    "direction": "One paper boat crossing a calm dark lake",
    "textSettings": {
      "font": "serif",
      "fade": 0.6,
      "title": {
        "scale": 1,
        "color": "#FFFFFF",
        "alignment": "left"
      },
      "subtitle": {
        "scale": 1,
        "color": "#FFFFFF"
      },
      "author": {
        "scale": 1,
        "color": "#FFFFFF",
        "alignment": "left"
      },
      "titlePosition": {
        "x": 0.1,
        "y": 0.11
      },
      "authorPosition": {
        "x": 0.1,
        "y": 0.88
      }
    },
    "trim": "1600x2560",
    "isActive": true,
    "createdAt": "2026-08-23T12:00:00.000Z"
  }
}

update_design

Free

Update an EBookBrew book design

Use this when the user picks an interior theme, page size, font, text color, text size, line height, or heading page breaks for the book's exports. Omitted fields return to their defaults. The next export re-renders with the new design.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "theme": "elegant",
  "pageSize": "trade",
  "font": "traditional-serif",
  "textColor": "espresso",
  "idempotencyKey": "design-001"
}

Example output

{
  "project": {
    "id": "11111111-1111-4111-8111-111111111111",
    "concept": "A practical guide to quiet product launches",
    "format": "guide",
    "audience": "solo founders",
    "tone": "calm and direct",
    "status": "writing",
    "headingPageBreak": "none",
    "interiorTheme": "elegant",
    "pageSize": "trade",
    "designFont": "traditional-serif",
    "textColor": "espresso",
    "fontSize": null,
    "lineHeight": null,
    "title": "The Quiet Launch",
    "writeAll": {
      "active": false,
      "stopReason": null
    },
    "createdAt": "2026-08-23T12:00:00.000Z",
    "updatedAt": "2026-08-23T12:00:00.000Z"
  }
}

export_book

Free; paid account required

Export an EBookBrew book

Use this to download a full book, content without a cover, or the active cover image. Book exports require every chapter to be complete. Cover-only downloads need only a saved cover and return JPG; kind is ignored. All downloads need a paid account. Give the user the link; it downloads in their signed-in browser.

Scope: export

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "kind": "epub",
  "idempotencyKey": "export-epub-001"
}

Example output

{
  "exportId": "77777777-7777-4777-8777-777777777777",
  "kind": "epub",
  "filename": "weekend-sourdough.epub",
  "url": "https://ebookbrew.com/api/books/11111111-1111-4111-8111-111111111111/exports/epub",
  "cached": false
}

create_checkout

Free

Create an EBookBrew checkout link

Use this when the user asks to buy a plan or credit pack. Return the secure link and let the user finish payment in their browser.

Scope: generate

Example input

{
  "purchase": "subscription",
  "plan": "pour_over",
  "idempotencyKey": "checkout-plan-001"
}

Example output

{
  "url": "https://checkout.example.com/session"
}

get_billing_portal_link

Free

Create an EBookBrew billing link

Use this when the user asks to manage a plan, payment method, invoices, or cancellation. Return the secure link and let the user make billing changes in their browser.

Scope: generate

Example input

{
  "idempotencyKey": "billing-portal-001"
}

Example output

{
  "url": "https://billing.example.com/session"
}

get_balance

Free

Get EBookBrew credit balance

Use this when the user asks about credits, plan status, renewal, or export access. Use create_checkout or get_billing_portal_link only when the user asks to take a billing action.

Scope: read

Example input

{}

Example output

{
  "credits": 25,
  "downloadsUnlocked": false,
  "hasActiveSubscription": false,
  "plan": null,
  "subscriptionCreditsExpireAt": null,
  "pricingUrl": "https://ebookbrew.com/pricing",
  "billingUrl": "https://ebookbrew.com/settings/billing"
}

get_generations

Free

Get EBookBrew generation history

Use this when the user wants their recent brief, chapter, or cover generation status and credit use. Do not use it to read agent request logs.

Scope: read

Example input

{
  "limit": 25
}

Example output

{
  "generations": []
}

Ready to connect?

Open MCP settings to control access and review activity.

Open MCP settings

EBookBrew MCP

Make a complete book from your agent

Connect once. Then create projects, review outlines, write chapters, manage covers, check credits, and export finished books without changing tools.

Connect a client Browse 27 tools

Hosted server

https://mcp.ebookbrew.com/mcp

27tools

3export types

1credit balance

Start here

Connect a client

Add the server, confirm access in your browser, and return to your agent. Your password is never shared with the MCP client.

01
Add
Add the hosted server to your MCP client.
02
Confirm
Sign in and review the requested access.
03
Brew
Ask your agent to list or create a book.

Claude Code

Run one command in your terminal.

claude mcp add --transport http ebookbrew https://mcp.ebookbrew.com/mcp

Codex

Run one command in your terminal.

codex mcp add ebookbrew --url https://mcp.ebookbrew.com/mcp

Cursor

Add this object in Cursor MCP settings.

{
  "mcpServers": {
    "ebookbrew": {
      "url": "https://mcp.ebookbrew.com/mcp"
    }
  }
}

Other clients

Choose a custom remote MCP server and enter this address.

https://mcp.ebookbrew.com/mcp

If your client does not support remote MCP servers, run npx ebookbrew-mcp login once. Then configure npx -y ebookbrew-mcp as a local server.

Try a prompt

Start with intent, not tool names

A capable agent can choose the right EBookBrew tools. State what you want, where approval is needed, and when the agent must stop.

List my books and tell me what is incomplete.
Create a workbook for new managers. Show me the outline before you approve it.
Write chapters 1 and 2 only. Report the credit use after each chapter.
Make a minimal cover, activate it, and export the book as EPUB.

Clear controls

Costs and safety

Safe retries

Every change needs an idempotency key. Reuse a key only for the same attempted action.

No MCP fee

Tool calls are free. Generation uses the normal price: brief 2, text chapter 1, coloring page 2, and cover 3 credits.

Free exports

PDF, EPUB, and DOCX exports are free after the account buys a plan or credit pack.

Reference

All MCP tools

Each tool has structured input and output. Errors return a stable code and a safe message.

27 tools

list_projects

Free

List EBookBrew projects

Use this when the user wants to find or review their EBookBrew projects. Do not use it to create or change a project.

Scope: read

Example input

{
  "page": 1,
  "pageSize": 20
}

Example output

{
  "projects": [],
  "page": 1,
  "pageSize": 20,
  "total": 0,
  "hasMore": false
}

get_project

Free

Get an EBookBrew project

Scope: read

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111"
}

Example output

{
  "project": {
    "id": "11111111-1111-4111-8111-111111111111",
    "concept": "A guide to quiet launches",
    "format": "guide",
    "audience": null,
    "tone": null,
    "status": "draft",
    "headingPageBreak": "none",
    "interiorTheme": "classic",
    "pageSize": "a5",
    "designFont": "source-serif",
    "textColor": "ink",
    "fontSize": null,
    "lineHeight": null,
    "title": null,
    "writeAll": {
      "active": false,
      "stopReason": null
    },
    "createdAt": "2026-08-23T12:00:00.000Z",
    "updatedAt": "2026-08-23T12:00:00.000Z"
  },
  "brief": null,
  "chapters": [],
  "covers": [],
  "exports": []
}

get_chapter

Free

Get one EBookBrew chapter

Use this when the user or agent needs the full text or page image for one chapter position.

Scope: read

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 1
}

Example output

{
  "chapter": {
    "id": "33333333-3333-4333-8333-333333333333",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "position": 1,
    "kind": "chapter",
    "title": "Start small",
    "summary": "Define a narrow promise",
    "guidance": null,
    "content": "# Start small\n\nA focused launch begins...",
    "imageUrl": null,
    "version": 1,
    "wordCount": 820,
    "status": "done"
  }
}

create_project

Free

Create an EBookBrew project

Use this when the user has a book concept and wants a new EBookBrew project. This saves the concept only; call generate_brief next to create an outline.

Scope: generate

Example input

{
  "concept": "A practical guide to quiet product launches",
  "format": "guide",
  "audience": "solo founders",
  "tone": "calm and direct",
  "idempotencyKey": "launch-guide-001"
}

Example output

{
  "project": {
    "id": "11111111-1111-4111-8111-111111111111",
    "concept": "A practical guide to quiet product launches",
    "format": "guide",
    "audience": "solo founders",
    "tone": "calm and direct",
    "status": "draft",
    "headingPageBreak": "none",
    "interiorTheme": "classic",
    "pageSize": "a5",
    "designFont": "source-serif",
    "textColor": "ink",
    "fontSize": null,
    "lineHeight": null,
    "title": null,
    "writeAll": {
      "active": false,
      "stopReason": null
    },
    "createdAt": "2026-08-23T12:00:00.000Z",
    "updatedAt": "2026-08-23T12:00:00.000Z"
  }
}

update_project

Free

Update an EBookBrew project

Use this to change the source concept, format, audience, or tone before a brief exists. After brief generation, update the brief instead so the plan and manuscript stay consistent.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "audience": "first-time founders",
  "tone": "concise",
  "idempotencyKey": "project-edit-001"
}

Example output

{
  "project": {
    "id": "11111111-1111-4111-8111-111111111111",
    "concept": "A practical guide to quiet product launches",
    "format": "guide",
    "audience": "solo founders",
    "tone": "calm and direct",
    "status": "draft",
    "headingPageBreak": "none",
    "interiorTheme": "classic",
    "pageSize": "a5",
    "designFont": "source-serif",
    "textColor": "ink",
    "fontSize": null,
    "lineHeight": null,
    "title": null,
    "writeAll": {
      "active": false,
      "stopReason": null
    },
    "createdAt": "2026-08-23T12:00:00.000Z",
    "updatedAt": "2026-08-23T12:00:00.000Z"
  }
}

archive_project

Free

Remove an EBookBrew project from the library

Use this only when the user asks to remove a project from their library. This archives the project and blocks access, but keeps its data and audit records.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "idempotencyKey": "archive-project-001"
}

Example output

{
  "archived": true,
  "projectId": "11111111-1111-4111-8111-111111111111"
}

generate_brief

2 credits

Generate an EBookBrew brief

Use this when a project needs its first title options, chapter plan, and writing brief. Do not call it after approval; use update_brief for later changes.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "targetChapterCount": 12,
  "idempotencyKey": "brief-001"
}

Example output

{
  "brief": {
    "id": "22222222-2222-4222-8222-222222222222",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "title": "The Quiet Launch",
    "titleOptions": [
      "The Quiet Launch",
      "Launch Without Noise",
      "Small Audience, Strong Launch"
    ],
    "subtitle": "A practical guide for solo founders",
    "authorName": null,
    "targetWordCount": 9000,
    "chapterPlan": [],
    "approvedAt": null
  }
}

update_brief

Free

Update an EBookBrew brief

Use this when the user wants to edit the title, author, word count, or chapter plan before or after approval. This can invalidate an active cover when title data changes.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "title": "The Quiet Launch",
  "subtitle": "Launch well without a large audience",
  "authorName": "A. Writer",
  "targetWordCount": 9000,
  "chapterPlan": [
    {
      "position": 1,
      "title": "Start small",
      "summary": "Define a narrow promise",
      "guidance": null
    }
  ],
  "idempotencyKey": "brief-edit-001"
}

Example output

{
  "brief": {
    "id": "22222222-2222-4222-8222-222222222222",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "title": "The Quiet Launch",
    "titleOptions": [],
    "subtitle": "Launch well without a large audience",
    "authorName": "A. Writer",
    "targetWordCount": 9000,
    "chapterPlan": [],
    "approvedAt": null
  }
}

approve_brief

Free

Approve an EBookBrew brief

Use this only after the user accepts the title and chapter plan. Approval creates the chapter records and opens chapter writing.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "title": "The Quiet Launch",
  "subtitle": "Launch well without a large audience",
  "authorName": "A. Writer",
  "targetWordCount": 9000,
  "chapterPlan": [
    {
      "position": 1,
      "title": "Start small",
      "summary": "Define a narrow promise",
      "guidance": null
    }
  ],
  "idempotencyKey": "brief-approve-001"
}

Example output

{
  "approved": true,
  "projectId": "11111111-1111-4111-8111-111111111111"
}

write_chapter

1 credit (2 credits for a coloring_book page)

Write an EBookBrew chapter

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 1,
  "idempotencyKey": "chapter-1-write-001"
}

Example output

{
  "chapter": {
    "id": "33333333-3333-4333-8333-333333333333",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "position": 1,
    "kind": "chapter",
    "title": "Start small",
    "summary": "Define a narrow promise",
    "guidance": null,
    "content": "# Start small\n\nA focused launch begins...",
    "imageUrl": null,
    "version": 1,
    "wordCount": 820,
    "status": "done"
  }
}

write_all

1 credit per chapter (2 credits per coloring_book page), charged as each chapter starts

Write every pending EBookBrew chapter

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "idempotencyKey": "write-all-001"
}

Example output

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "queuedChapterCount": 8
}

stop_write_all

Free

Stop EBookBrew write-all

Use this when the user asks to stop an active write-all run. The current chapter can finish, but no later chapter will start.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "idempotencyKey": "stop-write-all-001"
}

Example output

{
  "stopped": true,
  "projectId": "11111111-1111-4111-8111-111111111111"
}

regenerate_chapter

1 credit (2 credits for a coloring_book page)

Regenerate an EBookBrew chapter

Use this when the user wants another version of an existing chapter. Include concrete revision guidance when the user gave it. In a coloring_book project this redraws the page and costs 2 credits.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 1,
  "revisionGuidance": "Add one concrete example and shorten the opening.",
  "idempotencyKey": "chapter-1-revise-001"
}

Example output

{
  "chapter": {
    "id": "33333333-3333-4333-8333-333333333333",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "position": 1,
    "kind": "chapter",
    "title": "Start small",
    "summary": "Define a narrow promise",
    "guidance": null,
    "content": "# Start small\n\nStart with one reader...",
    "imageUrl": null,
    "version": 2,
    "wordCount": 790,
    "status": "done"
  }
}

list_chapter_versions

Free

List saved EBookBrew chapter versions

Use this before restoring an earlier generated chapter or coloring page. It returns version IDs and revision notes, but not duplicate manuscript text.

Scope: read

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 1
}

Example output

{
  "versions": [
    {
      "id": "66666666-6666-4666-8666-666666666666",
      "version": 2,
      "revisionGuidance": "Shorten the opening.",
      "createdAt": "2026-08-23T12:30:00.000Z"
    }
  ]
}

restore_chapter_version

Free

Restore an EBookBrew chapter version

Use this only when the user chooses an earlier saved version. It makes that version the current chapter without deleting any saved versions.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 1,
  "versionId": "66666666-6666-4666-8666-666666666666",
  "idempotencyKey": "restore-chapter-001"
}

Example output

{
  "chapter": {
    "id": "33333333-3333-4333-8333-333333333333",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "position": 1,
    "kind": "chapter",
    "title": "Start small",
    "summary": "Define a narrow promise",
    "guidance": null,
    "content": "# Start small\n\nStart with one reader...",
    "imageUrl": null,
    "version": 2,
    "wordCount": 790,
    "status": "done"
  }
}

update_chapter

Free

Update an EBookBrew chapter

Use this when the user supplies manual chapter edits or metadata changes. This overwrites the current editable chapter, so do not call it without the user's replacement text or requested changes.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 1,
  "content": "# Start small\n\nEdited chapter text.",
  "idempotencyKey": "chapter-1-edit-001"
}

Example output

{
  "chapter": {
    "id": "33333333-3333-4333-8333-333333333333",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "position": 1,
    "kind": "chapter",
    "title": "Start small",
    "summary": "Define a narrow promise",
    "guidance": null,
    "content": "# Start small\n\nEdited chapter text.",
    "imageUrl": null,
    "version": 1,
    "wordCount": 6,
    "status": "done"
  }
}

add_manual_content

Free

Add manual EBookBrew content

Use this when the user wants to insert authored text into an approved manuscript. A manual chapter is numbered; a section is unnumbered and uses only its title.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "kind": "section",
  "title": "Credits",
  "position": 9,
  "idempotencyKey": "credits-001"
}

Example output

{
  "chapter": {
    "id": "55555555-5555-4555-8555-555555555555",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "position": 9,
    "kind": "section",
    "title": "Credits",
    "summary": "",
    "guidance": null,
    "content": "",
    "imageUrl": null,
    "version": 0,
    "wordCount": 0,
    "status": "draft"
  }
}

delete_content

Free

Delete EBookBrew content

Use this only when the user asks to permanently delete a chapter or section and its saved versions. At least one manuscript item must remain.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 9,
  "idempotencyKey": "delete-credits-001"
}

Example output

{
  "deleted": true,
  "projectId": "11111111-1111-4111-8111-111111111111",
  "position": 9
}

generate_cover

3 credits

Generate an EBookBrew cover

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "prompt": "One paper boat crossing a calm dark lake",
  "style": "minimal",
  "idempotencyKey": "cover-001"
}

Example output

{
  "cover": {
    "id": "44444444-4444-4444-8444-444444444444",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "imageUrl": "https://example.public.blob.vercel-storage.com/cover.jpg",
    "promptUsed": "One paper boat...",
    "editable": true,
    "style": "minimal",
    "direction": "One paper boat crossing a calm dark lake",
    "textSettings": {
      "font": "serif",
      "fade": 0.6,
      "title": {
        "scale": 1,
        "color": "#FFFFFF",
        "alignment": "left"
      },
      "subtitle": {
        "scale": 1,
        "color": "#FFFFFF"
      },
      "author": {
        "scale": 1,
        "color": "#FFFFFF",
        "alignment": "left"
      },
      "titlePosition": {
        "x": 0.1,
        "y": 0.11
      },
      "authorPosition": {
        "x": 0.1,
        "y": 0.88
      }
    },
    "trim": "1600x2560",
    "isActive": true,
    "createdAt": "2026-08-23T12:00:00.000Z"
  }
}

update_cover_text

Free

Update EBookBrew cover text

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "coverId": "44444444-4444-4444-8444-444444444444",
  "textSettings": {
    "font": "sans",
    "fade": 0.6,
    "title": {
      "scale": 1.1,
      "color": "#F6EEE1",
      "alignment": "center"
    },
    "subtitle": {
      "scale": 1,
      "color": "#F6EEE1"
    },
    "author": {
      "scale": 1,
      "color": "#E8C46A",
      "alignment": "center"
    },
    "titlePosition": {
      "x": 0.5,
      "y": 0.12
    },
    "authorPosition": {
      "x": 0.5,
      "y": 0.88
    }
  },
  "idempotencyKey": "cover-text-001"
}

Example output

{
  "cover": {
    "id": "44444444-4444-4444-8444-444444444444",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "imageUrl": "https://example.public.blob.vercel-storage.com/cover.jpg",
    "promptUsed": "One paper boat...",
    "editable": true,
    "style": "minimal",
    "direction": "One paper boat crossing a calm dark lake",
    "textSettings": {
      "font": "serif",
      "fade": 0.6,
      "title": {
        "scale": 1,
        "color": "#FFFFFF",
        "alignment": "left"
      },
      "subtitle": {
        "scale": 1,
        "color": "#FFFFFF"
      },
      "author": {
        "scale": 1,
        "color": "#FFFFFF",
        "alignment": "left"
      },
      "titlePosition": {
        "x": 0.1,
        "y": 0.11
      },
      "authorPosition": {
        "x": 0.1,
        "y": 0.88
      }
    },
    "trim": "1600x2560",
    "isActive": true,
    "createdAt": "2026-08-23T12:00:00.000Z"
  }
}

activate_cover

Free

Activate an EBookBrew cover

Use this when the user chooses one existing cover version for export. Editable covers are re-rendered with the current book title before activation.

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "coverId": "44444444-4444-4444-8444-444444444444",
  "idempotencyKey": "activate-cover-001"
}

Example output

{
  "cover": {
    "id": "44444444-4444-4444-8444-444444444444",
    "projectId": "11111111-1111-4111-8111-111111111111",
    "imageUrl": "https://example.public.blob.vercel-storage.com/cover.jpg",
    "promptUsed": "One paper boat...",
    "editable": true,
    "style": "minimal",
    "direction": "One paper boat crossing a calm dark lake",
    "textSettings": {
      "font": "serif",
      "fade": 0.6,
      "title": {
        "scale": 1,
        "color": "#FFFFFF",
        "alignment": "left"
      },
      "subtitle": {
        "scale": 1,
        "color": "#FFFFFF"
      },
      "author": {
        "scale": 1,
        "color": "#FFFFFF",
        "alignment": "left"
      },
      "titlePosition": {
        "x": 0.1,
        "y": 0.11
      },
      "authorPosition": {
        "x": 0.1,
        "y": 0.88
      }
    },
    "trim": "1600x2560",
    "isActive": true,
    "createdAt": "2026-08-23T12:00:00.000Z"
  }
}

update_design

Free

Update an EBookBrew book design

Scope: generate

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "theme": "elegant",
  "pageSize": "trade",
  "font": "traditional-serif",
  "textColor": "espresso",
  "idempotencyKey": "design-001"
}

Example output

{
  "project": {
    "id": "11111111-1111-4111-8111-111111111111",
    "concept": "A practical guide to quiet product launches",
    "format": "guide",
    "audience": "solo founders",
    "tone": "calm and direct",
    "status": "writing",
    "headingPageBreak": "none",
    "interiorTheme": "elegant",
    "pageSize": "trade",
    "designFont": "traditional-serif",
    "textColor": "espresso",
    "fontSize": null,
    "lineHeight": null,
    "title": "The Quiet Launch",
    "writeAll": {
      "active": false,
      "stopReason": null
    },
    "createdAt": "2026-08-23T12:00:00.000Z",
    "updatedAt": "2026-08-23T12:00:00.000Z"
  }
}

export_book

Free; paid account required

Export an EBookBrew book

Scope: export

Example input

{
  "projectId": "11111111-1111-4111-8111-111111111111",
  "kind": "epub",
  "idempotencyKey": "export-epub-001"
}

Example output

{
  "exportId": "77777777-7777-4777-8777-777777777777",
  "kind": "epub",
  "filename": "weekend-sourdough.epub",
  "url": "https://ebookbrew.com/api/books/11111111-1111-4111-8111-111111111111/exports/epub",
  "cached": false
}

create_checkout

Free

Create an EBookBrew checkout link

Use this when the user asks to buy a plan or credit pack. Return the secure link and let the user finish payment in their browser.

Scope: generate

Example input

{
  "purchase": "subscription",
  "plan": "pour_over",
  "idempotencyKey": "checkout-plan-001"
}

Example output

{
  "url": "https://checkout.example.com/session"
}

get_billing_portal_link

Free

Create an EBookBrew billing link

Use this when the user asks to manage a plan, payment method, invoices, or cancellation. Return the secure link and let the user make billing changes in their browser.

Scope: generate

Example input

{
  "idempotencyKey": "billing-portal-001"
}

Example output

{
  "url": "https://billing.example.com/session"
}

get_balance

Free

Get EBookBrew credit balance

Use this when the user asks about credits, plan status, renewal, or export access. Use create_checkout or get_billing_portal_link only when the user asks to take a billing action.

Scope: read

Example input

{}

Example output

{
  "credits": 25,
  "downloadsUnlocked": false,
  "hasActiveSubscription": false,
  "plan": null,
  "subscriptionCreditsExpireAt": null,
  "pricingUrl": "https://ebookbrew.com/pricing",
  "billingUrl": "https://ebookbrew.com/settings/billing"
}

get_generations

Free

Get EBookBrew generation history

Use this when the user wants their recent brief, chapter, or cover generation status and credit use. Do not use it to read agent request logs.

Scope: read

Example input

{
  "limit": 25
}

Example output

{
  "generations": []
}

Ready to connect?

Open MCP settings to control access and review activity.

Open MCP settings

Make a complete book from your agent

Connect a client

Add

Confirm

Brew

Claude Code

Codex

Cursor

Other clients

Start with intent, not tool names

Costs and safety

Safe retries

No MCP fee

Free exports

All MCP tools

list_projects

List EBookBrew projects

Example input

Example output

get_project

Get an EBookBrew project

Example input

Example output

get_chapter

Get one EBookBrew chapter

Example input

Example output

create_project

Create an EBookBrew project

Example input

Example output

update_project

Update an EBookBrew project

Example input

Example output

archive_project

Remove an EBookBrew project from the library

Example input

Example output

generate_brief

Generate an EBookBrew brief

Example input

Example output

update_brief

Update an EBookBrew brief

Example input

Example output

approve_brief

Approve an EBookBrew brief

Example input

Example output

write_chapter

Write an EBookBrew chapter

Example input

Example output

write_all

Write every pending EBookBrew chapter

Example input

Example output

stop_write_all

Stop EBookBrew write-all

Example input

Example output

regenerate_chapter

Regenerate an EBookBrew chapter

Example input

Example output

list_chapter_versions

List saved EBookBrew chapter versions

Example input

Example output

restore_chapter_version

Restore an EBookBrew chapter version

Example input

Example output

update_chapter

Update an EBookBrew chapter

Example input

Example output

add_manual_content