docuseal

# DocuSeal App Skill

Manage document templates and e-signatures via the DocuSeal MCP endpoint.

## Setup

1. Enable MCP in DocuSeal settings (Settings > MCP)
2. Create an MCP token
3. Set environment variables:
   ```bash
   export DOCUSEAL_URL="https://your-docuseal-instance.com"
   export DOCUSEAL_MCP_TOKEN="your-mcp-token"
   ```

## Protocol

All requests use JSON-RPC 2.0 over HTTP POST to `$DOCUSEAL_URL/mcp`.

## Usage with scripts/mcp.js

Requires Node.js 18+. No dependencies.

```bash
node scripts/mcp.js init
node scripts/mcp.js ping
node scripts/mcp.js tools
node scripts/mcp.js search-templates --q="contract" --limit=5
node scripts/mcp.js create-template --url="https://example.com/document.pdf" --name="My Template"
node scripts/mcp.js create-template --file="$(base64 -i doc.pdf)" --filename="doc.pdf" --name="My Template"
node scripts/mcp.js send-documents --template-id=1 --emails="signer@example.com,another@example.com"
node scripts/mcp.js search-documents --q="john@example.com" --limit=5
```

## Commands Reference

### search-templates

Search document templates by name.

| Option | Type | Required | Description |
|---|---|---|---|
| `--q` | string | yes | Search query to filter templates by name |
| `--limit` | integer | no | The number of templates to return (default 10) |

### create-template

Create a template from a PDF. Provide a URL or base64-encoded file content.

| Option | Type | Required | Description |
|---|---|---|---|
| `--url` | string | no | URL of the document file to upload |
| `--file` | string | no | Base64-encoded file content |
| `--filename` | string | no | Filename with extension (required with `--file`) |
| `--name` | string | no | Template name (defaults to filename) |

Either `--url` or `--file` + `--filename` must be provided.

### send-documents

Send a document template for signing to specified submitters.

| Option | Type | Required | Description |
|---|---|---|---|
| `--template-id` | integer | yes | Template identifier |
|...