PDF Page Numbers

Overview

Numbers are drawn in Helvetica as real PDF text, so the rest of the document is untouched. Rotated pages are handled, so the number sits in the chosen corner the right way up as the page is displayed. Each call accepts one PDF of up to 10 MB and 300 pages.

Live Test PDF Page Numbers Skill →

The tool

Once your client is connected to the VerveKit server, this appears in its tool list as PDFPageNumbers. It is read-only and open-world — it fetches and never mutates anything on your side — so most clients call it without asking you to confirm.

Tool call

{
  "name": "PDFPageNumbers",
  "arguments": {}
}

Connecting

One server URL covers every skill in the catalog, including this one. Authorization is OAuth: the client opens a browser once, and there is no key to paste into a config file.

{
  "mcpServers": {
    "vervekit": {
      "url": "https://api.vervekit.com/v1/mcp"
    }
  }
}

Per-client setup — Claude, Cursor, VS Code, ChatGPT — is on the MCP setup page.

Arguments

These are the properties on the tool's inputSchema, so a well-behaved client validates them before the call is made. Premium arguments are accepted on every plan but only take effect on plans that include them.

Argument	Type	Description
`pdf`Optional	string	The PDF file to number (up to 10 MB and 300 pages), or a public PDF URL url
`position`Optional	string	Where to place the number `bottom-centerbottom-rightbottom-lefttop-centertop-righttop-left` default bottom-center
`fontSize`Optional	number	Font size in points, from 6 to 36 default 10 · range 6–36
`format`OptionalPremium	string	Label template containing {page}, and optionally {total}, such as Page {page} of {total}
`startAt`OptionalPremium	integer	Number for the first numbered page range 0–100000
`skipFirst`OptionalPremium	boolean	Leave the first page (a cover) unnumbered

What the model gets back

The result carries a structuredContent object matching the tool's declared outputSchema, so a client reads fields without parsing prose. status is "ok" and error is null on success; a null field means the value was not available for that input, not that the call failed.

Result

{
  "status": "ok",
  "error": null,
  "data": {
    "pdfName": "5c9f95f9-9719-47c3-a923-be3bc1f1dc91.pdf",
    "pageCount": 2,
    "numberedPages": 2,
    "position": "bottom-center",
    "format": "Page {page} of {total}",
    "startAt": 1,
    "lastLabel": "Page 2 of 2",
    "size": 6218,
    "expires": 1792230037933,
    "downloadURL": "https://storage.googleapis.com/apiverve/APIData/pdfpagenumbers/5c9f95f9-9719-47c3-a923-be3bc1f1dc91.pdf?GoogleAccessId=635500398038-compute%40developer.gserviceaccount.com&Expires=1792230037&Signature=a2sCOtSuSIIEWobe8wq5iHcCdqlJMXhrHE9ewxXsf7qrNBK3NHtxrQYk%2Fn1Jpr08aQBVtJclbKX6CFqRigV2IL4suv%2F%2B8WF9LRX%2BhY%2Frhvkw9RfdydlsvALhpPxnxv547eShgBIsuwvEOPFry%2F1J%2FCvt3X%2BT8Iwpz9EtJJVKH8C3u8u26%2FlNjj7XcRCqx6hcVIWvkJEVuZfMQUjlcbtF4IOwvITwlIQW9ChPzMIlXdXu2amBIy9PinQoKsdVopBfTre4W%2BTH6%2BgynWlvnJAHmxM6mWdfLQxTjCyFzdT4ZmJuq%2BRM36d41N62KxiTGyP1cs0YJECt36nI3a7FTzUOrA%3D%3D"
  }
}

Response fields

Paths are relative to data. Premium fields are absent rather than zeroed on plans that do not include them, so check for presence instead of comparing to 0.

Field	Type	Example	Description
`pdfName`	string	`5c9f95f9-9719-47c3-a923-be3bc1f1dc91.pdf`	File name of the numbered PDF
`pageCount`	number	`2`	Pages in the PDF
`numberedPages`	number	`2`	Pages that received a number
`position`	string	`bottom-center`	Where the numbers were placed
`format`	string	`Page {page} of {total}`	The label template used
`startAt`	number	`1`	The number given to the first numbered page
`lastLabel`	string	`Page 2 of 2`	The label on the last page, such as Page 12 of 12
`size`	number	`6218`	Size of the numbered PDF in bytes
`expires`	number	`1792230037933`	When the download link expires (Unix time in milliseconds)
`downloadURL`	string	`https://storage.googleapis.com/apiverve/APIData/pdfpagenumbers/5c9f95f9-9719-47c3-a923-be3bc1f1dc91.…`	Signed link to download the numbered PDF, valid for 2 days

Failure modes

Errors come back as tool errors carrying a sentence the model can act on, not a bare status code. Error handling covers the full list.

Status	What it means
`400` / `422`	The arguments did not validate. The message names the offending one.
`401`	The OAuth session is invalid or expired — reconnect the server.
`403`	Blocked by a key restriction or an IP allow-list. Never a bad identity.
`404`	This skill is not part of VerveKit. Check the catalog.
`429`	Out of credits, or a brief rate limit. The message tells them apart.

A call costs 10 credits each time the tool actually runs; a model that reasons about the tool without calling it costs nothing.

Use cases

Generated Reports: Number the pages of reports and exports produced by other tools that leave them unnumbered.
Legal and Compliance: Add Page X of Y labels to contracts and filings before they are signed or submitted.
Merged Documents: Number a document after merging several PDFs so the combined file reads as one.
Print and Publishing: Paginate manuscripts, handouts and booklets, skipping the cover page.

Other ways to use PDF Page Numbers

Set up PDF Page Numbers on VerveKit, or reach the same source a different way. Your VerveKit account and credits work on all of them — one key, one balance.

Call it as a REST APIOne HTTPS endpoint and an x-api-key header, with SDKs for Node, Python and .NET.APIVerve →Reference →