Create, send, and manage digital signature envelopes via DigiSign.cz API.
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
create_envelope— create a draftupload_and_attach_document— attach the PDFadd_recipient— add signers (mobile number required for SMS auth)add_signature_tag— place signature tagssend_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
Tools (15)
list_envelopesList envelopes with optional status or page filters.get_envelopeGet detailed envelope info including status, recipients, and documents.list_documentsList documents attached to a specific envelope.list_recipientsList recipients and their current signing status.list_tagsList signature or form tags placed on documents.get_download_urlGet a temporary download URL for signed documents.get_accountGet account information including credits, plan, and usage.create_envelopeCreate a new draft envelope.upload_and_attach_documentUpload a PDF or DOCX file and attach it to an envelope.add_recipientAdd a signer, approver, or CC recipient to an envelope.add_signature_tagPlace a signature or form tag using placeholder or coordinate positioning.send_envelopeSend an envelope for signing to all recipients.cancel_envelopeCancel a sent envelope and notify signers.delete_envelopeDelete a draft envelope.discard_envelopeDiscard a draft envelope.Environment Variables
DIGISIGN_ACCESS_KEYrequiredAccess key from DigiSign dashboardDIGISIGN_SECRET_KEYrequiredSecret key from DigiSign dashboardConfiguration
{"mcpServers": {"digisign": {"command": "node", "args": ["/path/to/digisign-mcp/src/index.js"], "env": {"DIGISIGN_ACCESS_KEY": "your_access_key", "DIGISIGN_SECRET_KEY": "your_secret_key"}}}}