Skip to main content
Built&Written
Log inBuild my book

Built&Written Agent API

Agent API reference

Use the Agent API when an external agent, IDE, or custom workflow needs a fixed Bearer token instead of the OAuth-based MCP connector. For Claude and most MCP clients, start with the guided MCP setup.

MCP setupManage API keys
Base URL
https://www.builtwritten.com
Authentication
Authorization: Bearer <token>

Core endpoints

GET
/api/v1/agent/books

List books available to the authenticated account.

POST
/api/v1/agent/books

Create a new book project from a title, author, and source brief.

GET
/api/v1/agent/books/{bookId}

Inspect book status, structure, sharing state, and export readiness.

POST
/api/v1/agent/books/{bookId}/generate

Start full-book generation as a background job.

GET
/api/v1/agent/jobs/{jobId}

Check the progress of a long-running generation or export job.

POST
/api/v1/agent/books/{bookId}/exports/pdf

Generate a KDP-ready PDF export for a completed book.

POST
/api/v1/agent/books/{bookId}/share

Enable or disable a public share link for a completed book.