# Simplebooklet

Simplebooklet is a SaaS platform that converts PDFs into hosted, interactive HTML flipbooks.
Upload a PDF and get back a permanent public URL at `simplebooklet.com` that anyone can
open in a browser to read the document as a page-turning flipbook — no downloads, no plugins.

## Upload API

AI agents and MCP tools can upload a PDF on a user's behalf and surface a URL for the user
to open in their browser. The user logs in (or creates a free account) and flipbook conversion
starts automatically.

### Two-step flow

1. **POST /api/api/upload** — multipart PDF upload, no auth required.
   Returns `{ "data": { "url": "https://simplebooklet.com/api/api/convert/{key}" } }`.
2. Surface the `url` to the user as a clickable button or link. The user opens it in their browser, signs in, and the
   flipbook is created. The finished flipbook appears in their Simplebooklet dashboard
   with a permanent public share URL.

### API reference

Full OpenAPI 3.1 spec: <https://simplebooklet.com/openapi.yaml>

### Example (curl)

```bash
curl -X POST https://simplebooklet.com/api/api/upload \
  -F "file=@my-document.pdf"
```

Response:

```json
{
  "status": "ok",
  "message": "File uploaded",
  "data": {
    "url": "https://simplebooklet.com/api/api/convert/aBcDeFgHiJkLmNoPqRsTuV"
  }
}
```

Open the `url` value in the user's browser to complete flipbook creation.

## Optional parameters

Append `?title=My+Booklet+Title` to the convert URL to pre-fill the flipbook title.

## MCP server (for AI agents)

Simplebooklet exposes a native MCP server at `https://simplebooklet.com/mcp` (HTTP transport,
no installation required). Register it in Claude settings:

```json
{ "mcpServers": { "simplebooklet": { "url": "https://simplebooklet.com/mcp" } } }
```

The MCP server exposes one tool: `create_simplebooklet(pdf_url, title?)` — downloads a PDF
from a public URL and returns the convert URL for the user to open in their browser.