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