io.github.assinafy/mcp-server

Tools

• assinafy_create_assignment

  Request signatures on a document. Use `method: virtual` to sign without input fields, or `method: collect` to place input fields on specific pages. For **virtual**, the document may be in `uploaded`, `metadata_processing` or `metadata_ready`; it is promoted to `pending_signature` automatically once metadata processing completes. For **collect**, the document must be in `metadata_ready` (fields reference specific pages). `step` controls signing order: signers sharing a step sign in parallel, and the next step is notified only after the previous step completes. If supplied, every signer must supply it and values must be contiguous starting at 1. Obtain signer IDs from assinafy_list_signers or assinafy_create_signer and page IDs from assinafy_get_document. This sends signing invitations. Check with assinafy_get_document that no assignment exists first; this can consume credits.

  shallow
• assinafy_create_document_from_template

  Generate a document from a saved template and invite one signer per role, by signer ID or full name and email. Find roles with assinafy_list_templates and validate editor_fields values with assinafy_validate_fields first. This sends invitations and can consume credits.

  shallow
• assinafy_create_signer

  Create a signer in the workspace. Search with assinafy_list_signers first to avoid duplicates. Sends no invitation.

  shallow
• assinafy_delete_document

  Delete a document only when the user's instruction explicitly authorizes deletion. Inspect its current state first; Assinafy enforces which documents may be deleted.

  shallow
• assinafy_download_document

  Download a document artifact as base64: original (default), certificated, certificate-page, pades or bundle. Download the signed PDF only when the document is certificated and the artifact is listed.

  shallow
• assinafy_download_document_page

  Download the rendered image of a specific document page. Use a page_id returned by assinafy_get_document. Returns base64.

  shallow
• assinafy_get_document

  Inspect one known document: status, assignment, signers with their progress, pages and available artifacts. Read it before retrying a send or following up. 100% signed does not mean certification is finished; the signed PDF is ready at status certificated.

  shallow
• assinafy_get_field

  Retrieve a single field definition.

  shallow
• assinafy_get_signer

  Retrieve a signer's information.

  shallow
• assinafy_get_template

  Get one saved template with its roles and field placements.

  shallow
• assinafy_list_document_activities

  List the activities recorded for a document. Each entry carries an event-specific `payload` snapshot (keys vary per event) and the request `origin` (`ip`, `user-agent`). Use it to explain what happened to a document and when.

  shallow
• assinafy_list_documents

  Search workspace documents by name or status, with pagination. Use it to find a document the user names before inspecting or following up on it.

  shallow
• assinafy_list_fields

  List the field definitions of a workspace. When `include_standard` is enabled, records of type `signature`, `initial` and `signatureDate` are also returned. Match definitions to template placement field_id and ask about ambiguous names.

  shallow
• assinafy_list_signers

  List the signers of a workspace. Use it to resolve a recipient to a signer ID; ask the user about ambiguous matches before sending.

  shallow
• assinafy_list_templates

  List saved templates with their signer roles, pages and field placements (field_id). Template authoring is done in Assinafy.

  shallow
• assinafy_list_whatsapp_notifications

  List all WhatsApp notification messages sent for an assignment. The response includes the rendered template text split into `header`, `body` and `buttons` — exactly what the signer would see. In sandbox/stage, WhatsApp messages are simulated (no real delivery) and button URLs include access/verification codes you can use to simulate the signing flow. Treat returned signing links and verification codes as sensitive; never use them to sign for another person. Use it to troubleshoot WhatsApp delivery for one assignment.

  shallow
• assinafy_place_fields

  Open a visual editor to place signature, initials, date and input fields on a metadata_ready document, then send it with method collect. Takes the assinafy_create_assignment arguments except method and entries. Sends nothing by itself: in apps-capable hosts the user places fields and presses Send; other clients get page sizes and field IDs as text to build entries.

  shallow
• assinafy_rename_document

  Update a document's name. Only allowed before any assignment is created (i.e. while the document is in `uploaded` or `metadata_ready` status and has no signers yet); once the signature process has started or the document is certificated, the name is locked. The name is normalized: diacritics are removed and unsupported characters are replaced with dashes.

  shallow
• assinafy_resend_notification

  Send one reminder to a pending signer in the assignment's active step, after confirming with assinafy_get_document that they have not signed. May consume notification credits; never repeat a reminder only because progress is unchanged.

  shallow
• assinafy_review_signature_request

  Preview an assinafy_create_assignment call without sending anything: same arguments, checked against the document and signers. Use it when the user wants to review before sending. Apps-capable hosts render a card whose Send button performs the request; other clients get the summary as text, and the request is sent only after the user confirms.

  shallow
• assinafy_send_pdf_for_signature

  Upload a new PDF, wait for processing and invite signers by full name and email, using Email verification and notification. This sends invitations and uses plan allowance: use only recipients the user authorized. After a partial failure, inspect the retained document ID and continue with assinafy_create_assignment instead of uploading again.

  shallow
• assinafy_set_assignment_expiration

  Change when an existing signature request expires, using an RFC 3339 timestamp. Assinafy may refuse for requests that already expired.

  shallow
• assinafy_show_document

  Show a status card for one known document: its status, who has signed, who is still pending and when it expires. Apps-capable hosts render it with a reminder button; other clients get the same summary as text. Resolve the document with assinafy_list_documents first.

  shallow
• assinafy_update_signer

  Update a signer's information. **Verification integrity:** `email` / `whatsapp_phone_number` cannot be changed while the signer has verified that channel on an in-flight (not yet certificated) document — the response is `400` naming the offending document(s). Already-certificated documents do not block updates. Changing a channel that has *unverified* in-flight requests rotates their access/verification codes (invalidating previously sent links/OTPs); use the resend endpoint to redeliver. `full_name` can always be updated.

  shallow
• assinafy_upload_document

  Upload a PDF without sending invitations and return its document ID. Use it when the user wants to prepare a document now and send it later with assinafy_create_assignment. Never upload again when a document ID is already known.

  shallow
• assinafy_validate_fields

  Validate one or more input values against existing field definitions without creating a document or requesting signatures. Supply field/value pairs in values; the server sends the documented JSON array. Check each result's success before requesting signatures.

  shallow
• assinafy_verify_document

  Verify a signed document using its actual Assinafy SHA-1 signature hash. Public lookup; requires no workspace connection and sends no credential upstream.

  shallow

Embed this server’s score

Tool count and median score across every tool in this server’s corpus — honest in a way a single cherry-picked tool’s badge wouldn’t be.

[![Vouch score](https://vouch.tools/api/servers/e79ac110-41b6-4eea-ba1d-2e0e8d516eb5/badge.svg)](https://vouch.tools/servers/e79ac110-41b6-4eea-ba1d-2e0e8d516eb5)