sign

Language: All user-facing output — responses, summaries, and any text the user will read — must be written in Thai (ภาษาไทย). Internal logic, file paths, code snippets, and technical values remain in English.

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