digisign-mcp

DigiSign MCP Server

MCP server for the DigiSign.cz digital signature API. Built for Claude Code.

Create, send, and manage digital signature envelopes directly from your AI coding assistant.


Setup

1. Get DigiSign API keys

In your DigiSign dashboard: Settings > Pro vyvojare > API klice. Create an API key pair (access key + secret key).

2. Install dependencies

git clone https://github.com/davidsimoes/digisign-mcp.git
cd digisign-mcp
npm install

3. Register with Claude Code

claude mcp add digisign \
  -e DIGISIGN_ACCESS_KEY=your_access_key \
  -e DIGISIGN_SECRET_KEY=your_secret_key \
  -- node /path/to/digisign-mcp/src/index.js

Tools

Read tools (safe to auto-approve)

| Tool | Description | |------|-------------| | list_envelopes | List envelopes with optional status/page filters | | get_envelope | Get detailed envelope info (status, recipients, documents) | | list_documents | List documents attached to an envelope | | list_recipients | List recipients and their signing status | | list_tags | List signature/form tags placed on documents | | get_download_url | Get temporary download URL for signed documents | | get_account | Get account info (credits, plan, usage) |

Write tools (recommend manual approval)

| Tool | Description | |------|-------------| | create_envelope | Create a new draft envelope | | upload_and_attach_document | Upload a PDF/DOCX and attach to an envelope | | add_recipient | Add a signer, approver, or CC recipient | | add_signature_tag | Place signature/form tag (placeholder or coordinate positioning) | | send_envelope | Send envelope for signing (emails all recipients) | | cancel_envelope | Cancel a sent envelope (notifies signers) | | delete_envelope | Delete a draft envelope | | discard_envelope | Discard a draft envelope (use when API key lacks delete permission) |

Safety recommendations

Add irreversible write tools to your deny list in ~/.claude/settings.local.json:

{
  "permissions": {
    "deny": [
      "mcp__digisign__send_envelope",
      "mcp__digisign__cancel_envelope",
      "mcp__digisign__delete_envelope",
      "mcp__digisign__discard_envelope"
    ]
  }
}

This ensures Claude Code prompts for confirmation before sending, cancelling, or deleting envelopes.

Safe preparation tools (create_envelope, upload_and_attach_document, add_recipient, add_signature_tag) can be added to the allow list since they only modify draft envelopes.

Signature tag positioning

Two approaches for placing signature tags on documents:

Placeholder-based (recommended)

Add invisible text markers in your document (e.g., white-colored text like {sign_here}). DigiSign finds them in the PDF text layer and positions the signature tag relative to them.

add_signature_tag(
  envelopeId: "...",
  recipientId: "...",
  documentId: "...",
  placeholder: "{sign_here}",
  positioning: "bottom_left",
  scale: 70
)

Important: DigiSign's placeholder regex only allows [\w\-\{\}\[\]\(\)=,] — no spaces or diacritics. Use simple ASCII placeholders like {sign_ceo}, {sign_client}.

Positioning: bottom_left places the signature box above the placeholder text (standard for contracts where the signature goes above the printed name). scale: 70 keeps the box compact.

Note: documentId is required even when using placeholder positioning.

Coordinate-based

Places tag at exact page coordinates (in points):

add_signature_tag(
  envelopeId: "...",
  recipientId: "...",
  documentId: "...",
  page: 5,
  xPosition: 320,
  yPosition: 680
)

Placeholder-based is more robust — it survives document layout changes.

Typical workflow

1. create_envelope — create a draft
2. upload_and_attach_document — attach the PDF
3. add_recipient — add signers (mobile number required for SMS auth)
4. add_signature_tag — place signature tags
5. send_envelope — send for signing

Requirements

• Node.js 18+
• DigiSign.cz account with API access
• Claude Code (or any MCP-compatible client)

License

MIT

---

Built by David Simoes / Sounds Good Agency