# Built&Written

Built&Written is an MCP server for writing non-fiction books in Claude, ChatGPT, and other clients: projects, chapters, voice, and KDP export.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add mykhailo-druz/builtwritten

# Browse available tools
npx -y smithery tool list mykhailo-druz/builtwritten

# Get full schema for a tool
npx -y smithery tool get mykhailo-druz/builtwritten list_books

# Call a tool
npx -y smithery tool call mykhailo-druz/builtwritten list_books '{}'
```

## Direct MCP Connection

Endpoint: `https://builtwritten--mykhailo-druz.run.tools`

## Tools (16)

- `list_books` — List all books in the user account.
- `get_book` — Get book metadata by ID.
- `update_book_metadata` — Update title, subtitle, author, ISBN.
- `get_structure` — Get chapter outline for a book.
- `update_structure` — Replace full chapter outline.
- `get_content` — Get subchapter text for one chapter.
- `patch_subchapter_content` — Replace one subchapter body.
- `start_generate` — Start AI generation job; returns job_id.
- `get_job_status` — Poll generation job status.
- `get_cover` — Get current cover state, preview URLs, cover notes, and cover generation metadata.
- `update_cover_design` — Update cover_editor_state JSON and/or cover_notes without rendering.
- `start_cover_generate` — Generate raw AI cover background art (step 1 of 3).
- `apply_cover_template` — Assemble the cover layout from generated art (step 2 of 3).
- `start_cover_render` — Render the final full cover with text/layout and return preview URLs (step 3 of 3).
- `view_cover_art` — Fetch either raw background art or the rendered full cover image for inspection.
- `evaluate_cover` — Evaluate raw art or rendered cover quality with AI vision.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get mykhailo-druz/builtwritten <tool-name>
```