> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spoolpdf.nandra.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# spoolpdf

> HTML or a public URL to PDF. Sign in, create a key, and call POST /v1/render.

spoolpdf is a hosted Chromium pipe. You send HTML or a public URL; you get a PDF. You do not operate Gotenberg.

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Sign in, create a `spool_live_…` key, render a first PDF.
  </Card>

  <Card title="POST /v1/render" icon="file-text" href="/api-reference/overview">
    Full request body, including sandbox, waits, cookies, and inject.
  </Card>

  <Card title="Node and PHP SDKs" icon="code" href="/guides/sdks">
    Official clients for `POST /v1/render`.
  </Card>

  <Card title="MCP" icon="bot" href="/guides/mcp">
    ChatGPT, Claude, or Cursor without pasting an API key.
  </Card>
</Columns>

## Environments

| What      | URL                                                |
| --------- | -------------------------------------------------- |
| App       | [spoolpdf.nandra.dev](https://spoolpdf.nandra.dev) |
| API       | `https://spoolpdf-api.nandra.dev`                  |
| MCP       | `https://mcp.spoolpdf.nandra.dev/mcp`              |
| Local API | `http://localhost:8080`                            |

## What you can pass

Exactly one of `html` or `url`. Optional Chromium controls:

* Paper: `format` (A0–A6, Letter, Legal, Tabloid, Ledger, `{width}x{height}`, `{width}xauto`), `paper_width` / `paper_height`, `landscape`, `single_page`
* Chrome: `margin`, `header`, `footer` (page number placeholders only)
* SPA waits: `wait_delay`, `wait_for_selector`, `wait_for_expression`, `wait_for_network_idle`
* Page load: `extra_http_headers`, `cookies`, `auth`, `raise_for_status`, `emulate_media`, `lazy_load_images`
* Inject: `css`, `javascript` (inline or public http(s) URL)
* Output: `pages`, `metadata`, `sandbox` (watermarked, does not increment usage)

See [Render PDF](/guides/html-to-pdf) and the [API overview](/api-reference/overview).