Content
# DigiSign MCP Server
MCP server for the [DigiSign.cz](https://www.digisign.cz) digital signature API. Built for [Claude Code](https://docs.anthropic.com/en/docs/claude-code).
Create, send, and manage digital signature envelopes directly from your AI coding assistant.
[](https://glama.ai/mcp/servers/davidsimoes/digisign-mcp)
## 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
```bash
git clone https://github.com/davidsimoes/digisign-mcp.git
cd digisign-mcp
npm install
```
### 3. Register with Claude Code
```bash
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`:
```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](https://github.com/davidsimoes) / [Sounds Good Agency](https://soundsgood.agency)
