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.
This page documents the HTTP endpoint POST /api/tools/pdf-page-numbers/execute. See the MCP reference →
This tool fetches a fixed, hard-coded public upstream — never a private host. Results depend on that upstream.
Call it over REST
POST https://api.findutils.com/api/tools/pdf-page-numbers/execute · no API keys · 60 requests/min per IP
Execute — verified arguments
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 for this endpoint
curl https://api.findutils.com/api/tools/pdf-page-numbersInput schema
| Argument | Type | Required | Description |
|---|---|---|---|
| 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)
{
"pdf": "JVBERi0xLjcK",
"position": "bottom-center",
"format": "Page {n} of {total}"
}Also an MCP tool
Claude, Cursor, and any MCP client can call this tool as
findutils:pdf_page_numbers after one connect command.
Connect once
claude mcp add findutils --transport http https://mcp.findutils.com/More Datetime tools
Age Calculate
Calculate age from a date of birth — years, months, days, plus totals in days, weeks, and months.
Career Experience Calculator
Calculate total professional experience across several jobs: total days, years/months/days, weeks, working days (5/7), working hours (8 per
Country Lookup
Return country facts — capital, currency (name, code, symbol), phone code, timezone, region, subregion, flag emoji, and languages — for coun
Cron Describe
Parse a 5-field cron expression (minute hour day-of-month month day-of-week) and produce a human-readable English description.
Cron To Systemd
Convert a 5-field cron expression into a systemd timer plus service unit and a Kubernetes CronJob YAML file.
Date Difference
Compute the difference between two dates in years/months/weeks/days/hours/minutes/seconds.
Date Difference Calculator
Calculate the difference between two dates in various units.
Pdf Delete Pages
Remove pages from a PDF and return the rest in their original order.