SignNow MCP Server
A MCP server that gives AI agents access to SignNow eSignature workflows over STDIO.
Versions
0.3.1Tools 25
list_all_templates Get all templates and template groups from all folders. This tool combines both individual templates and template groups into a single response. Individual templates are marked with entity_type='template' and template groups with entity_type='template_group'. Supports pagination via limit/offset parameters. Note: Individual templates are deprecated. For new implementations, prefer using template groups which are more feature-rich and actively maintained. Args: limit: Maximum number of items to return (1-100, default 50) offset: Number of items to skip for pagination (default 0)
list_documents Provide simplified list of documents and document groups with basic fields. This tool retrieves both individual documents and document groups from SignNow, presenting them all in a unified format. If you need a list of documents or a list of document groups, this is the right tool to use. You can also use it to fetch specific lists like documents waiting for your signature (waiting-for-me) or expired documents (expired_filter=expired). Supports pagination via limit/offset parameters. Args: filter: Filter by document group status (optional) sortby: Sort by created date, updated date, or document name (optional) order: Order of sorting (optional, requires sortby) folder_id: Filter by folder ID (optional) expired_filter: Filter by invite expiredness (optional, default: all) limit: Maximum number of items to return (1-100, default 50) offset: Number of items to skip for pagination (default 0)
send_invite Send invite to sign a document, document group, template, or template group. When entity_type is 'template' or 'template_group', this tool automatically: 1. Creates a document/group from the template (create_from_template) 2. Sends an invite to the created entity For direct document/document_group calls the invite is sent immediately. The entity type is auto-detected if not provided. Note: If the document has no fields, a freeform invite is sent automatically. In that case, ``role`` on each recipient is optional and ignored. For document groups, role presence is checked per document — if no documents have roles, a freeform group invite is sent instead. When sender and recipient emails match, SendInviteResponse.link is populated with a direct signing link so the sender can sign without checking their inbox. Self-sign shortcut: pass ``self_sign=True`` (and omit ``orders``) to sign the document yourself. The tool resolves your primary email, sends a freeform invite with you as the sole recipient, and returns a SendInviteResponse whose ``link`` field holds a ready-to-open signing link. Only valid for field-less documents/groups — field entities should use create_embedded_sending. Args: entity_id: ID of the document, document group, template, or template group orders: List of orders with recipients. Required unless self_sign=True. preview_was_shown: Prompt the user to view the document first. True if shown, False to skip. entity_type: Type of entity (optional, auto-detected if not provided). name: Optional name for the new document or document group (template flows only) self_sign: If True, self-sign the document using the current user's email. Returns: SendInviteResponse with invite details. ``link`` is populated when self-signing or when recipient email equals the sender's email.
create_embedded_invite Create embedded invite for signing a document, document group, template, or template group. When entity_type is 'template' or 'template_group', this tool automatically: 1. Creates a document/group from the template (create_from_template) 2. Creates an embedded invite for the created entity For direct document/document_group calls the invite is created immediately. The entity type is auto-detected if not provided. Args: entity_id: ID of the document, document group, template, or template group orders: List of orders with recipients. entity_type: Type of entity (optional, auto-detected if not provided). name: Optional name for the new document or document group (template flows only) Returns: CreateEmbeddedInviteResponse with invite details; created_entity_* fields populated for template flows
create_embedded_sending Create embedded sending for managing, editing, or sending invites for a document, document group, template, or template group. When entity_type is 'template' or 'template_group', this tool automatically: 1. Creates a document/group from the template (create_from_template) 2. Creates an embedded sending for the created entity For direct document/document_group calls the sending is created immediately. The entity type is auto-detected if not provided. Args: entity_id: ID of the document, document group, template, or template group entity_type: Type of entity (optional, auto-detected if not provided). name: Optional name for the new document or document group (template flows only) redirect_uri: Optional redirect URI for the sending link redirect_target: Optional redirect target for the sending link link_expiration_minutes: Link lifetime in minutes (15–45). Default: 15 min. type: Specifies the sending step: 'manage' (default), 'edit', 'send-invite' Returns: CreateEmbeddedSendingResponse with sending details; created_entity_* fields populated for template flows
create_embedded_editor Create embedded editor for editing a document, document group, template, or template group. When entity_type is 'template' or 'template_group', this tool automatically: 1. Creates a document/group from the template (create_from_template) 2. Creates an embedded editor for the created entity For direct document/document_group calls the editor is created immediately. The entity type is auto-detected if not provided. Args: entity_id: ID of the document, document group, template, or template group entity_type: Type of entity (optional, auto-detected if not provided). name: Optional name for the new document or document group (template flows only) redirect_uri: Optional redirect URI for the editor link redirect_target: Optional redirect target for the editor link link_expiration_minutes: Link lifetime in minutes (15–43200). Default: 15 min. Returns: CreateEmbeddedEditorResponse with editor details; created_entity_* fields populated for template flows
create_template Convert an existing document or document group into a reusable template. Call this when no suitable template yet exists and the user wants to send their document for signing. After creation, use the returned template_id with send_invite_from_template or create_embedded_sending_from_template. If entity_type is omitted, auto-detects: tries document_group first, then document. Pass entity_type explicitly when you already know the type to save one API call. For document groups, template creation is asynchronous — template_id will be None. Use list_all_templates after a short delay to retrieve the ID. Args: entity_id: ID of the document or document group to templatize. template_name: Name for the new template. entity_type: Optional. 'document' | 'document_group' | None (auto-detect). Returns: CreateTemplateResult with template_id (None for async doc group path), template_name, and entity_type.
create_from_template Create a new document or document group from an existing template or template group. Args: entity_id: ID of the template or template group entity_type: Type of entity: 'template' or 'template_group' (optional). If you're passing it, make sure you know what type you have. If it's not found, try using a different type. name: Optional name for the new document group or document (required for template groups) Returns: CreateFromTemplateResponse with created entity ID, type and name
get_invite_status get_document_download_link Get download link for a document or document group. For documents: Returns direct download link. For document groups: Merges all documents in the group and returns download link for the merged document. Args: entity_id: ID of the document or document group entity_type: Type of entity: 'document' or 'document_group' (optional). If you're passing it, make sure you know what type you have. If it's not found, try using a different type. Returns: DocumentDownloadLinkResponse with download link
get_signing_link Get signing link for a document or document group. Args: entity_id: ID of the document or document group entity_type: Type of entity: 'document' or 'document_group' (optional). If you're passing it, make sure you know what type you have. If it's not found, try using a different type. Returns: SigningLinkResponse with signing link
get_document Get full document, template, template group or document group information with field values. Always returns a unified DocumentGroup wrapper even for a single document. This tool retrieves complete information about a document, template, template group or document group, including all field values, roles, and metadata. If entity_type is not provided, the tool will automatically determine whether the entity is a document, template, template group or document group. For documents, returns a DocumentGroup with a single document. For templates, returns a DocumentGroup with a single template. For template groups, returns a DocumentGroup with all templates in the group. For document groups, returns a DocumentGroup with all documents in the group. Args: entity_id: ID of the document, template, template group or document group to retrieve entity_type: Type of entity: 'document', 'template', 'template_group' or 'document_group' (optional) Returns: DocumentGroup with complete information including field values for all documents
update_document_fields Update text fields in multiple documents. This tool updates text fields in multiple documents using the SignNow API. Only text fields can be updated using the prefill_text_fields endpoint. IMPORTANT: This tool works only with individual documents, not document groups. To find out what fields are available in a document or document group, use the get_document tool first. Args: update_requests: Array of UpdateDocumentFields with document IDs and fields to update Returns: UpdateDocumentFieldsResponse with results for each document update
upload_document Upload a document to SignNow. Provide exactly one of: resource_uri, file_path, or file_url. Supported formats: PDF, DOC, DOCX, PNG, JPG, JPEG. Max file size: 40 MB. Preferred source order: 1. resource_uri — if the user @-attached a file in their MCP client 2. file_path — if the user provided a local path 3. file_url — if the user provided a public URL After upload, load the 'signnow101' skill for guidance on next steps. Primary suggestions (present in this order): 1. Prepare a role-based invite (create_embedded_sending) 2. Send for signing as a freeform invite (send_invite with recipient email) 3. Sign the document yourself (send_invite with self_sign=True) Secondary suggestion (only if the user hints at reuse): - Turn the document into a reusable template (create_embedded_editor) Args: ctx: FastMCP context (injected) resource_uri: MCP resource URI from an attached file file_path: Local file path (absolute or ~-relative) file_url: Public URL to the file filename: Optional custom document name in SignNow
send_invite_reminder Send a signing reminder to pending signers on a document or document group. Auto-detects entity type by trying GET /documentgroup/{id} (v2) first (modern), then GET /document/{id} as legacy fallback. Non-404 errors propagate immediately. For documents: resends each pending field invite via PUT /fieldinvite/{id}/resend. For document groups: resends the group invite to each pending signer via POST /documentgroup/{id}/groupinvite/{invite_id}/resendinvites. Skips signers whose invite is already completed or cancelled (reported in 'skipped'). API failures are reported in 'failed' and can be retried. The resend reuses each invite's original email template, so 'subject' and 'message' are accepted for backward compatibility but NOT applied — do not rely on them to customize the reminder. Tip: if entity_type is known, pass it explicitly to avoid an extra auto-detection GET. Tip: use list_documents first to discover document IDs by name or criteria. Args: entity_id: Document ID or document group ID. entity_type: Optional discriminator ('document' or 'document_group'). email: Optional — target a single recipient. subject: Ignored — resend reuses the original template. Accepted for compatibility only. message: Ignored — resend reuses the original template. Accepted for compatibility only. Returns: SendReminderResponse with entity_id, entity_type, recipients_reminded, skipped, failed.
cancel_invite Cancel all active (pending) signing invites on a document or document group. Auto-detects entity type when not provided by trying document_group first, then document. Detects invite type (field vs freeform) automatically. If all invites are already completed, returns status='completed'. If no invite was ever sent, returns status='invite_not_sent'. Otherwise cancels pending invites and returns status='cancelled'. Args: entity_id: ID of the document or document group. entity_type: Optional discriminator ('document' or 'document_group'). reason: Optional cancellation reason forwarded to SignNow API. Returns: CancelInviteResponse with entity_id, entity_type, status, cancelled_invite_ids.
update_invite_recipient Replace the signing recipient on a pending field invite. Supports both documents and document groups: Documents: 1. Finds the pending/created field invite matching current_email (and optional role) 2. Deletes the old invite, creates a replacement for new_email 3. Triggers sending to the new signer Document Groups: 1. Finds pending steps with actions matching current_email (and optional role) 2. Updates each step via /invitestep/{step_id}/update endpoint 3. Returns list of updated step IDs Only field invites are supported. Freeform and embedded invites return status='unsupported_invite_type'. Args: entity_id: Document or document group ID. current_email: Email of the current signer to replace. new_email: Email of the new signer. entity_type: Optional entity type discriminator. role: Optional role filter for multi-role documents/steps. Returns: UpdateInviteRecipientResponse with status, new_invite_id, email info, and updated_steps (for document groups).
view_document Generate a read-only embedded view link for a document or document group. Calls POST /v2/documents/{id}/embedded-view or POST /v2/document-groups/{id}/embedded-view. No SignNow login required to open the link. Auto-detects entity type when omitted. Tip: use list_documents first to discover document IDs by name or criteria. Tip: if entity_type is known, pass it explicitly to avoid an extra auto-detection GET. Args: entity_id: Document ID or document group ID. entity_type: Optional discriminator ('document' or 'document_group'). link_expiration_minutes: Optional link lifetime in minutes (43200–518400). Returns: ViewDocumentResponse with view_link, document_name, entity_id, entity_type.
list_contacts Search CRM contacts by name, email, or phone. Returns a curated list of contacts with id, email, first_name, last_name, and company. When ``query`` is provided, performs a partial (LIKE) match against email, first name, last name, full name, and phone simultaneously. When no contacts match, an empty list is returned — this is not an error. Args: query: Partial name, email, or phone string to filter contacts. Omit to return the first per_page contacts. per_page: Maximum number of contacts to return (1–100, default 15).
rename_entity Rename a document, document group, template, or template group. When entity_type is omitted, the type is auto-detected via waterfall: document_group → template_group → template → document. Args: entity_id: ID of the entity to rename. new_name: New name to apply. entity_type: Entity type discriminator. Optional — auto-detected when omitted. Returns: RenameEntityResponse with entity_id, entity_type, and new_name.
send_invite_from_template Create from template then send invite (v1.0 compound tool). Two-step workflow: 1. Create document/group from template via _create_from_template. 2. Send invite on the created entity via _send_invite. Args: entity_id: ID of the template or template group. orders: List of orders with recipients (list or JSON string). entity_type: Type of entity (optional, auto-detected if not provided). name: Optional name for the created document or document group. Returns: SendInviteFromTemplateResponse with both created entity info and invite details.
create_embedded_sending_from_template Create from template then create embedded sending (v1.0 compound tool). Two-step workflow: 1. Create document/group from template via _create_from_template. 2. Create embedded sending on the created entity via _create_embedded_sending. The link_expiration parameter is in minutes (15–45), matching the downstream SignNow embedded sending request models (ge=15). Args: entity_id: ID of the template or template group. entity_type: Type of entity (optional, auto-detected if not provided). name: Optional name for the created document or document group. redirect_uri: Optional redirect URI after completion. redirect_target: Optional redirect target. link_expiration: Link expiration in minutes (15–45). type: Sending step type: 'manage', 'edit', or 'send-invite'. Returns: CreateEmbeddedSendingFromTemplateResponse with entity info and sending details.
create_embedded_editor_from_template Create from template then create embedded editor (v1.0 compound tool). Two-step workflow: 1. Create document/group from template via _create_from_template. 2. Create embedded editor on the created entity via _create_embedded_editor. Args: entity_id: ID of the template or template group. entity_type: Type of entity (optional, auto-detected if not provided). name: Optional name for the created document or document group. redirect_uri: Optional redirect URI after completion. redirect_target: Optional redirect target. link_expiration: Link expiration in minutes (15–45). Returns: CreateEmbeddedEditorFromTemplateResponse with entity info and editor details.
create_embedded_invite_from_template Create from template then create embedded invite (v1.0 compound tool). Two-step workflow: 1. Create document/group from template via _create_from_template. 2. Create embedded invite on the created entity via _create_embedded_invite. Args: entity_id: ID of the template or template group. orders: List of orders with recipients (list or JSON string). entity_type: Type of entity (optional, auto-detected if not provided). name: Optional name for the created document or document group. Returns: CreateEmbeddedInviteFromTemplateResponse with entity info and invite details.
signnow_skills Query the bundled SignNow skill library. When called without arguments, returns a list of all available skills with their names and one-line descriptions (skills field populated). When called with skill_name, returns the full Markdown body of that skill, front-matter stripped (name and body fields populated). Use signnow101 first if you are unfamiliar with SignNow entity types, workflow actions, or which tool to call for a given task.
Permissions 4
network Server uses network capabilities via: httpx, urllib filesystem Server uses filesystem capabilities via: os, pathlib shell Server uses shell capabilities via: subprocess env_vars Server uses env_vars capabilities via: os.environ, os.getenv()