/sign

If you need to check which tools are connected, see CONNECTORS.md.

Sign PDF

Add a visual signature or initials to a document using an image annotation.

Disclaimer: This places your signature image on the page. It is not a certified or cryptographic digital signature. For legally binding e-signatures, use a dedicated signing service.

Workflow

1. Get the signature image — ask the user for a local file path (PNG/JPG) to their signature or initials. If they don't have one, suggest they create one and save it to a known path.

2. Open the PDF — display_pdf (or reuse existing viewUUID). Check the returned formFields for signature-type fields — they include page and bounding-box coordinates.

3. Locate the target — if there's a signature field, use its coordinates. Otherwise ask: "Which page, and where on the page? (e.g., bottom-right of page 3)"

4. Place it — interact → add_annotations:

   {"action": "add_annotations", "annotations": [
     {"id": "sig1", "type": "image", "page": 3,
      "imageUrl": "/path/to/signature.png",
      "x": 400, "y": 700, "width": 150}
   ]}
   

   Width/height auto-detected from the image if omitted.

5. Verify — follow with get_screenshot of that page. Show the user. Adjust position if needed via update_annotations.

6. Initials on every page — batch one image annotation per page in a single add_annotations call.

Tips

• imageUrl accepts local file paths or HTTPS URLs (no data: URIs)
• Users can also drag & drop the signature image directly onto the viewer
• Coordinate origin is top-left; a typical bottom-right signature on US Letter is around x: 400, y: 700
• Pair with /pdf-viewer:fill-form for complete form workflows