# bookclaw-mcp

A Model Context Protocol (MCP) server that exposes [BookClaw](../bookclaw)'s
author workflow to MCP clients over Streamable HTTP. It is a thin, stateless
client of BookClaw's REST API — see `CLAUDE.md` and
`docs/superpowers/specs/2026-06-18-bookclaw-mcp-design.md`.

## Setup

```bash
npm install
cp .env.example .env   # fill in BOOKCLAW_AUTH_TOKEN and BOOKCLAW_MCP_TOKEN
npm start              # listens on http://127.0.0.1:3849/mcp
```

`BOOKCLAW_AUTH_TOKEN` is BookClaw's own token (from BookClaw's `.env`).
`BOOKCLAW_MCP_TOKEN` is a token you choose to gate this server.

## Tools

`bookclaw_status`, `list_books`, `get_book`, `create_book`, `set_active_book`,
`get_book_files`, `read_book_file`, `list_projects`, `get_project`,
`create_project`, `create_pipeline`, `advance_pipeline`, `get_project_files`,
`chat`, `compile_project`, `export_docx`, `list_library`, `get_library_entry`,
`list_endpoints`, `bookclaw_request` (escape hatch).

## Testing

```bash
npm test            # unit + smoke
npx tsc --noEmit    # type-check
```