API & MCP docs

Drive the whole pipeline programmatically.

The same ~64 MCP tools that power the Chaptrix agent are open to you via a REST API, an MCP server and webhooks.

Authentication

All requests go over HTTPS and are authenticated with a bearer token. Create keys on the Studio tier under Settings → API. Treat them like passwords — a key carries the full rights of its workspace.

request.sh

curl https://api.chaptrix.com/v1/books \
  -H "Authorization: Bearer $CHAPTRIX_KEY" \
  -H "Content-Type: application/json"

API access is part of the Studio plan. Keys are workspace-scoped and revocable at any time.

Quickstart

Validate a niche and, on a green score, kick off manuscript generation — in a few lines.

quickstart.py

from chaptrix import Chaptrix
 
cx = Chaptrix(api_key=os.environ["CHAPTRIX_KEY"])
 
score = cx.validate_niche(topic="Deep Work für Teams")
if score.decision == "write":
    book = cx.generate_manuscript(
        topic=score.topic, voice="me")
    print(book.id, book.status)

MCP tool reference

Every phase of the pipeline is a callable tool. A selection of the most important:

Tool

Phase

Description

validate_niche

Validate

Checks a topic against Keepa/BSR and returns a viability score.

generate_manuscript

Write

Generates the manuscript from sources and author voice.

typeset_chapter

Design

Typesets a chapter print-ready (Typst).

design_cover

Design

Generates a cover with pixel parity and EAN-13.

verify_citations

Verify

Verifies citations against Crossref and OpenAlex.

export_book

Verify

Exports EPUB3, print PDF, PDF/UA and PDF/A.

generate_audiobook

Audio

Produces an audiobook with AI voices in many languages.

launch_marketing

Market

Derives 200+ assets and a launch calendar.

Webhooks

manuscript.completed

Manuscript finished generating.

typeset.completed

Typesetting done, export ready.

cover.ready

Cover render available.

export.ready

EPUB/PDF ready to download.

Errors & limits

The API uses standard HTTP status codes. Rate limits are computed per workspace and returned in response headers.

401Invalid or missing API key.

402AI budget exhausted — top up in the workspace.

429Rate limit hit — honor Retry-After.

5xxServer error — retry with exponential backoff.

Ready to build headless?

Studio unlocks API keys, the MCP server and webhooks.

Contact sales

Authentication

request.sh

curl https://api.chaptrix.com/v1/books \
  -H "Authorization: Bearer $CHAPTRIX_KEY" \
  -H "Content-Type: application/json"

API access is part of the Studio plan. Keys are workspace-scoped and revocable at any time.

Quickstart

Validate a niche and, on a green score, kick off manuscript generation — in a few lines.

quickstart.py

from chaptrix import Chaptrix
 
cx = Chaptrix(api_key=os.environ["CHAPTRIX_KEY"])
 
score = cx.validate_niche(topic="Deep Work für Teams")
if score.decision == "write":
    book = cx.generate_manuscript(
        topic=score.topic, voice="me")
    print(book.id, book.status)

MCP tool reference

Every phase of the pipeline is a callable tool. A selection of the most important:

Tool

Phase

Description

validate_niche

Validate

Checks a topic against Keepa/BSR and returns a viability score.

generate_manuscript

Write

Generates the manuscript from sources and author voice.

typeset_chapter

Design

Typesets a chapter print-ready (Typst).

design_cover

Design

Generates a cover with pixel parity and EAN-13.

verify_citations

Verify

Verifies citations against Crossref and OpenAlex.

export_book

Verify

Exports EPUB3, print PDF, PDF/UA and PDF/A.

generate_audiobook

Audio

Produces an audiobook with AI voices in many languages.

launch_marketing

Market

Derives 200+ assets and a launch calendar.