# Clic'n Done PDF

> PDF tools with an HTTP API: PDF to Word that keeps the layout, PDF/A (validated with veraPDF), merge, split, compress, OCR, redaction and more. Files are deleted 10 minutes after the first download (one hour at most). No account needed for the free plan.

## Use the API

1. `POST https://pdf.clicndone.com/jobs` (multipart/form-data): field `tool` (see below) and the file(s) in `file` or `files`; tool options as extra form fields. Answer: `202 {"id", "status"}`.
2. `GET https://pdf.clicndone.com/jobs/{id}` until `status` is `done` or `failed` (`error` says why).
3. `GET https://pdf.clicndone.com/jobs/{id}/download`: the result (DOCX, PDF, XLSX, JPG or ZIP).
4. `DELETE https://pdf.clicndone.com/jobs/{id}` when you have it (otherwise it is deleted 10 minutes after the first download, or after one hour).

```
curl -s -F tool=pdf-a-word -F file=@input.pdf https://pdf.clicndone.com/jobs
```

OpenAPI schema: https://pdf.clicndone.com/openapi.json. Errors are JSON `{"detail": ...}` (in Spanish). Every tool with its options, allowed values and defaults, as JSON: https://pdf.clicndone.com/tools.

## MCP server

To use the tools on local files from an AI assistant (Claude, Cursor…), there is a stdio MCP server in a single Python file, standard library only: https://pdf.clicndone.com/clicndone_pdf_mcp.py. Run it with `python clicndone_pdf_mcp.py`, or from PyPI with `uvx clicndone-pdf-mcp` (official MCP Registry: com.clicndone.pdf/pdf-tools); setup: https://pdf.clicndone.com/en/ai-assistants. There is also a remote MCP server (Streamable HTTP) at https://pdf.clicndone.com/mcp/v1: files go as public URLs or base64 and each tool returns a download link.

## Plans and limits

- Free, without a key: 200 pages and 50 MB per job, 30 jobs per hour and 150 per day per IP.
- Prepaid, with a key bought with x402: 1000 pages and 200 MB per job, 200 jobs per hour; each finished job spends its credits (table below).

## Pay with x402 (USDC, no account)

1. `POST https://pdf.clicndone.com/credits?credits=N` (N: one of 1000, 5000, 20000) answers `402` with the x402 v2 `PAYMENT-REQUIRED` header (base64 JSON): 1.00 USDC per 1000 credits on Base (`eip155:8453`), scheme `exact`.
2. Sign the payment with your wallet and repeat the request with the `PAYMENT-SIGNATURE` header. Answer: `{"key", "credits", "transaction"}` and the `PAYMENT-RESPONSE` header. The key is shown only once: keep it.
3. Send the key in `Authorization: Bearer <key>` (or `X-API-Key`) to `/jobs` and `/usage` (`balance`). With no credits left, `POST /jobs` answers `402`: buy more with the same key in `Authorization` to top it up.

## Tools (field `tool`)

| tool | what it does | credits | options (form fields) |
|---|---|---|---|
| `pdf-a-word` | Turn your PDFs into editable Word documents that look just like the original: same fonts, margins, tables, columns and images (1+ files) | 10 per file + 1 per page (at most 50 per file) | - |
| `unir-pdf` | Combine several PDFs into a single file, in the order you want, in a few seconds (2+ files) | 5 per file | - |
| `dividir-pdf` | Split a PDF into several: one page per file or the page ranges you choose (1 file) | 5 per file | `ranges` |
| `rotar-pdf` | Rotate the pages of your PDFs by 90, 180 or 270 degrees, all of them or only the ones you choose, and save them that way (1+ files) | 10 per file | `angle` (default `90`), `ranges` |
| `comprimir-pdf` | Shrink your PDFs to send them by email or upload them to a form, at the quality you choose (1+ files) | 10 per file | `level` (default `recomendada`) |
| `pdf-a-jpg` | Turn every page of your PDFs into a JPG image, at the resolution you need (1+ files) | 2 per page | `dpi` (default `150`) |
| `word-a-pdf` | Convert Word (DOCX, DOC), OpenDocument (ODT) and RTF documents into PDFs ready to send or print (1+ files) | 10 per file | - |
| `pdf-buscable` | Recognise the text in your scanned PDFs so you can search, select and copy it, without changing how they look (1+ files) | 5 per page | - |
| `comparar-pdf` | Upload two versions of a contract, report or tender, as PDF or Word, and we mark what was added and what was removed (2+ files) | 2 per page | - |
| `tachar-pdf` | Finds IDs, bank accounts, cards, phone numbers, emails, names and addresses and really redacts them: nothing is left under the black box (1+ files) | 3 per page | `categories`, `terms`, `mode` (default `tachar`) |
| `pdf-a-excel` | Turn the tables in a PDF into Excel, each in its own sheet and with numbers as numbers, ready to add up (1+ files) | 5 per page | `content` (default `tablas`) |
| `jpg-a-pdf` | Put photos, scans and screenshots (JPG, PNG, TIFF, WEBP…) into a single PDF, in the order you want and without losing quality (1+ files) | 1 per page | `size` (default `a4`), `margin` (default `no`) |
| `organizar-pdf` | Reorder the pages of a PDF by dragging them, rotate them or delete the ones you don't need, with every page shown as a thumbnail (1 file) | 5 per file | `pages` |
| `pdf-a-pdfa` | Convert your PDFs to PDF/A-2b, the long-term archiving format many registries and online government services ask for, without changing how they look (1+ files) | 2 per page | - |
| `numerar-pdf` | Number the pages of your PDFs: at the bottom or top, on one side or in the centre, and from the page and number you choose (1+ files) | 5 per file | `position` (default `abajo-centro`), `format` (default `n`), `start` (default `1`), `first` (default `1`) |
| `marca-agua-pdf` | Add a text such as “CONFIDENTIAL” or “Copy for the bank” to every page of your PDFs, diagonally or repeated, in the colour and strength you want (1+ files) | 5 per file | `text`, `layout` (default `diagonal`), `opacity` (default `media`), `color` (default `gris`) |

## Docs

- [Tools for people](https://pdf.clicndone.com/en/)
- [Privacy](https://pdf.clicndone.com/en/privacy)
- [Terms](https://pdf.clicndone.com/en/terms)
