Pdf Page Numbers

Documents REST API MCP network tool

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 MCP tool findutils:pdf_page_numbers. See the REST reference →

This tool fetches a fixed, hard-coded public upstream — never a private host. Results depend on that upstream.

Use in the browser View as Markdown

Call it over MCP

Tool name findutils:pdf_page_numbers · no API keys · 120 requests/min per IP

Claude Code

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

Claude Desktop — claude_desktop_config.json

{
  "mcpServers": {
    "findutils": {
      "url": "https://mcp.findutils.com/"
    }
  }
}

Raw JSON-RPC (any MCP client) — verified example

curl -X POST https://mcp.findutils.com/ \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "pdf_page_numbers",
      "arguments": {
        "pdf": "JVBERi0xLjcK",
        "position": "bottom-center",
        "format": "Page {n} of {total}"
      }
    }
  }'

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)

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

Also a REST endpoint

The same tool answers plain HTTP at POST /api/tools/pdf-page-numbers/execute — no key, 60 requests/min.

Open the REST reference for Pdf Page Numbers →

Call it over MCP

Input schema

Also a REST endpoint

More Documents tools