{ "openapi": "3.1.1", "info": { "title": "Paperwell API", "version": "1.0.0", "summary": "Deterministic tools for people and AI agents.", "description": "Every endpoint performs the same calculation as the human page and returns inputs, result, units, assumptions, sources, warnings and computedAt. MCP endpoint: /mcp." }, "servers": [ { "url": "https://paperwell.usefulweb.app" } ], "paths": { "/api/v1/tools": { "get": { "operationId": "listTools", "summary": "Catalog of all tools", "responses": { "200": { "description": "Tool list.", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/api/v1/tools/{id}": { "get": { "operationId": "getTool", "summary": "Definition of one tool", "parameters": [ { "in": "path", "name": "id", "required": true, "schema": { "type": "string", "enum": [ "paperwell-notice-deadlines", "paperwell-page-plan", "paperwell-document-scan", "office-to-pdf-converter", "pdf-image-converter", "pdf-compressor", "pdf-form-signature-studio", "pdf-merge-split-reorder", "searchable-pdf-ocr", "secure-pdf-redactor", "form-translator", "privacy-policy-decoder", "before-you-sign", "what-changed-in-this-law", "compatibility-engine", "accessibility-fixer", "screenshot-to-steps", "file-format-doctor", "citeshape", "safe-markdown-preview" ] } } ], "responses": { "200": { "description": "Tool definition.", "content": { "application/json": { "schema": { "type": "object" } } } }, "404": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/paperwell-notice-deadlines/calculate": { "post": { "operationId": "calculatePaperwellNoticeDeadlines", "summary": "Last day to cancel a contract: terms, renewals and notice deadlines, with a calendar file.", "description": "Computes the term table of a contract (initial term, automatic renewals) or the earliest end of an open-ended contract (notice on any day, to the end of a month, quarter or year), the last day your notice must arrive, the days left and an iCalendar file with reminders. The same engine powers the deadlines view of Paperwell.\n\nMethodology:\n- A term of N months that starts on 15 March runs up to and including 14 March of the following period (start + N months − 1 day). Month arithmetic clamps to the last day of shorter months (31 January + 1 month = 28/29 February).\n- Notice \"N before the end of the term\" must arrive at the latest on the last day of the term minus N: three months before 31 December is 30 September; 90 days before 31 December is 2 October, so the 90 days from 3 October to 31 December fit completely.\n- Open-ended contracts: notice on any day ends the contract after the notice period; with a month/quarter/year rule the contract ends on the first period end whose notice deadline is still ahead. A minimum term moves the earliest end to its last day.\n- Business days skip Saturdays and Sundays only; public holidays are not known. Past renewal cycles are skipped so the table starts at the current term.\n- The calendar file contains one all-day event per last notice day with reminder alarms; UIDs are stable, so re-importing updates the events instead of duplicating them.\n\nNot legal advice. Contracts, local law (e.g. consumer rules that shorten notice periods) and the way notice must be delivered can change the result; check the contract wording and keep proof of delivery.", "tags": [ "apps" ], "x-mcp-tool": "paperwell_notice_deadlines", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaperwellNoticeDeadlinesInput" }, "examples": { "example1": { "summary": "24-month software subscription, 12-month renewals, 90 days notice", "value": { "title": "Software subscription", "startDate": "2026-11-01", "anchor": "term-end", "termValue": 24, "termUnit": "month", "renewalValue": 12, "renewalUnit": "month", "noticeValue": 90, "noticeUnit": "day", "asOf": "2026-10-26", "cycles": 3, "remind": "30, 7" } }, "example2": { "summary": "Open-ended contract: 3 months to the end of a quarter", "value": { "title": "Insurance", "startDate": "2024-04-01", "anchor": "quarter-end", "noticeValue": 3, "noticeUnit": "month", "asOf": "2026-10-26", "cycles": 3, "remind": "14" } }, "example3": { "summary": "Gym: 12 months minimum, then one month notice any time", "value": { "title": "Gym", "startDate": "2026-01-01", "anchor": "any-time", "termValue": 12, "termUnit": "month", "noticeValue": 1, "noticeUnit": "month", "asOf": "2026-10-26", "cycles": 1, "remind": "" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaperwellNoticeDeadlinesResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/paperwell-page-plan/calculate": { "post": { "operationId": "calculatePaperwellPagePlan", "summary": "Plan a PDF merge, split, reorder, removal or rotation and see every resulting page first.", "description": "Resolves page selections such as \"1-3,5,8-end\", \"odd\" or \"10-1\" against the page counts of your PDFs and lists the exact output files and page sequences of a merge, split, reorder, removal or rotation — before any file is uploaded. It returns the parameters for the pdf-merge-split-reorder tool, so scripts and AI agents can check a plan first.\n\nMethodology:\n- Page selections use the syntax of the site’s PDF tools: numbers and ranges (\"1-3,5\"), \"end\"/\"last\", descending ranges (\"10-1\"), \"reverse\", \"odd\"/\"even\" and range filters (\"1-9:odd\"). Order and duplicates are kept for selecting/reordering; removal and rotation use the sorted set.\n- Merging appends whole files in the given order; file numbers not listed keep their original order after the listed ones.\n- Splitting creates one file per group of N pages or per range; output names follow the pdf-merge-split-reorder tool (\"report-part-2-p4-6.pdf\").\n- The plan is computed from page counts only; no PDF is opened. The real tool re-checks everything against the files.", "tags": [ "apps" ], "x-mcp-tool": "paperwell_page_plan", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaperwellPagePlanInput" }, "examples": { "example1": { "summary": "Merge three PDFs, appendix first", "value": { "mode": "merge", "files": [ { "name": "report.pdf", "pages": 12 }, { "name": "appendix.pdf", "pages": 3 }, { "name": "cover.pdf", "pages": 1 } ], "order": "3,1,2" } }, "example2": { "summary": "Split a 10-page scan into chapters", "value": { "mode": "split-ranges", "files": [ { "name": "scan.pdf", "pages": 10 } ], "ranges": "1-2; 3-7; 8-end" } }, "example3": { "summary": "Reverse a back-to-front scan", "value": { "mode": "pages", "files": [ { "name": "backwards.pdf", "pages": 6 } ], "pages": "reverse" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaperwellPagePlanResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/paperwell-document-scan/calculate": { "post": { "operationId": "calculatePaperwellDocumentScan", "summary": "Full text of a PDF, DOCX or scan plus identifiers, personal data, dates and amounts in it.", "description": "Extracts the full plain text of a PDF (per page), DOCX, HTML, text file or photo/scan (OCR) and scans it for DOIs, ISBNs, ISSNs, ORCIDs, arXiv ids and PMIDs (with check-digit validation), personal data to redact (e-mail, IBAN, phone, payment card numbers), dates, amounts and periods. Paperwell uses it to make documents searchable, comparable and ready for redaction.\n\nMethodology:\n- Text comes from the pasted text or the uploaded file: PDFs through their text layer (pdftotext, one form feed per page; scanned PDFs need OCR first), DOCX from its document XML, HTML without tags, images through Tesseract OCR (English).\n- Identifiers are matched by pattern and validated by their check digits: ISBN-10 (mod 11), ISBN-13 (mod 10), ISSN (mod 11), ORCID (ISO 7064 MOD 11-2). DOIs, arXiv ids and PMIDs have no check digit and are reported as found.\n- Personal data candidates: e-mail addresses, IBANs (only with a valid mod-97 checksum), payment card numbers (only with a valid Luhn checksum) and phone numbers (7–15 digits starting with + or 0). They become exact search terms and presets for the secure-pdf-redactor tool.\n- Dates are recognised as 2026-03-12, 12.03.2026, 12 March 2026 / 12. März 2026 and March 12, 2026; slash dates like 03/04/2026 are reported without an ISO date because the order is ambiguous.\n\nPattern matching finds typical formats, not every personal detail: names, addresses and IDs in free text are not detected. Always review a document before sharing it.", "tags": [ "apps" ], "x-mcp-tool": "paperwell_document_scan", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaperwellDocumentScanInput" }, "examples": { "example1": { "summary": "Reading notes with DOIs, ISBNs and an ORCID", "value": { "text": "Little (1961), doi:10.1287/opre.9.3.383. Textbook ISBN 0-306-40615-2. Author ORCID 0000-0002-1825-0097. Slide typo: ISBN 978-3-16-148410-5.", "includeText": false } }, "example2": { "summary": "Letter with personal data to redact", "value": { "text": "Dear Ms Doe,\nyour refund of EUR 249.00 will be paid to IBAN DE89 3704 0044 0532 0130 00 within 14 days. Questions: billing@shop.example or +49 30 1234 5678.\nBerlin, 12.03.2026", "includeText": true } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PaperwellDocumentScanResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/office-to-pdf-converter/calculate": { "post": { "operationId": "calculateOfficeToPdfConverter", "summary": "Convert Word, Excel, PowerPoint, OpenDocument, RTF and CSV files to PDF with LibreOffice.", "description": "Converts DOCX, DOC, ODT, RTF, PPTX, PPT, ODP, XLSX, XLS, ODS and CSV files to PDF (optionally PDF/A-2b) with LibreOffice running headless on our server. Reports the page count and the fonts used in the PDF, so you can spot substituted fonts, and shows a preview of page 1.\n\nMethodology:\n- The file type is detected from the content (OLE2 stream names for DOC/XLS/PPT, the ZIP structure for DOCX/XLSX/PPTX and OpenDocument, the {\\rtf header for RTF). CSV is accepted as UTF-8 text with a .csv/.tsv name; the separator (comma, semicolon or tab) is taken from the first line.\n- LibreOffice converts the file headless with a fresh private profile per job and a 180-second limit. Macros are not executed. Spreadsheets export every sheet with its print ranges and page setup.\n- Fonts not installed on the server are substituted: Liberation fonts stand in for Arial, Times New Roman and Courier New with identical metrics, Carlito/Caladea (if installed) for Calibri/Cambria; other fonts fall back to similar ones, which can change line and page breaks.\n- The font list is read from the produced PDF (qpdf), so you can see exactly which fonts were used. Dates and random IDs are removed so the same input always gives the same PDF.\n\nLayout fidelity is good but not perfect: complex Word/PowerPoint layouts, SmartArt, some charts, embedded objects and missing fonts can render differently from Microsoft Office. Check the PDF before sending it.", "tags": [ "documents" ], "x-mcp-tool": "office_to_pdf_converter", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OfficeToPdfConverterInput" }, "examples": { "example1": { "summary": "RTF letter to PDF", "value": { "file": { "filename": "notes.rtf", "contentType": "application/rtf", "contentBase64": "e1xydGYxXGFuc2lcZGVmZjB7XGZvbnR0Ymx7XGYwIExpYmVyYXRpb24gU2VyaWY7fXtcZjEgQ2FsaWJyaTt9fVxmMFxmczM2IE1lZXRpbmcgbm90ZXNccGFyXGZzMjQgQWdlbmRhOiBidWRnZXQsIHRpbWVsaW5lIGFuZCBuZXh0IHN0ZXBzLlxwYXJcZjEgVGhpcyBsaW5lIGFza3MgZm9yIENhbGlicmksIHdoaWNoIGlzIHJlcGxhY2VkIGJ5IGEgbWV0cmljLWNvbXBhdGlibGUgZm9udC5ccGFyfQ==" } } }, "example2": { "summary": "Semicolon CSV to a PDF table", "value": { "file": { "filename": "prices.csv", "contentType": "text/csv", "contentBase64": "SXRlbTtRdHk7UHJpY2UKQ29mZmVlOzI7My41MApUZWE7MTsyLjgwCg==" } } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OfficeToPdfConverterResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/pdf-image-converter/calculate": { "post": { "operationId": "calculatePdfImageConverter", "summary": "Turn PDF pages into PNG or JPG images, or combine images into a PDF without quality loss.", "description": "Renders the pages of a PDF as PNG or JPG at 72–300 DPI (one image, or a ZIP for several pages) with a preview of the first page. In the other direction it packs JPG, PNG, TIFF, GIF or WebP images into one PDF; JPG and PNG are embedded losslessly with img2pdf, and you choose page size, fit and order.\n\nMethodology:\n- PDF → images: the PDF is validated (qpdf), decrypted with your password if needed, and each selected page is rendered by Poppler (pdftoppm) at the chosen resolution with anti-aliasing. Several pages are delivered as a ZIP; one page as a single image.\n- Pixel size = page size in points × DPI ÷ 72 (an A4 page at 150 DPI is 1240 × 1754 px). Pages that would exceed 60 megapixels are refused.\n- Images → PDF: img2pdf embeds JPEG files byte for byte and PNG data without re-compression (lossless). TIFF, GIF and WebP are first converted to PNG by ImageMagick (lossless, first frame only). Transparency is kept as a soft mask.\n- \"Same as the image\" makes each page exactly as large as the image at its stored DPI (96 DPI if none is stored). Fixed page sizes place each image according to the fit option and margin.\n- File types are detected from the content, not the file name. Outputs are deterministic: dates are not written into the PDF.", "tags": [ "documents" ], "x-mcp-tool": "pdf_image_converter", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PdfImageConverterInput" }, "examples": { "example1": { "summary": "Two-page PDF to PNG at 72 DPI", "value": { "direction": "pdf-to-images", "format": "png", "dpi": 72, "file": { "filename": "slides.pdf", "contentType": "application/pdf", "contentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFszIDAgUiA1IDAgUl0gL0NvdW50IDIgPj4KZW5kb2JqCjMgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA0MDAgMzAwXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSA3IDAgUiA+PiA+PiAvQ29udGVudHMgNCAwIFIgPj4KZW5kb2JqCjQgMCBvYmoKPDwgL0xlbmd0aCAzOCA+PgpzdHJlYW0KQlQgL0YxIDI0IFRmIDcyIDIwMCBUZCAoU2xpZGUgMSkgVGogRVQKZW5kc3RyZWFtCmVuZG9iago1IDAgb2JqCjw8IC9UeXBlIC9QYWdlIC9QYXJlbnQgMiAwIFIgL01lZGlhQm94IFswIDAgNDAwIDMwMF0gL1Jlc291cmNlcyA8PCAvRm9udCA8PCAvRjEgNyAwIFIgPj4gPj4gL0NvbnRlbnRzIDYgMCBSID4+CmVuZG9iago2IDAgb2JqCjw8IC9MZW5ndGggMzggPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiAyMDAgVGQgKFNsaWRlIDIpIFRqIEVUCmVuZHN0cmVhbQplbmRvYmoKNyAwIG9iago8PCAvVHlwZSAvRm9udCAvU3VidHlwZSAvVHlwZTEgL0Jhc2VGb250IC9IZWx2ZXRpY2EgL0VuY29kaW5nIC9XaW5BbnNpRW5jb2RpbmcgPj4KZW5kb2JqCnhyZWYKMCA4CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAwMDY0IDAwMDAwIG4gCjAwMDAwMDAxMjcgMDAwMDAgbiAKMDAwMDAwMDI1MyAwMDAwMCBuIAowMDAwMDAwMzQxIDAwMDAwIG4gCjAwMDAwMDA0NjcgMDAwMDAgbiAKMDAwMDAwMDU1NSAwMDAwMCBuIAp0cmFpbGVyCjw8IC9TaXplIDggL1Jvb3QgMSAwIFIgPj4Kc3RhcnR4cmVmCjY1MgolJUVPRgo=" } } }, "example2": { "summary": "Two images into one A4 PDF", "value": { "direction": "images-to-pdf", "pageSize": "a4", "margin": 36, "file": { "filename": "red.png", "contentType": "image/png", "contentBase64": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAICAIAAABLbSncAAAAEUlEQVR42mO4o6aGFTEMLQkAF/tKAVIwUJgAAAAASUVORK5CYII=" }, "file2": { "filename": "blue.png", "contentType": "image/png", "contentBase64": "iVBORw0KGgoAAAANSUhEUgAAAAgAAAAICAIAAABLbSncAAAAEUlEQVR42mMQC/qAFTEMLQkAZDdWAbDlhN4AAAAASUVORK5CYII=" } } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PdfImageConverterResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/pdf-compressor/calculate": { "post": { "operationId": "calculatePdfCompressor", "summary": "Make PDFs smaller with Ghostscript presets or custom image DPI and JPEG quality, with previews.", "description": "Re-writes a PDF with Ghostscript using the screen, e-book, printer or prepress preset, or your own image resolution and JPEG quality. Shows the size before and after, can compare up to three presets side by side, and renders page 1 before and after so you can judge the quality. If the result is not smaller, you get the original back.\n\nMethodology:\n- The PDF is validated with qpdf and decrypted with your password if needed. Ghostscript (pdfwrite) then rewrites it: images are downsampled to the preset resolution and re-compressed, fonts are subset and compressed, duplicate images are stored once.\n- Presets follow Ghostscript's -dPDFSETTINGS: screen ≈ 72 DPI images, ebook ≈ 150 DPI, printer and prepress ≈ 300 DPI (prepress keeps more colour information). Screen and e-book always re-encode colour and gray images as JPEG (Ghostscript would otherwise keep smooth images lossless, which can make them larger); printer and prepress let Ghostscript choose. Custom sets the colour/gray image resolution and the JPEG quality directly.\n- With comparison on, a warning appears if a smaller level still produced a larger file than a higher-quality level.\n- Savings = 1 − new size ÷ original size. When a level does not make the file smaller (common for text-only or already optimised PDFs), the original file is returned for that level instead.\n- Page 1 is rendered at the same size before and after (Poppler) so you can compare image quality and text sharpness.\n- Dates and random IDs are removed from the output so the same input always gives the same file. Document title/author are kept; XMP metadata is removed.\n\nGhostscript re-creates the PDF: interactive elements such as form fields usually survive, but digital signatures become invalid and some rare features may be lost. Keep your original.", "tags": [ "documents" ], "x-mcp-tool": "pdf_compressor", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PdfCompressorInput" }, "examples": { "example1": { "summary": "Text-only PDF with the e-book preset", "value": { "preset": "ebook", "file": { "filename": "report.pdf", "contentType": "application/pdf", "contentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFszIDAgUiA1IDAgUl0gL0NvdW50IDIgPj4KZW5kb2JqCjMgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSA3IDAgUiA+PiA+PiAvQ29udGVudHMgNCAwIFIgPj4KZW5kb2JqCjQgMCBvYmoKPDwgL0xlbmd0aCAxOTMgPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiA3NDIgVGQgKFF1YXJ0ZXJseSByZXBvcnQpIFRqIEVUCkJUIC9GMSAxNCBUZiA3MiA3MTIgVGQgKFJldmVudWUgZ3JldyAxMiBwZXJjZW50LikgVGogRVQKQlQgL0YxIDE0IFRmIDcyIDY4MiBUZCAoVGhpcyBzYW1wbGUgaGFzIG9ubHkgdGV4dCwgc28gdGhlcmUgaXMgbGl0dGxlIHRvIGNvbXByZXNzLikgVGogRVQKZW5kc3RyZWFtCmVuZG9iago1IDAgb2JqCjw8IC9UeXBlIC9QYWdlIC9QYXJlbnQgMiAwIFIgL01lZGlhQm94IFswIDAgNTk1IDg0Ml0gL1Jlc291cmNlcyA8PCAvRm9udCA8PCAvRjEgNyAwIFIgPj4gPj4gL0NvbnRlbnRzIDYgMCBSID4+CmVuZG9iago2IDAgb2JqCjw8IC9MZW5ndGggMzkgPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiA3NDIgVGQgKFBhZ2UgdHdvKSBUaiBFVAplbmRzdHJlYW0KZW5kb2JqCjcgMCBvYmoKPDwgL1R5cGUgL0ZvbnQgL1N1YnR5cGUgL1R5cGUxIC9CYXNlRm9udCAvSGVsdmV0aWNhIC9FbmNvZGluZyAvV2luQW5zaUVuY29kaW5nID4+CmVuZG9iagp4cmVmCjAgOAowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMTUgMDAwMDAgbiAKMDAwMDAwMDA2NCAwMDAwMCBuIAowMDAwMDAwMTI3IDAwMDAwIG4gCjAwMDAwMDAyNTMgMDAwMDAgbiAKMDAwMDAwMDQ5NyAwMDAwMCBuIAowMDAwMDAwNjIzIDAwMDAwIG4gCjAwMDAwMDA3MTIgMDAwMDAgbiAKdHJhaWxlcgo8PCAvU2l6ZSA4IC9Sb290IDEgMCBSID4+CnN0YXJ0eHJlZgo4MDkKJSVFT0YK" } } }, "example2": { "summary": "Compare screen, e-book and printer", "value": { "preset": "screen", "compare": true, "file": { "filename": "report.pdf", "contentType": "application/pdf", "contentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFszIDAgUiA1IDAgUl0gL0NvdW50IDIgPj4KZW5kb2JqCjMgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSA3IDAgUiA+PiA+PiAvQ29udGVudHMgNCAwIFIgPj4KZW5kb2JqCjQgMCBvYmoKPDwgL0xlbmd0aCAxOTMgPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiA3NDIgVGQgKFF1YXJ0ZXJseSByZXBvcnQpIFRqIEVUCkJUIC9GMSAxNCBUZiA3MiA3MTIgVGQgKFJldmVudWUgZ3JldyAxMiBwZXJjZW50LikgVGogRVQKQlQgL0YxIDE0IFRmIDcyIDY4MiBUZCAoVGhpcyBzYW1wbGUgaGFzIG9ubHkgdGV4dCwgc28gdGhlcmUgaXMgbGl0dGxlIHRvIGNvbXByZXNzLikgVGogRVQKZW5kc3RyZWFtCmVuZG9iago1IDAgb2JqCjw8IC9UeXBlIC9QYWdlIC9QYXJlbnQgMiAwIFIgL01lZGlhQm94IFswIDAgNTk1IDg0Ml0gL1Jlc291cmNlcyA8PCAvRm9udCA8PCAvRjEgNyAwIFIgPj4gPj4gL0NvbnRlbnRzIDYgMCBSID4+CmVuZG9iago2IDAgb2JqCjw8IC9MZW5ndGggMzkgPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiA3NDIgVGQgKFBhZ2UgdHdvKSBUaiBFVAplbmRzdHJlYW0KZW5kb2JqCjcgMCBvYmoKPDwgL1R5cGUgL0ZvbnQgL1N1YnR5cGUgL1R5cGUxIC9CYXNlRm9udCAvSGVsdmV0aWNhIC9FbmNvZGluZyAvV2luQW5zaUVuY29kaW5nID4+CmVuZG9iagp4cmVmCjAgOAowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMTUgMDAwMDAgbiAKMDAwMDAwMDA2NCAwMDAwMCBuIAowMDAwMDAwMTI3IDAwMDAwIG4gCjAwMDAwMDAyNTMgMDAwMDAgbiAKMDAwMDAwMDQ5NyAwMDAwMCBuIAowMDAwMDAwNjIzIDAwMDAwIG4gCjAwMDAwMDA3MTIgMDAwMDAgbiAKdHJhaWxlcgo8PCAvU2l6ZSA4IC9Sb290IDEgMCBSID4+CnN0YXJ0eHJlZgo4MDkKJSVFT0YK" } } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PdfCompressorResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/pdf-form-signature-studio/calculate": { "post": { "operationId": "calculatePdfFormSignatureStudio", "summary": "List and fill PDF form fields, and place a visible signature image or typed name on a page.", "description": "Shows every field of a fillable PDF (name, type, value, options), fills text fields, checkboxes, radio buttons and drop-downs, and optionally flattens the form. It can also stamp a visible signature, from an uploaded PNG/JPG or a typed name in a script font, at an exact position on any page. This is a picture of a signature, not a cryptographic digital signature.\n\nMethodology:\n- Fields are read with qpdf's JSON view of the AcroForm (/AcroForm /Fields): full name, type (text, checkbox, radio, drop-down, list, signature), current value, options and page. XFA-only forms (dynamic Adobe forms) are not supported.\n- Values are written into the field objects (/V, and /AS for checkbox/radio widgets). /NeedAppearances is set to true so viewers redraw the fields, and qpdf --generate-appearances draws text and choice fields so they show up everywhere, including when flattened.\n- Checkboxes accept yes/no (or the on-state name), radio buttons and drop-downs one of their options. Read-only fields, unknown names and invalid options are skipped and listed, never guessed.\n- Visible signature: the image (or the typed name rendered in a handwriting-style font with ImageMagick) is placed on a transparent overlay page of exactly the target page size at 200 DPI, converted with img2pdf and laid over the page with qpdf --overlay. Positions are in points from the top-left corner.\n- This is NOT a cryptographic (digital) signature: it proves nothing about who signed or whether the document was changed. Use a qualified e-signature service when a legally binding electronic signature is required.\n\nA visible signature image is not a digital signature. Existing digital signatures in the PDF become invalid when you fill or stamp it.", "tags": [ "documents" ], "x-mcp-tool": "pdf_form_signature_studio", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PdfFormSignatureStudioInput" }, "examples": { "example1": { "summary": "List the fields of a registration form", "value": { "action": "list", "file": { "filename": "registration.pdf", "contentType": "application/pdf", "contentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgL0Fjcm9Gb3JtIDw8IC9GaWVsZHMgWzUgMCBSIDYgMCBSIDcgMCBSXSAvREEgKC9IZWx2IDAgVGYgMCBnKSAvRFIgPDwgL0ZvbnQgPDwgL0hlbHYgOCAwIFIgL1phRGIgOSAwIFIgPj4gPj4gPj4gPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFszIDAgUl0gL0NvdW50IDEgPj4KZW5kb2JqCjMgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSA4IDAgUiA+PiA+PiAvQ29udGVudHMgNCAwIFIgL0Fubm90cyBbNSAwIFIgNiAwIFIgNyAwIFJdID4+CmVuZG9iago0IDAgb2JqCjw8IC9MZW5ndGggMTcwID4+CnN0cmVhbQpCVCAvRjEgMTggVGYgNzIgNzYwIFRkIChSZWdpc3RyYXRpb24gZm9ybSkgVGogRVQKQlQgL0YxIDEyIFRmIDcyIDcxMiBUZCAoRnVsbCBuYW1lOikgVGogRVQKQlQgL0YxIDEyIFRmIDcyIDY3MiBUZCAoSSBhZ3JlZTopIFRqIEVUCkJUIC9GMSAxMiBUZiA3MiA2MzIgVGQgKENvdW50cnk6KSBUaiBFVAplbmRzdHJlYW0KZW5kb2JqCjUgMCBvYmoKPDwgL1R5cGUgL0Fubm90IC9TdWJ0eXBlIC9XaWRnZXQgL0ZUIC9UeCAvVCAoZnVsbF9uYW1lKSAvVFUgKEZ1bGwgbmFtZSkgL1JlY3QgWzE2MCA3MDUgNDIwIDcyNV0gL0YgNCAvUCAzIDAgUiAvREEgKC9IZWx2IDEyIFRmIDAgZykgL01LIDw8IC9CQyBbMCAwIDBdID4+ID4+CmVuZG9iago2IDAgb2JqCjw8IC9UeXBlIC9Bbm5vdCAvU3VidHlwZSAvV2lkZ2V0IC9GVCAvQnRuIC9UIChhZ3JlZSkgL1JlY3QgWzE2MCA2NjUgMTc2IDY4MV0gL0YgNCAvUCAzIDAgUiAvViAvT2ZmIC9BUyAvT2ZmIC9EQSAoL1phRGIgMCBUZiAwIGcpIC9NSyA8PCAvQkMgWzAgMCAwXSAvQ0EgKDQpID4+IC9BUCA8PCAvTiA8PCAvWWVzIDEwIDAgUiAvT2ZmIDExIDAgUiA+PiA+PiA+PgplbmRvYmoKNyAwIG9iago8PCAvVHlwZSAvQW5ub3QgL1N1YnR5cGUgL1dpZGdldCAvRlQgL0NoIC9GZiAxMzEwNzIgL1QgKGNvdW50cnkpIC9SZWN0IFsxNjAgNjI1IDMyMCA2NDVdIC9GIDQgL1AgMyAwIFIgL09wdCBbKEdlcm1hbnkpIChGcmFuY2UpIChTcGFpbildIC9WIChHZXJtYW55KSAvREEgKC9IZWx2IDEyIFRmIDAgZykgL01LIDw8IC9CQyBbMCAwIDBdID4+ID4+CmVuZG9iago4IDAgb2JqCjw8IC9UeXBlIC9Gb250IC9TdWJ0eXBlIC9UeXBlMSAvQmFzZUZvbnQgL0hlbHZldGljYSAvRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZyA+PgplbmRvYmoKOSAwIG9iago8PCAvVHlwZSAvRm9udCAvU3VidHlwZSAvVHlwZTEgL0Jhc2VGb250IC9aYXBmRGluZ2JhdHMgPj4KZW5kb2JqCjEwIDAgb2JqCjw8IC9UeXBlIC9YT2JqZWN0IC9TdWJ0eXBlIC9Gb3JtIC9CQm94IFswIDAgMTYgMTZdIC9SZXNvdXJjZXMgPDwgL0ZvbnQgPDwgL1phRGIgOSAwIFIgPj4gPj4gL0xlbmd0aCAzOSA+PgpzdHJlYW0KcSAwIGcgQlQgL1phRGIgMTIgVGYgMiAzIFRkICg0KSBUaiBFVCBRCmVuZHN0cmVhbQplbmRvYmoKMTEgMCBvYmoKPDwgL1R5cGUgL1hPYmplY3QgL1N1YnR5cGUgL0Zvcm0gL0JCb3ggWzAgMCAxNiAxNl0gL0xlbmd0aCAwID4+CnN0cmVhbQoKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgMTIKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMDE1IDAwMDAwIG4gCjAwMDAwMDAxNzUgMDAwMDAgbiAKMDAwMDAwMDIzMiAwMDAwMCBuIAowMDAwMDAwMzg2IDAwMDAwIG4gCjAwMDAwMDA2MDcgMDAwMDAgbiAKMDAwMDAwMDc3OSAwMDAwMCBuIAowMDAwMDAwOTk5IDAwMDAwIG4gCjAwMDAwMDEyMTEgMDAwMDAgbiAKMDAwMDAwMTMwOCAwMDAwMCBuIAowMDAwMDAxMzgxIDAwMDAwIG4gCjAwMDAwMDE1NjAgMDAwMDAgbiAKdHJhaWxlcgo8PCAvU2l6ZSAxMiAvUm9vdCAxIDAgUiA+PgpzdGFydHhyZWYKMTY1OAolJUVPRgo=" } } }, "example2": { "summary": "Fill the form and flatten it", "value": { "action": "fill", "flatten": true, "values": [ { "field": "full_name", "value": "Jane Doe" }, { "field": "agree", "value": "yes" }, { "field": "country", "value": "France" } ], "file": { "filename": "registration.pdf", "contentType": "application/pdf", "contentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgL0Fjcm9Gb3JtIDw8IC9GaWVsZHMgWzUgMCBSIDYgMCBSIDcgMCBSXSAvREEgKC9IZWx2IDAgVGYgMCBnKSAvRFIgPDwgL0ZvbnQgPDwgL0hlbHYgOCAwIFIgL1phRGIgOSAwIFIgPj4gPj4gPj4gPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFszIDAgUl0gL0NvdW50IDEgPj4KZW5kb2JqCjMgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSA4IDAgUiA+PiA+PiAvQ29udGVudHMgNCAwIFIgL0Fubm90cyBbNSAwIFIgNiAwIFIgNyAwIFJdID4+CmVuZG9iago0IDAgb2JqCjw8IC9MZW5ndGggMTcwID4+CnN0cmVhbQpCVCAvRjEgMTggVGYgNzIgNzYwIFRkIChSZWdpc3RyYXRpb24gZm9ybSkgVGogRVQKQlQgL0YxIDEyIFRmIDcyIDcxMiBUZCAoRnVsbCBuYW1lOikgVGogRVQKQlQgL0YxIDEyIFRmIDcyIDY3MiBUZCAoSSBhZ3JlZTopIFRqIEVUCkJUIC9GMSAxMiBUZiA3MiA2MzIgVGQgKENvdW50cnk6KSBUaiBFVAplbmRzdHJlYW0KZW5kb2JqCjUgMCBvYmoKPDwgL1R5cGUgL0Fubm90IC9TdWJ0eXBlIC9XaWRnZXQgL0ZUIC9UeCAvVCAoZnVsbF9uYW1lKSAvVFUgKEZ1bGwgbmFtZSkgL1JlY3QgWzE2MCA3MDUgNDIwIDcyNV0gL0YgNCAvUCAzIDAgUiAvREEgKC9IZWx2IDEyIFRmIDAgZykgL01LIDw8IC9CQyBbMCAwIDBdID4+ID4+CmVuZG9iago2IDAgb2JqCjw8IC9UeXBlIC9Bbm5vdCAvU3VidHlwZSAvV2lkZ2V0IC9GVCAvQnRuIC9UIChhZ3JlZSkgL1JlY3QgWzE2MCA2NjUgMTc2IDY4MV0gL0YgNCAvUCAzIDAgUiAvViAvT2ZmIC9BUyAvT2ZmIC9EQSAoL1phRGIgMCBUZiAwIGcpIC9NSyA8PCAvQkMgWzAgMCAwXSAvQ0EgKDQpID4+IC9BUCA8PCAvTiA8PCAvWWVzIDEwIDAgUiAvT2ZmIDExIDAgUiA+PiA+PiA+PgplbmRvYmoKNyAwIG9iago8PCAvVHlwZSAvQW5ub3QgL1N1YnR5cGUgL1dpZGdldCAvRlQgL0NoIC9GZiAxMzEwNzIgL1QgKGNvdW50cnkpIC9SZWN0IFsxNjAgNjI1IDMyMCA2NDVdIC9GIDQgL1AgMyAwIFIgL09wdCBbKEdlcm1hbnkpIChGcmFuY2UpIChTcGFpbildIC9WIChHZXJtYW55KSAvREEgKC9IZWx2IDEyIFRmIDAgZykgL01LIDw8IC9CQyBbMCAwIDBdID4+ID4+CmVuZG9iago4IDAgb2JqCjw8IC9UeXBlIC9Gb250IC9TdWJ0eXBlIC9UeXBlMSAvQmFzZUZvbnQgL0hlbHZldGljYSAvRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZyA+PgplbmRvYmoKOSAwIG9iago8PCAvVHlwZSAvRm9udCAvU3VidHlwZSAvVHlwZTEgL0Jhc2VGb250IC9aYXBmRGluZ2JhdHMgPj4KZW5kb2JqCjEwIDAgb2JqCjw8IC9UeXBlIC9YT2JqZWN0IC9TdWJ0eXBlIC9Gb3JtIC9CQm94IFswIDAgMTYgMTZdIC9SZXNvdXJjZXMgPDwgL0ZvbnQgPDwgL1phRGIgOSAwIFIgPj4gPj4gL0xlbmd0aCAzOSA+PgpzdHJlYW0KcSAwIGcgQlQgL1phRGIgMTIgVGYgMiAzIFRkICg0KSBUaiBFVCBRCmVuZHN0cmVhbQplbmRvYmoKMTEgMCBvYmoKPDwgL1R5cGUgL1hPYmplY3QgL1N1YnR5cGUgL0Zvcm0gL0JCb3ggWzAgMCAxNiAxNl0gL0xlbmd0aCAwID4+CnN0cmVhbQoKZW5kc3RyZWFtCmVuZG9iagp4cmVmCjAgMTIKMDAwMDAwMDAwMCA2NTUzNSBmIAowMDAwMDAwMDE1IDAwMDAwIG4gCjAwMDAwMDAxNzUgMDAwMDAgbiAKMDAwMDAwMDIzMiAwMDAwMCBuIAowMDAwMDAwMzg2IDAwMDAwIG4gCjAwMDAwMDA2MDcgMDAwMDAgbiAKMDAwMDAwMDc3OSAwMDAwMCBuIAowMDAwMDAwOTk5IDAwMDAwIG4gCjAwMDAwMDEyMTEgMDAwMDAgbiAKMDAwMDAwMTMwOCAwMDAwMCBuIAowMDAwMDAxMzgxIDAwMDAwIG4gCjAwMDAwMDE1NjAgMDAwMDAgbiAKdHJhaWxlcgo8PCAvU2l6ZSAxMiAvUm9vdCAxIDAgUiA+PgpzdGFydHhyZWYKMTY1OAolJUVPRgo=" } } }, "example3": { "summary": "Typed signature at the bottom of a letter", "value": { "action": "sign", "signatureText": "Jane Doe", "x": 72, "y": 160, "width": 160, "file": { "filename": "letter.pdf", "contentType": "application/pdf", "contentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFszIDAgUl0gL0NvdW50IDEgPj4KZW5kb2JqCjMgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSA1IDAgUiA+PiA+PiAvQ29udGVudHMgNCAwIFIgPj4KZW5kb2JqCjQgMCBvYmoKPDwgL0xlbmd0aCAxNjcgPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiA3NDIgVGQgKERlYXIgU2lyIG9yIE1hZGFtLCkgVGogRVQKQlQgL0YxIDE0IFRmIDcyIDcxMiBUZCAocGxlYXNlIGZpbmQgdGhlIHNpZ25lZCBhZ3JlZW1lbnQgYXR0YWNoZWQuKSBUaiBFVApCVCAvRjEgMTQgVGYgNzIgNjgyIFRkIChLaW5kIHJlZ2FyZHMpIFRqIEVUCmVuZHN0cmVhbQplbmRvYmoKNSAwIG9iago8PCAvVHlwZSAvRm9udCAvU3VidHlwZSAvVHlwZTEgL0Jhc2VGb250IC9IZWx2ZXRpY2EgL0VuY29kaW5nIC9XaW5BbnNpRW5jb2RpbmcgPj4KZW5kb2JqCnhyZWYKMCA2CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAwMDY0IDAwMDAwIG4gCjAwMDAwMDAxMjEgMDAwMDAgbiAKMDAwMDAwMDI0NyAwMDAwMCBuIAowMDAwMDAwNDY1IDAwMDAwIG4gCnRyYWlsZXIKPDwgL1NpemUgNiAvUm9vdCAxIDAgUiA+PgpzdGFydHhyZWYKNTYyCiUlRU9GCg==" } } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PdfFormSignatureStudioResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/pdf-merge-split-reorder/calculate": { "post": { "operationId": "calculatePdfMergeSplitReorder", "summary": "Merge PDFs, split by page count or ranges, and reorder, remove, rotate or duplicate pages.", "description": "Combines several PDFs into one in the order you choose, splits a PDF every N pages or by page ranges (download as a ZIP), and rearranges pages with a simple page syntax such as \"1-3,5,8-end\", \"odd\" or \"reverse\". Shows page counts before and after and a preview of the first page.\n\nMethodology:\n- Every upload is checked by its content (it must start like a PDF) and by qpdf --check. Encrypted PDFs are opened with the password you give (passed to qpdf in a private file, never on a command line) and written without encryption.\n- Merge: qpdf copies all pages of each file, in the chosen order, into the first file. Bookmarks and document metadata come from the first file; form fields of all files are kept.\n- Split: each part is a separate PDF built from the selected pages; several parts are packed into one ZIP.\n- Select/reorder: the page list is taken literally, so \"3,1,2\" reorders, \"1,1,2\" duplicates page 1, and \"reverse\" reverses. Remove keeps every page not listed. Rotate adds the angle to the current rotation of the listed pages (lossless, no re-rendering).\n- Page contents are never re-encoded: text, fonts and images stay exactly as they were. qpdf writes a deterministic file ID, so the same input always gives the same file.\n\nDigital signatures in the input become invalid when pages are changed. Keep your originals.", "tags": [ "documents" ], "x-mcp-tool": "pdf_merge_split_reorder", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PdfMergeSplitReorderInput" }, "examples": { "example1": { "summary": "Merge two PDFs (6 pages)", "value": { "mode": "merge", "file": { "filename": "report.pdf", "contentType": "application/pdf", "contentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFszIDAgUiA1IDAgUiA3IDAgUiA5IDAgUl0gL0NvdW50IDQgPj4KZW5kb2JqCjMgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSAxMSAwIFIgPj4gPj4gL0NvbnRlbnRzIDQgMCBSID4+CmVuZG9iago0IDAgb2JqCjw8IC9MZW5ndGggNTEgPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiA3NDIgVGQgKFBhZ2UgMTogSW50cm9kdWN0aW9uKSBUaiBFVAplbmRzdHJlYW0KZW5kb2JqCjUgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSAxMSAwIFIgPj4gPj4gL0NvbnRlbnRzIDYgMCBSID4+CmVuZG9iago2IDAgb2JqCjw8IC9MZW5ndGggNDYgPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiA3NDIgVGQgKFBhZ2UgMjogTWV0aG9kcykgVGogRVQKZW5kc3RyZWFtCmVuZG9iago3IDAgb2JqCjw8IC9UeXBlIC9QYWdlIC9QYXJlbnQgMiAwIFIgL01lZGlhQm94IFswIDAgNTk1IDg0Ml0gL1Jlc291cmNlcyA8PCAvRm9udCA8PCAvRjEgMTEgMCBSID4+ID4+IC9Db250ZW50cyA4IDAgUiA+PgplbmRvYmoKOCAwIG9iago8PCAvTGVuZ3RoIDQ2ID4+CnN0cmVhbQpCVCAvRjEgMjQgVGYgNzIgNzQyIFRkIChQYWdlIDM6IFJlc3VsdHMpIFRqIEVUCmVuZHN0cmVhbQplbmRvYmoKOSAwIG9iago8PCAvVHlwZSAvUGFnZSAvUGFyZW50IDIgMCBSIC9NZWRpYUJveCBbMCAwIDU5NSA4NDJdIC9SZXNvdXJjZXMgPDwgL0ZvbnQgPDwgL0YxIDExIDAgUiA+PiA+PiAvQ29udGVudHMgMTAgMCBSID4+CmVuZG9iagoxMCAwIG9iago8PCAvTGVuZ3RoIDQ3ID4+CnN0cmVhbQpCVCAvRjEgMjQgVGYgNzIgNzQyIFRkIChQYWdlIDQ6IEFwcGVuZGl4KSBUaiBFVAplbmRzdHJlYW0KZW5kb2JqCjExIDAgb2JqCjw8IC9UeXBlIC9Gb250IC9TdWJ0eXBlIC9UeXBlMSAvQmFzZUZvbnQgL0hlbHZldGljYSAvRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZyA+PgplbmRvYmoKeHJlZgowIDEyCjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAwMDY0IDAwMDAwIG4gCjAwMDAwMDAxMzkgMDAwMDAgbiAKMDAwMDAwMDI2NiAwMDAwMCBuIAowMDAwMDAwMzY3IDAwMDAwIG4gCjAwMDAwMDA0OTQgMDAwMDAgbiAKMDAwMDAwMDU5MCAwMDAwMCBuIAowMDAwMDAwNzE3IDAwMDAwIG4gCjAwMDAwMDA4MTMgMDAwMDAgbiAKMDAwMDAwMDk0MSAwMDAwMCBuIAowMDAwMDAxMDM5IDAwMDAwIG4gCnRyYWlsZXIKPDwgL1NpemUgMTIgL1Jvb3QgMSAwIFIgPj4Kc3RhcnR4cmVmCjExMzcKJSVFT0YK" }, "file2": { "filename": "annex.pdf", "contentType": "application/pdf", "contentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFszIDAgUiA1IDAgUl0gL0NvdW50IDIgPj4KZW5kb2JqCjMgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSA3IDAgUiA+PiA+PiAvQ29udGVudHMgNCAwIFIgPj4KZW5kb2JqCjQgMCBvYmoKPDwgL0xlbmd0aCAzOCA+PgpzdHJlYW0KQlQgL0YxIDI0IFRmIDcyIDc0MiBUZCAoQW5uZXggQSkgVGogRVQKZW5kc3RyZWFtCmVuZG9iago1IDAgb2JqCjw8IC9UeXBlIC9QYWdlIC9QYXJlbnQgMiAwIFIgL01lZGlhQm94IFswIDAgNTk1IDg0Ml0gL1Jlc291cmNlcyA8PCAvRm9udCA8PCAvRjEgNyAwIFIgPj4gPj4gL0NvbnRlbnRzIDYgMCBSID4+CmVuZG9iago2IDAgb2JqCjw8IC9MZW5ndGggMzggPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiA3NDIgVGQgKEFubmV4IEIpIFRqIEVUCmVuZHN0cmVhbQplbmRvYmoKNyAwIG9iago8PCAvVHlwZSAvRm9udCAvU3VidHlwZSAvVHlwZTEgL0Jhc2VGb250IC9IZWx2ZXRpY2EgL0VuY29kaW5nIC9XaW5BbnNpRW5jb2RpbmcgPj4KZW5kb2JqCnhyZWYKMCA4CjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAwMDY0IDAwMDAwIG4gCjAwMDAwMDAxMjcgMDAwMDAgbiAKMDAwMDAwMDI1MyAwMDAwMCBuIAowMDAwMDAwMzQxIDAwMDAwIG4gCjAwMDAwMDA0NjcgMDAwMDAgbiAKMDAwMDAwMDU1NSAwMDAwMCBuIAp0cmFpbGVyCjw8IC9TaXplIDggL1Jvb3QgMSAwIFIgPj4Kc3RhcnR4cmVmCjY1MgolJUVPRgo=" } } }, "example2": { "summary": "Split every 2 pages into a ZIP", "value": { "mode": "split-every", "everyN": 2, "file": { "filename": "report.pdf", "contentType": "application/pdf", "contentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFszIDAgUiA1IDAgUiA3IDAgUiA5IDAgUl0gL0NvdW50IDQgPj4KZW5kb2JqCjMgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSAxMSAwIFIgPj4gPj4gL0NvbnRlbnRzIDQgMCBSID4+CmVuZG9iago0IDAgb2JqCjw8IC9MZW5ndGggNTEgPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiA3NDIgVGQgKFBhZ2UgMTogSW50cm9kdWN0aW9uKSBUaiBFVAplbmRzdHJlYW0KZW5kb2JqCjUgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSAxMSAwIFIgPj4gPj4gL0NvbnRlbnRzIDYgMCBSID4+CmVuZG9iago2IDAgb2JqCjw8IC9MZW5ndGggNDYgPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiA3NDIgVGQgKFBhZ2UgMjogTWV0aG9kcykgVGogRVQKZW5kc3RyZWFtCmVuZG9iago3IDAgb2JqCjw8IC9UeXBlIC9QYWdlIC9QYXJlbnQgMiAwIFIgL01lZGlhQm94IFswIDAgNTk1IDg0Ml0gL1Jlc291cmNlcyA8PCAvRm9udCA8PCAvRjEgMTEgMCBSID4+ID4+IC9Db250ZW50cyA4IDAgUiA+PgplbmRvYmoKOCAwIG9iago8PCAvTGVuZ3RoIDQ2ID4+CnN0cmVhbQpCVCAvRjEgMjQgVGYgNzIgNzQyIFRkIChQYWdlIDM6IFJlc3VsdHMpIFRqIEVUCmVuZHN0cmVhbQplbmRvYmoKOSAwIG9iago8PCAvVHlwZSAvUGFnZSAvUGFyZW50IDIgMCBSIC9NZWRpYUJveCBbMCAwIDU5NSA4NDJdIC9SZXNvdXJjZXMgPDwgL0ZvbnQgPDwgL0YxIDExIDAgUiA+PiA+PiAvQ29udGVudHMgMTAgMCBSID4+CmVuZG9iagoxMCAwIG9iago8PCAvTGVuZ3RoIDQ3ID4+CnN0cmVhbQpCVCAvRjEgMjQgVGYgNzIgNzQyIFRkIChQYWdlIDQ6IEFwcGVuZGl4KSBUaiBFVAplbmRzdHJlYW0KZW5kb2JqCjExIDAgb2JqCjw8IC9UeXBlIC9Gb250IC9TdWJ0eXBlIC9UeXBlMSAvQmFzZUZvbnQgL0hlbHZldGljYSAvRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZyA+PgplbmRvYmoKeHJlZgowIDEyCjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAwMDY0IDAwMDAwIG4gCjAwMDAwMDAxMzkgMDAwMDAgbiAKMDAwMDAwMDI2NiAwMDAwMCBuIAowMDAwMDAwMzY3IDAwMDAwIG4gCjAwMDAwMDA0OTQgMDAwMDAgbiAKMDAwMDAwMDU5MCAwMDAwMCBuIAowMDAwMDAwNzE3IDAwMDAwIG4gCjAwMDAwMDA4MTMgMDAwMDAgbiAKMDAwMDAwMDk0MSAwMDAwMCBuIAowMDAwMDAxMDM5IDAwMDAwIG4gCnRyYWlsZXIKPDwgL1NpemUgMTIgL1Jvb3QgMSAwIFIgPj4Kc3RhcnR4cmVmCjExMzcKJSVFT0YK" } } }, "example3": { "summary": "Cover page, then all pages in reverse order", "value": { "mode": "pages", "pages": "1,reverse", "file": { "filename": "report.pdf", "contentType": "application/pdf", "contentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFszIDAgUiA1IDAgUiA3IDAgUiA5IDAgUl0gL0NvdW50IDQgPj4KZW5kb2JqCjMgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSAxMSAwIFIgPj4gPj4gL0NvbnRlbnRzIDQgMCBSID4+CmVuZG9iago0IDAgb2JqCjw8IC9MZW5ndGggNTEgPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiA3NDIgVGQgKFBhZ2UgMTogSW50cm9kdWN0aW9uKSBUaiBFVAplbmRzdHJlYW0KZW5kb2JqCjUgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSAxMSAwIFIgPj4gPj4gL0NvbnRlbnRzIDYgMCBSID4+CmVuZG9iago2IDAgb2JqCjw8IC9MZW5ndGggNDYgPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiA3NDIgVGQgKFBhZ2UgMjogTWV0aG9kcykgVGogRVQKZW5kc3RyZWFtCmVuZG9iago3IDAgb2JqCjw8IC9UeXBlIC9QYWdlIC9QYXJlbnQgMiAwIFIgL01lZGlhQm94IFswIDAgNTk1IDg0Ml0gL1Jlc291cmNlcyA8PCAvRm9udCA8PCAvRjEgMTEgMCBSID4+ID4+IC9Db250ZW50cyA4IDAgUiA+PgplbmRvYmoKOCAwIG9iago8PCAvTGVuZ3RoIDQ2ID4+CnN0cmVhbQpCVCAvRjEgMjQgVGYgNzIgNzQyIFRkIChQYWdlIDM6IFJlc3VsdHMpIFRqIEVUCmVuZHN0cmVhbQplbmRvYmoKOSAwIG9iago8PCAvVHlwZSAvUGFnZSAvUGFyZW50IDIgMCBSIC9NZWRpYUJveCBbMCAwIDU5NSA4NDJdIC9SZXNvdXJjZXMgPDwgL0ZvbnQgPDwgL0YxIDExIDAgUiA+PiA+PiAvQ29udGVudHMgMTAgMCBSID4+CmVuZG9iagoxMCAwIG9iago8PCAvTGVuZ3RoIDQ3ID4+CnN0cmVhbQpCVCAvRjEgMjQgVGYgNzIgNzQyIFRkIChQYWdlIDQ6IEFwcGVuZGl4KSBUaiBFVAplbmRzdHJlYW0KZW5kb2JqCjExIDAgb2JqCjw8IC9UeXBlIC9Gb250IC9TdWJ0eXBlIC9UeXBlMSAvQmFzZUZvbnQgL0hlbHZldGljYSAvRW5jb2RpbmcgL1dpbkFuc2lFbmNvZGluZyA+PgplbmRvYmoKeHJlZgowIDEyCjAwMDAwMDAwMDAgNjU1MzUgZiAKMDAwMDAwMDAxNSAwMDAwMCBuIAowMDAwMDAwMDY0IDAwMDAwIG4gCjAwMDAwMDAxMzkgMDAwMDAgbiAKMDAwMDAwMDI2NiAwMDAwMCBuIAowMDAwMDAwMzY3IDAwMDAwIG4gCjAwMDAwMDA0OTQgMDAwMDAgbiAKMDAwMDAwMDU5MCAwMDAwMCBuIAowMDAwMDAwNzE3IDAwMDAwIG4gCjAwMDAwMDA4MTMgMDAwMDAgbiAKMDAwMDAwMDk0MSAwMDAwMCBuIAowMDAwMDAxMDM5IDAwMDAwIG4gCnRyYWlsZXIKPDwgL1NpemUgMTIgL1Jvb3QgMSAwIFIgPj4Kc3RhcnR4cmVmCjExMzcKJSVFT0YK" } } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PdfMergeSplitReorderResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/searchable-pdf-ocr/calculate": { "post": { "operationId": "calculateSearchablePdfOcr", "summary": "Make scanned PDFs searchable and copyable with OCRmyPDF and Tesseract, optionally as PDF/A.", "description": "Adds an invisible, selectable text layer to scanned PDFs (or a scanned JPG/PNG) using OCRmyPDF and Tesseract. Choose the document languages, straighten crooked scans, fix upside-down pages and optionally create a PDF/A for archiving. Reports how many pages were recognised and shows a sample of the extracted text.\n\nMethodology:\n- Images (JPG/PNG/TIFF) are first wrapped into a PDF with img2pdf. PDFs are validated with qpdf and decrypted with your password if needed.\n- OCRmyPDF renders each page, lets Tesseract recognise the text in the chosen languages and lays the words as invisible text exactly over the image, so the page looks unchanged but can be searched and copied.\n- \"Leave them as they are\" skips pages that already have text (born-digital pages stay untouched). \"OCR every page\" rasterises such pages too, which replaces their vector text with an image plus OCR text.\n- Pages processed = pages without extractable text before (or all pages when forcing OCR). The text sample and character count are read back from the result with pdftotext.\n- Without OCRmyPDF the server falls back to Tesseract alone: every page is rendered at 300 DPI in grayscale and rebuilt as image + text (deskew, rotation and PDF/A are then unavailable).\n- Random internal names, dates and IDs are normalised so the same input gives the same file; PDF/A keeps its XMP metadata with the timestamps set to 2000-01-01.\n\nOCR is not perfect: handwriting, low-resolution scans, unusual fonts and complex layouts produce errors. Check important text against the image.", "tags": [ "documents" ], "x-mcp-tool": "searchable_pdf_ocr", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchablePdfOcrInput" }, "examples": { "example1": { "summary": "Scanned line of text (PNG) to a searchable PDF", "value": { "file": { "filename": "scan.png", "contentType": "image/png", "contentBase64": "iVBORw0KGgoAAAANSUhEUgAAAggAAABGAQAAAACBSlH7AAABvklEQVRYw+3UMUvEMBQH8MgVM+bGG4QMfgkn47dx1V2aA4eO/UonGfoxbMngaLpFCHm+l1ZUUNOeIAh5w5+jvfy45N4Lg98WK0IRilCEIvydYL/+RtDw9LMQ1WchcnAKI4hjBXcCvcBwm2OFnukDx+jXC2+Q102HYd4frRQgKGEx2hXCmexA9trCCRzoKJW0GHiQ4UZ7GfQhK2y5iWovbWCaqSSMFChcyQMPen+dExi3UVXC+m1d4bp4mYSdhFCJh/ugK54TuLG4qrVu2n24VCN+2mJLyPZxCLVscoKwY6hVZ3GdJqEmoWYbZBqgV1lBonCnOzuAhw7Ak+BrbhDs4IVeZYWRBGPtJLiIgotiSIJfJngftCWB4aENJAxR0qY6x44QDAlmEmxPQrYfUHCzQI8aEppZMAt3EW4/CIIWC5h20a4QzCxEiYtTrBHieZj+TU2DBdjg6k1wS4U4dxSQgg2uoR2oo1BY0lFj3MS5q5/B4Vl2FIa6uumXdDX+Xg7TZJ0KvKMU3VEYabLYkslKwjzdSehFCprufrdkupMw3zCKBKcwvKQbxl3kb5gfig42W0X4J8KiKkIRilCE7+oV25/CiYnY+pIAAAAASUVORK5CYII=" }, "languages": [ "eng" ] } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SearchablePdfOcrResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/secure-pdf-redactor/calculate": { "post": { "operationId": "calculateSecurePdfRedactor", "summary": "Black out names, numbers or areas in a PDF for real: the text is removed, not just covered.", "description": "Finds words, phrases, regular expressions or typical personal data (e-mails, phone numbers, IBANs, card numbers) and any rectangles you specify, then rebuilds the affected pages as images with black boxes so the hidden text is truly gone. Optionally re-runs OCR so the rest of the page stays searchable, strips metadata, and proves the result with a text search of the output.\n\nMethodology:\n- Word positions come from Poppler (pdftotext -bbox-layout). Each text line is searched for your words/phrases (spaces may vary), regular expressions and the chosen patterns; every word that overlaps a match gets a black box with 1.5 pt padding. A match that wraps onto the next line is not found as one phrase; the final check reports it.\n- Pages with at least one box are rendered to an image at the chosen DPI, the boxes are painted black into the pixels, and the page is rebuilt from that image. The original text, fonts and vector content of those pages are discarded — covering text with a black rectangle (the common mistake) would leave it copyable.\n- With OCR on, Tesseract re-recognises the remaining visible text of rebuilt pages, so they stay searchable without the redacted words. Pages without hits are copied unchanged (text stays selectable).\n- The document is reassembled with qpdf from scratch, which drops: Document information (title, author, subject, keywords, creator, producer, creation and modification dates); XMP metadata stream; Bookmarks (outline), named destinations and page labels; Attachments (embedded files) and document-level JavaScript; Interactive form (AcroForm) definitions; Page-level metadata and application data (/Metadata, /PieceInfo). With \"Remove comments…\" on, all annotations (comments, links, form widgets) are removed from every page.\n- Patterns: phone numbers must start with +, 00 or a 0 trunk prefix, have 7–15 digits with the usual separators and are skipped when they are a date or part of an IBAN; card numbers must pass the Luhn checksum and are skipped inside IBANs.\n- Verification: the text of the finished PDF is extracted again with pdftotext and every term and pattern is searched; the report lists matches before and after. Only \"0 after\" for every row means the text-level redaction succeeded.\n\nText inside images (scans, screenshots) and text drawn as outlines cannot be found by search; use areas for those, and always review the redacted pages visually before sharing.", "tags": [ "documents" ], "x-mcp-tool": "secure_pdf_redactor", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecurePdfRedactorInput" }, "examples": { "example1": { "summary": "Redact a name and e-mail addresses", "value": { "terms": [ "Alice Smith" ], "presets": [ "email" ], "file": { "filename": "contract.pdf", "contentType": "application/pdf", "contentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFszIDAgUiA1IDAgUl0gL0NvdW50IDIgPj4KZW5kb2JqCjMgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSA3IDAgUiA+PiA+PiAvQ29udGVudHMgNCAwIFIgPj4KZW5kb2JqCjQgMCBvYmoKPDwgL0xlbmd0aCAyMTcgPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiA3NDIgVGQgKEVtcGxveW1lbnQgY29udHJhY3QpIFRqIEVUCkJUIC9GMSAxNCBUZiA3MiA3MTIgVGQgKEVtcGxveWVlOiBBbGljZSBTbWl0aCkgVGogRVQKQlQgL0YxIDE0IFRmIDcyIDY4MiBUZCAoQ29udGFjdDogYWxpY2Uuc21pdGhAZXhhbXBsZS5jb20pIFRqIEVUCkJUIC9GMSAxNCBUZiA3MiA2NTIgVGQgKFNhbGFyeTogNTIsMDAwIEVVUikgVGogRVQKZW5kc3RyZWFtCmVuZG9iago1IDAgb2JqCjw8IC9UeXBlIC9QYWdlIC9QYXJlbnQgMiAwIFIgL01lZGlhQm94IFswIDAgNTk1IDg0Ml0gL1Jlc291cmNlcyA8PCAvRm9udCA8PCAvRjEgNyAwIFIgPj4gPj4gL0NvbnRlbnRzIDYgMCBSID4+CmVuZG9iago2IDAgb2JqCjw8IC9MZW5ndGggMTA0ID4+CnN0cmVhbQpCVCAvRjEgMjQgVGYgNzIgNzQyIFRkIChQYWdlIDIpIFRqIEVUCkJUIC9GMSAxNCBUZiA3MiA3MTIgVGQgKFNpZ25lZCBieSBBbGljZSBTbWl0aCBhbmQgQm9iIEpvbmVzKSBUaiBFVAplbmRzdHJlYW0KZW5kb2JqCjcgMCBvYmoKPDwgL1R5cGUgL0ZvbnQgL1N1YnR5cGUgL1R5cGUxIC9CYXNlRm9udCAvSGVsdmV0aWNhIC9FbmNvZGluZyAvV2luQW5zaUVuY29kaW5nID4+CmVuZG9iagp4cmVmCjAgOAowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMTUgMDAwMDAgbiAKMDAwMDAwMDA2NCAwMDAwMCBuIAowMDAwMDAwMTI3IDAwMDAwIG4gCjAwMDAwMDAyNTMgMDAwMDAgbiAKMDAwMDAwMDUyMSAwMDAwMCBuIAowMDAwMDAwNjQ3IDAwMDAwIG4gCjAwMDAwMDA4MDIgMDAwMDAgbiAKdHJhaWxlcgo8PCAvU2l6ZSA4IC9Sb290IDEgMCBSID4+CnN0YXJ0eHJlZgo4OTkKJSVFT0YK" } } }, "example2": { "summary": "Black out a fixed area on page 1", "value": { "areas": "1, 72, 160, 300, 30", "ocr": false, "file": { "filename": "contract.pdf", "contentType": "application/pdf", "contentBase64": "JVBERi0xLjQKJeLjz9MKMSAwIG9iago8PCAvVHlwZSAvQ2F0YWxvZyAvUGFnZXMgMiAwIFIgPj4KZW5kb2JqCjIgMCBvYmoKPDwgL1R5cGUgL1BhZ2VzIC9LaWRzIFszIDAgUiA1IDAgUl0gL0NvdW50IDIgPj4KZW5kb2JqCjMgMCBvYmoKPDwgL1R5cGUgL1BhZ2UgL1BhcmVudCAyIDAgUiAvTWVkaWFCb3ggWzAgMCA1OTUgODQyXSAvUmVzb3VyY2VzIDw8IC9Gb250IDw8IC9GMSA3IDAgUiA+PiA+PiAvQ29udGVudHMgNCAwIFIgPj4KZW5kb2JqCjQgMCBvYmoKPDwgL0xlbmd0aCAyMTcgPj4Kc3RyZWFtCkJUIC9GMSAyNCBUZiA3MiA3NDIgVGQgKEVtcGxveW1lbnQgY29udHJhY3QpIFRqIEVUCkJUIC9GMSAxNCBUZiA3MiA3MTIgVGQgKEVtcGxveWVlOiBBbGljZSBTbWl0aCkgVGogRVQKQlQgL0YxIDE0IFRmIDcyIDY4MiBUZCAoQ29udGFjdDogYWxpY2Uuc21pdGhAZXhhbXBsZS5jb20pIFRqIEVUCkJUIC9GMSAxNCBUZiA3MiA2NTIgVGQgKFNhbGFyeTogNTIsMDAwIEVVUikgVGogRVQKZW5kc3RyZWFtCmVuZG9iago1IDAgb2JqCjw8IC9UeXBlIC9QYWdlIC9QYXJlbnQgMiAwIFIgL01lZGlhQm94IFswIDAgNTk1IDg0Ml0gL1Jlc291cmNlcyA8PCAvRm9udCA8PCAvRjEgNyAwIFIgPj4gPj4gL0NvbnRlbnRzIDYgMCBSID4+CmVuZG9iago2IDAgb2JqCjw8IC9MZW5ndGggMTA0ID4+CnN0cmVhbQpCVCAvRjEgMjQgVGYgNzIgNzQyIFRkIChQYWdlIDIpIFRqIEVUCkJUIC9GMSAxNCBUZiA3MiA3MTIgVGQgKFNpZ25lZCBieSBBbGljZSBTbWl0aCBhbmQgQm9iIEpvbmVzKSBUaiBFVAplbmRzdHJlYW0KZW5kb2JqCjcgMCBvYmoKPDwgL1R5cGUgL0ZvbnQgL1N1YnR5cGUgL1R5cGUxIC9CYXNlRm9udCAvSGVsdmV0aWNhIC9FbmNvZGluZyAvV2luQW5zaUVuY29kaW5nID4+CmVuZG9iagp4cmVmCjAgOAowMDAwMDAwMDAwIDY1NTM1IGYgCjAwMDAwMDAwMTUgMDAwMDAgbiAKMDAwMDAwMDA2NCAwMDAwMCBuIAowMDAwMDAwMTI3IDAwMDAwIG4gCjAwMDAwMDAyNTMgMDAwMDAgbiAKMDAwMDAwMDUyMSAwMDAwMCBuIAowMDAwMDAwNjQ3IDAwMDAwIG4gCjAwMDAwMDA4MDIgMDAwMDAgbiAKdHJhaWxlcgo8PCAvU2l6ZSA4IC9Sb290IDEgMCBSID4+CnN0YXJ0eHJlZgo4OTkKJSVFT0YK" } } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SecurePdfRedactorResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/form-translator/calculate": { "post": { "operationId": "calculateFormTranslator", "summary": "Plain-language help for confusing forms: field-by-field hints and jargon explained.", "description": "Paste or upload (incl. photo/OCR) an official, insurance or tax form in English or German. Form Translator detects the fields, recognises what kind of entry each needs (date, signature, checkbox, IBAN, tax ID …), explains jargon from a curated glossary of 160 terms and lists the documents you will probably need.\n\nMethodology:\n- Lines are scanned for field labels: \"Label:\" followed by blanks, labels next to fill lines (____ or ....), checkbox options (☐, □, [ ], ( )) and short label-only lines that contain a field keyword.\n- Each label is classified with keyword rules into field types (date, signature, checkbox, IBAN/bank, tax ID, ID/reference number, e-mail, phone, address, name, amount, marital status, nationality, place+date), each with a fixed fill-in hint.\n- Jargon is matched against an editorial glossary (160 English and German admin, tax, insurance, benefits, banking and legal terms incl. inflected German forms). Explanations are written by usefulweb.site editors, not generated.\n- Documents are listed when a sentence asks to attach/enclose/provide proof (beifügen, Nachweis, Kopie, Bescheinigung …), quoted verbatim, plus documents commonly requested for recognised glossary terms (marked as such).\n- IBANs found in the text are checked with the ISO 13616 mod-97 checksum (German IBANs must have 22 characters). A valid checksum does not prove the account exists.\n\nNot legal, tax or insurance advice. Explanations are editorial plain-language summaries for orientation and may not match the exact legal meaning in your country, contract or authority. The detection is rule-based and never complete; when in doubt, ask the issuing office.", "tags": [ "everyday" ], "x-mcp-tool": "form_translator", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FormTranslatorInput" }, "examples": { "example1": { "summary": "German Kindergeld-style application", "value": { "text": "Antrag auf Kindergeld\n\n1. Angaben zur antragstellenden Person\nName, Vorname: ______________________\nGeburtsdatum (TT.MM.JJJJ): __________\nSteuer-ID: ___________\nAnschrift (Straße, Hausnummer, PLZ, Ort): ____________________\nFamilienstand:\n☐ ledig ☐ verheiratet ☐ geschieden ☐ verwitwet\n\n2. Angaben zum Ehegatten / eingetragenen Lebenspartner\nName, Vorname: ______________\n\n3. Bankverbindung\nIBAN: DE89 3704 0044 0532 0130 00\nKontoinhaber: ______________\n\nBitte fügen Sie eine Kopie der Geburtsurkunde und ggf. eine Schulbescheinigung bei.\nIch versichere, dass meine Angaben vollständig und richtig sind.\nOrt, Datum: ____________ Unterschrift: ________________" } }, "example2": { "summary": "US health insurance enrollment", "value": { "text": "Health Plan Enrollment Form\n\nPolicyholder name: ____________\nDate of birth (MM/DD/YYYY): ________\nSocial Security Number: ___-__-____\nMarital status: [ ] Single [ ] Married [ ] Divorced\nDependents (name, DOB, relationship): ______________\nPrimary beneficiary: ______________\n\nPlan options: The Silver plan has a $2,000 deductible, 20% coinsurance and a $30 copay for primary care visits.\nDo you have a pre-existing condition? [ ] Yes [ ] No\n\nPlease attach a copy of your ID and proof of address.\nSignature of applicant: ______________ Date: ________" } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FormTranslatorResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/privacy-policy-decoder/calculate": { "post": { "operationId": "calculatePrivacyPolicyDecoder", "summary": "What a privacy policy says it collects, shares, sells and keeps — with quoted evidence.", "description": "Give the URL of a privacy policy or paste/upload its text (English or German). The decoder lists which data categories, purposes, sharing and sale practices, retention periods, user rights, laws (GDPR, CCPA/CPRA …), international transfer mechanisms and contacts the policy mentions, quotes the sentences, and points out topics it does not mention.\n\nMethodology:\n- The policy is split into sentences; every sentence is tested against fixed English and German keyword patterns for 7 sections: data collected, purposes, sharing & selling, rights, laws, international transfers and contact.\n- An item is \"mentioned\" when at least one sentence matches; up to 3 matching sentences are quoted. If every matching sentence contains a negation (\"we do not\", \"nicht\", \"keine\"), the item is marked as negated.\n- Sale of data is classified from sentences with sell/sale/verkaufen: negated sentences count as \"does not sell\", others as \"sells or may sell\"; both present = \"mixed statements\".\n- Retention periods are durations (e.g. \"7 years\", \"nach 7 Tagen\") found in sentences about retaining, storing or deleting data (incl. German separable verbs such as \"bewahren … auf\"); open-ended phrases like \"as long as necessary\" are flagged as vague.\n- Children's age thresholds are numbers in phrases like \"under the age of 13\" / \"unter 16 Jahren\". \"Not mentioned\" means no pattern matched — not that the practice does not happen.\n\nRule-based keyword analysis of the policy text, not legal advice and not a compliance audit. A policy can describe practices in wording these patterns miss, and what a company does may differ from what its policy says.", "tags": [ "internet" ], "x-mcp-tool": "privacy_policy_decoder", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PrivacyPolicyDecoderInput" }, "examples": { "example1": { "summary": "App privacy policy (English)", "value": { "text": "Privacy Policy\nWe collect your name, email address and phone number when you register. We also collect your precise location, IP address and advertising ID, and we use cookies and tracking pixels.\nWe use your information to provide our services, for analytics and for personalized advertising. We may share your information with advertising partners and data brokers. We may sell your personal information; California residents can opt out via the \"Do Not Sell or Share My Personal Information\" link (CCPA/CPRA).\nWe retain your data for as long as necessary to provide our services. Payment records are kept for 7 years.\nYou have the right to access, delete and correct your personal information. Our services are not directed to children under the age of 13.\nYour data may be transferred to the United States under Standard Contractual Clauses.\nContact: privacy@example-app.com" } }, "example2": { "summary": "Datenschutzerklärung (Deutsch)", "value": { "text": "Datenschutzerklärung\nVerantwortlicher im Sinne der DSGVO ist die Beispiel GmbH. Unseren Datenschutzbeauftragten erreichen Sie unter datenschutz@beispiel.de.\nWir verarbeiten Ihre E-Mail-Adresse, Ihre Anschrift und Zahlungsdaten zur Vertragserfüllung. Beim Besuch unserer Website wird Ihre IP-Adresse gespeichert und nach 7 Tagen gelöscht.\nWir setzen Cookies nur mit Ihrer Einwilligung ein. Eine Weitergabe an Dritte erfolgt nur an Dienstleister im Rahmen der Auftragsverarbeitung. Wir verkaufen Ihre Daten nicht.\nRechnungsdaten bewahren wir aufgrund gesetzlicher Pflichten 10 Jahre auf.\nSie haben das Recht auf Auskunft, Berichtigung, Löschung, Einschränkung der Verarbeitung, Datenübertragbarkeit und Widerspruch. Sie können Ihre Einwilligung jederzeit widerrufen und sich bei einer Aufsichtsbehörde beschweren." } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PrivacyPolicyDecoderResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/before-you-sign/calculate": { "post": { "operationId": "calculateBeforeYouSign", "summary": "Spot risky contract clauses (renewal, notice, liability, non-compete…) before you sign.", "description": "Paste, upload or link a contract, terms of service, lease or employment agreement in English or German. Before You Sign flags 19 kinds of clauses — auto-renewal, notice periods, minimum terms, termination fees, liability limits, indemnities, arbitration, non-competes, IP assignment, price escalation, penalties, guarantees, data sharing and unilateral changes — quotes each clause, extracts durations and amounts, and lists questions to ask.\n\nMethodology:\n- The contract is split into sentences (numbered clauses, bullets and § headings start new units).\n- Each sentence is tested against 19 clause categories, each with English and German regular-expression patterns (e.g. \"automatically renew\", \"verlängert sich stillschweigend\", \"Kündigungsfrist\", \"Vertragsstrafe\", \"hold harmless\").\n- Parameters are extracted from the matched sentence: durations (numbers or number words, incl. \"three months\"/\"drei Monate\"), percentages, money amounts, radius (km/miles), governing law and court venue.\n- Severity comes from a fixed, documented rule per category (e.g. notice period ≥ 3 months = high; non-compete ≥ 12 months or ≥ 50 km = high). It signals how much attention a clause deserves, not whether it is legal or enforceable.\n- Each category has fixed questions to ask before signing. Categories without any match are listed as \"not detected\" — absence of a match is not proof the clause is absent.\n\nNot legal advice. This is an automated, rule-based text analysis that can miss or misread clauses; it never claims completeness. For decisions with legal or financial consequences, ask a qualified professional (e.g. a lawyer, tax adviser or consumer advice centre).", "tags": [ "high-value" ], "x-mcp-tool": "before_you_sign", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BeforeYouSignInput" }, "examples": { "example1": { "summary": "SaaS subscription terms (English)", "value": { "text": "1. Term. The initial term of this Agreement is 24 months. Thereafter, this Agreement shall automatically renew for successive 12-month periods unless either party provides at least 90 days' prior written notice of non-renewal.\n2. Fees. Provider may increase the fees at any time at its sole discretion. Overdue amounts bear interest at 1.5% per month.\n3. Early termination. If Customer terminates before the end of the initial term, all remaining fees for the term become immediately due.\n4. Liability. In no event shall Provider be liable for any indirect or consequential damages; Provider's aggregate liability is limited to the fees paid in the last 3 months.\n5. Customer shall indemnify and hold harmless Provider from any and all claims arising from Customer's use of the service.\n6. Disputes. Any dispute shall be resolved by binding arbitration, and Customer waives any right to participate in a class action. This Agreement is governed by the laws of the State of Delaware.\n7. Provider reserves the right to modify these terms at any time; continued use constitutes acceptance." } }, "example2": { "summary": "Arbeitsvertrag mit Wettbewerbsverbot (Deutsch)", "value": { "text": "§ 2 Vertragsdauer\nDas Arbeitsverhältnis wird auf unbestimmte Zeit geschlossen. Die Kündigungsfrist beträgt drei Monate zum Quartalsende.\n§ 7 Wettbewerbsverbot\nDer Arbeitnehmer verpflichtet sich, für die Dauer von 24 Monaten nach Beendigung des Arbeitsverhältnisses in einem Umkreis von 100 km nicht für ein Konkurrenzunternehmen tätig zu werden. Für jeden Fall der Zuwiderhandlung ist eine Vertragsstrafe in Höhe von 10.000 EUR zu zahlen.\n§ 8 Verschwiegenheit\nDer Arbeitnehmer ist verpflichtet, über alle Betriebsgeheimnisse auch nach Beendigung des Arbeitsverhältnisses zeitlich unbegrenzt Stillschweigen zu bewahren.\n§ 9 Arbeitsergebnisse\nDer Arbeitnehmer überträgt dem Arbeitgeber sämtliche Nutzungsrechte an allen Arbeitsergebnissen zeitlich und räumlich unbeschränkt.\n§ 12 Schlussbestimmungen\nEs gilt deutsches Recht. Gerichtsstand ist München." } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BeforeYouSignResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/what-changed-in-this-law/calculate": { "post": { "operationId": "calculateWhatChangedInThisLaw", "summary": "Compare two versions of a law or regulation section by section, with changed numbers and deadlines.", "description": "Paste (or link) the old and new versions of a law, regulation, terms of service or policy. The text is split at §, Art. and Section headings, sections are aligned by their number, and every added, removed or modified section is shown with a word-level diff and the numbers, durations and obligation words (must/may/muss/kann…) that changed.\n\nMethodology:\n- Sections start at lines beginning with §, Art./Artikel/Article, Section/Sec. or Paragraph followed by a number; text before the first heading is the preamble.\n- Sections are aligned by their normalised number (LCS over section ids), so renumbered sections show as removed + added.\n- Inside a changed section a word-level LCS diff is computed; numbers, money amounts, percentages, durations and obligation words (must/shall/may, muss/kann/soll/darf…) present in only one version are listed.\n- Whitespace-only differences are ignored.\n\nNot legal advice. This is an automated, rule-based text analysis that can miss or misread clauses; it never claims completeness. For decisions with legal or financial consequences, ask a qualified professional (e.g. a lawyer, tax adviser or consumer advice centre). Always check the official consolidated text and the amending act for transitional provisions.", "tags": [ "high-value" ], "x-mcp-tool": "what_changed_in_this_law", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WhatChangedInThisLawInput" }, "examples": { "example1": { "summary": "Notice period shortened", "value": { "oldText": "§ 1 Scope\nThis act applies to consumer contracts.\n§ 2 Notice\nThe customer must give notice of termination at least 3 months before the end of the term.\n§ 3 Fees\nA processing fee of 25 EUR may be charged.", "newText": "§ 1 Scope\nThis act applies to consumer contracts.\n§ 2 Notice\nThe customer may give notice of termination at any time with a notice period of 1 month.\n§ 3 Fees\nA processing fee of 25 EUR may be charged.\n§ 4 Online cancellation\nProviders must offer a cancellation button on their website.", "citation": "Example amendment act", "effectiveDate": "2026-12-01" } }, "example2": { "summary": "German: Frist geändert", "value": { "oldText": "§ 5 Frist\nDer Antrag ist innerhalb von 14 Tagen zu stellen.\n§ 6 Gebühr\nDie Gebühr beträgt 50 Euro.", "newText": "§ 5 Frist\nDer Antrag ist innerhalb von 30 Tagen zu stellen.\n§ 6 Gebühr\nDie Gebühr beträgt 50 Euro." } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WhatChangedInThisLawResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/compatibility-engine/calculate": { "post": { "operationId": "calculateCompatibilityEngine", "summary": "Will this charger, cable, version or PC part work together? Rule-based checks with margins.", "description": "Three deterministic checks: (1) USB-C charging – the real maximum power from charger, cable and device per the USB Power Delivery rules; (2) software versions – whether versions satisfy an npm-style semver range (^, ~, x-ranges, hyphen ranges, ||); (3) PC builds – CPU socket, RAM generation, slots and power-supply headroom.\n\nMethodology:\n- Charging: with USB PD on both sides the standard power range allows 5/9/15/20 V at 3 A (≤ 60 W with a standard cable) and 20 V at 5 A (≤ 100 W) with a 5 A e-marked cable; above 100 W (28/36/48 V, ≤ 240 W) needs charger, device AND cable to support PD 3.1 EPR. Without PD on both sides the assumed ceiling is USB-C 5 V / 3 A = 15 W. Expected maximum = minimum of charger, device and that limit.\n- Semver: npm range semantics (^ caret, ~ tilde, x-ranges, hyphen ranges, || alternatives, comparator sets); prereleases only match ranges that mention a prerelease of the same version.\n- PC: sockets must match exactly (case-insensitive); RAM generation must match; modules ≤ slots; recommended PSU = (CPU + GPU + other) × (1 + headroom%).", "tags": [ "high-value" ], "x-mcp-tool": "compatibility_engine", "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompatibilityEngineInput" }, "examples": { "example1": { "summary": "140 W laptop on a 100 W charger", "value": { "mode": "charging", "chargerW": 100, "chargerPd": true, "deviceW": 140, "devicePd": true, "deviceEpr": true, "cable": "usb-c-3a" } }, "example2": { "summary": "Node.js engine range", "value": { "mode": "semver", "range": "^18.17.0 || >=20.5.0", "versions": [ "18.16.1", "18.20.4", "20.4.0", "20.11.1", "22.0.0-rc.1", "22.1.0" ] } }, "example3": { "summary": "AM5 gaming PC", "value": { "mode": "pc", "cpuSocket": "AM5", "boardSocket": "AM5", "ramType": "DDR5", "boardRamType": "DDR5", "ramModules": 2, "boardSlots": 4, "cpuW": 120, "gpuW": 285, "otherW": 75, "psuW": 650 } } } } } }, "responses": { "200": { "description": "Calculation result envelope.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CompatibilityEngineResult" } } } }, "400": { "description": "Malformed JSON body.", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "422": { "description": "Invalid input (see errors[]).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } }, "429": { "description": "Rate limit exceeded (see Retry-After).", "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/Problem" } } } } } } }, "/api/v1/tools/accessibility-fixer/calculate": { "post": { "operationId": "calculateAccessibilityFixer", "summary": "Turn WCAG 2.2 problems in your HTML into concrete code fixes, grouped by effort.", "description": "Paste HTML or enter a URL and get a fix list: for every detected accessibility problem the tool shows the offending element, a corrected version generated from it (alt text, labels, lang, names, heading levels, table headers…) and how much work it is. Placeholders that need human judgement are marked TODO, and a patch-style diff is included.\n\nMethodology:\n- Runs the same static rule set as Accessibility Snapshot (WCAG 2.2 mapping verified against the W3C Recommendation).\n- Each fix is generated from the actual element: the original start tag is re-serialised with the needed attribute added, changed or removed (e.g. alt, aria-label, lang, id +