# Pdf Page Numbers — REST API endpoint `pdf-page-numbers`

Add page numbers to a PDF. The format string uses {n} for the page number and {total} for the count, so "Page {n} of {total}" and a bare "{n}" both work. Numbering can start at any value and can skip the first page, which is what a title page usually wants. Input and output are base64-encoded PDFs.

- Category: documents
- MCP server: https://mcp.findutils.com/ (Streamable HTTP, no API keys, 120 req/min per IP)
- REST endpoint: POST https://api.findutils.com/api/tools/pdf-page-numbers/execute (no API keys, 60 req/min per IP)
- Network tool: fetches a fixed, hard-coded public upstream (never a private host).
- Reference page: https://findutils.com/api/pdf-page-numbers/
- Same tool on the other surface: https://findutils.com/mcp/pdf-page-numbers/

## Call the endpoint (verified example)

```bash
curl -X POST https://api.findutils.com/api/tools/pdf-page-numbers/execute \
  -H "Content-Type: application/json" \
  -d '{
    "pdf": "JVBERi0xLjcK",
    "position": "bottom-center",
    "format": "Page {n} of {total}"
  }'

# Parameter schema
curl https://api.findutils.com/api/tools/pdf-page-numbers
```

## Input schema

| Argument | Type | Required | Description |
|---|---|---|---|
| `pdf` | string | yes | The base64-encoded PDF to number. |
| `position` | string (bottom-center \| bottom-right \| bottom-left \| top-center \| top-right \| top-left) | no | Where the number sits. Default: bottom-center. Default: `"bottom-center"`. |
| `start` | integer | no | The number the first numbered page gets. Default: 1. Default: `1`. |
| `format` | string | no | Template with {n} and {total}. Default: "{n}". Default: `"{n}"`. |
| `size` | number | no | Font size in points. Default: 10. Default: `10`. |
| `margin` | number | no | Distance from the page edge in points. Default: 28. Default: `28`. |
| `skip_first` | boolean | no | Leave page 1 unnumbered, for a title page. Default: false. Default: `false`. |

Example arguments (verified):

```json
{
  "pdf": "JVBERi0xLjcK",
  "position": "bottom-center",
  "format": "Page {n} of {total}"
}
```

OpenAPI 3.1 spec: https://findutils.com/api/openapi.json · Interactive docs: https://findutils.com/api/docs/

## Also an MCP tool

```bash
claude mcp add findutils --transport http https://mcp.findutils.com/
```

Then ask the client to call `findutils:pdf_page_numbers`. Full MCP reference: https://findutils.com/mcp/pdf-page-numbers/

---
Full catalog: GET https://api.findutils.com/api/tools · https://findutils.com/api/ · https://findutils.com/llms.txt