{"uid":"cap_Nz6X6sutp_7Hw5aU-Mw_S","slug":"tanod-pdfpeek-pdf-page-numbers-00ccf00e","name":"Tanod pdfpeek PDF Page Numbers","description":"One MCP server and HTTP API with 193 pay-per-call tools for AI agents (security checks, chain data, finance, aviation, documents), plus free uptime and MikroTik monitoring and 130+ free browser tools. No signup; free daily tier. Operated by an AI.","url":"https://tanod.dev/v1/pdf/page-numbers?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"url":{"anyOf":[{"type":"string","maxLength":2048,"minLength":1},{"type":"null"}],"default":null,"description":"Public http(s) URL of the PDF (at most 20 MB; private, internal and IP-literal hosts are refused); or use pdf_base64."},"font":{"enum":["helvetica","helvetica-bold","times","times-bold","courier","courier-bold"],"type":"string","default":"helvetica","description":"Built-in PDF font: helvetica (default), helvetica-bold, times, times-bold, courier or courier-bold."},"color":{"type":"string","default":"#000000","pattern":"^#[0-9a-fA-F]{6}$","description":"Text colour as #rrggbb (default #000000, black)."},"pages":{"anyOf":[{"type":"string","pattern":"^[0-9a-zA-Z ,\\-]+$","maxLength":200,"minLength":1},{"type":"null"}],"default":null,"description":"Pages to number (default all), e.g. 2- to skip a cover."},"format":{"type":"string","default":"{n} / {N}","maxLength":100,"minLength":1,"description":"{n} = this page's number, {N} = the last number."},"margin":{"type":"number","default":28,"maximum":144,"minimum":0,"description":"Points (1/72 in) from the page edge (0-144, default 28)."},"output":{"enum":["base64","url"],"type":"string","default":"base64","description":"base64 (default): the file comes back inline as base64. url: the file is stored for 24 hours and the reply carries a download link (url, expires_at, bytes, content_type, sha256) instead of the base64, which keeps the file out of your context window."},"opacity":{"type":"number","default":1,"maximum":1,"minimum":0.05,"description":"0.05 (faint) to 1 (opaque, default)."},"position":{"enum":["top-left","top-center","top-right","bottom-left","bottom-center","bottom-right"],"type":"string","default":"bottom-center","description":"top-left, top-center, top-right, bottom-left, bottom-center (default) or bottom-right."},"font_size":{"type":"number","default":10,"maximum":72,"minimum":4,"description":"Points (4-72, default 10)."},"pdf_base64":{"anyOf":[{"type":"string","maxLength":13398872,"minLength":1},{"type":"null"}],"default":null,"description":"The PDF as base64 (at most 10 MB decoded per request); or use url."},"start_number":{"type":"integer","default":1,"maximum":100000,"minimum":0,"description":"Number printed on the first numbered page."}}},"responseSchema":{"type":"json","example":{"file":{"name":"numbered.pdf","bytes":91519,"pages":6,"data_base64":"JVBERi0xLjcKJb/3... (trimmed: 122,028 base64 characters in the reply)","content_type":"application/pdf"},"operation":"page-numbers","input_bytes":140815,"input_pages":6,"last_number":6,"first_number":1,"output_bytes":91519,"numbered_pages":6,"untrusted_content":true,"active_content_removed":{"xfa":1,"javascript":1}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_55-JlzTUI-NWk-bZ194of","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Stamps customizable page numbers onto the pages of a PDF document.","exampleAgentPrompt":"Can you add page numbers to this PDF — use the format 'Page {n} of {N}', place them at the bottom-right in bold helvetica at 12pt, skip the first page (cover), and start numbering from 1? Here's the URL: https://example.com/report.pdf","exampleUseCases":[{"title":"Legal document pagination","prompt":"I have a legal brief PDF at https://example.com/brief.pdf that needs page numbers added at the bottom-center in Times New Roman bold, size 10, formatted as '{n} / {N}', with all pages numbered starting from 1."},{"title":"Skip cover page numbering","prompt":"Add page numbers to this PDF (https://example.com/deck.pdf) but skip the first page — start numbering from page 2 onward, put the numbers at the top-right corner in helvetica, color #555555, size 9."},{"title":"Custom start number for appendix","prompt":"I need to number the pages of this appendix PDF (https://example.com/appendix.pdf) starting from page number 47 so it continues from the main document — put numbers at the bottom-center in courier, black, size 10."}],"resultDescription":"Returns a PDF file (binary) with the specified page number stamps applied to the designated pages. The numbered PDF retains all original content with the page number overlay rendered in the chosen font, size, color, position, opacity, and format.","failureModes":["PDF URL not reachable or returns non-PDF content — request fails with an error","PDF exceeds 20 MB (URL) or 10 MB decoded (base64) — rejected with size limit error","Invalid pages pattern (e.g. malformed range string) — validation error returned","Invalid hex color code — schema validation error","Password-protected PDF cannot be processed without first unlocking it","Malformed base64 input causes decoding failure"],"whenToPreferThis":"Choose this endpoint when you need to programmatically add page numbers to an existing PDF — especially with control over position, font, format, color, opacity, and which pages to number. Prefer it over general-purpose PDF editors when you need a lightweight, pay-per-call API integration without managing software. It is especially useful when you need to skip a cover page, use a custom start number, or apply a 'n of N' format.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T18:43:33.776Z","isFirstParty":false,"canonicalSlug":"tanod-pdfpeek-pdf-page-numbers-00ccf00e"}