# Paperwell PDF Page Planner

> Plan a PDF merge, split, reorder, removal or rotation and see every resulting page first. Resolves page selections such as "1-3,5,8-end", "odd" or "10-1" against the page counts of your PDFs and lists the exact output files and page sequences of a merge, split, reorder, removal or rotation — before any file is uploaded. It returns the parameters for the pdf-merge-split-reorder tool, so scripts and AI agents can check a plan first.

Part of usefulweb.site (https://usefulweb.site/). Results are deterministic calculations from the inputs and the listed assumptions; the API returns exactly what the web page shows.

## Use it
- Human interface: https://paperwellpageplan.usefulweb.site/ (interactive tool at https://paperwellpageplan.usefulweb.site/tool)
- JSON API: POST https://paperwellpageplan.usefulweb.site/api/v1/calculate with a JSON object of inputs (schema: https://paperwellpageplan.usefulweb.site/api/v1/tool)
- OpenAPI: https://paperwellpageplan.usefulweb.site/openapi.json
- MCP (Streamable HTTP): https://paperwellpageplan.usefulweb.site/mcp - tool `paperwell_page_plan`

## Inputs
- mode (select): Operation
- files (table): PDFs (name and page count)
- order (text): Merge order - File numbers, e.g. "2,1,3". Files not listed follow in their original order.
- pages (text): Pages - Page numbers start at 1. Examples: "1-3,5,8-end", "odd", "even", "reverse", "10-1" (descending), "1-9:odd". Leave empty for all pages.
- everyN (integer): Pages per part (split every N)
- ranges (textarea): Ranges (split by ranges) - One part per range, separated by ";" or new lines, e.g. "1-3; 4-end".
- angle (select): Rotation

## Method
- Page selections use the syntax of the site’s PDF tools: numbers and ranges ("1-3,5"), "end"/"last", descending ranges ("10-1"), "reverse", "odd"/"even" and range filters ("1-9:odd"). Order and duplicates are kept for selecting/reordering; removal and rotation use the sorted set.
- Merging appends whole files in the given order; file numbers not listed keep their original order after the listed ones.
- Splitting creates one file per group of N pages or per range; output names follow the pdf-merge-split-reorder tool ("report-part-2-p4-6.pdf").
- The plan is computed from page counts only; no PDF is opened. The real tool re-checks everything against the files.