docuseal-mcp-server

MCP server for DocuSeal (self-hosted or cloud) using stdio transport.

Package name: @caffeinebounce/docuseal-mcp-server

Features

Implements these MCP tools:

Templates

• list_templates — list templates (paginated)
• get_template — get template by ID
• create_template_from_pdf — upload PDF from file path or base64

Submissions

• create_submission — create signature request from template
• list_submissions — list submissions (paginated + status filter)
• get_submission — get submission details
• get_submission_documents — get documents for a submission (optional local download)

Submitters

• list_submitters — list submitters (optionally by submission)
• get_submitter — get submitter details
• update_submitter — update submitter fields (including reminder-style flags like send_email)

Requirements

• Node.js 18+
• A DocuSeal instance with API enabled
• API key with required permissions

Environment Variables

• DOCUSEAL_URL — base URL for DocuSeal (default: http://localhost:3030)
• DOCUSEAL_API_KEY — API key for X-Auth-Token header (required)

Example:

export DOCUSEAL_URL="http://localhost:3030"
export DOCUSEAL_API_KEY="<your-api-key>"

Install and Build

npm install
npm run build

Run

npm start

Or in development:

npm run dev

MCP Client Configuration (example)

{
  "mcpServers": {
    "docuseal": {
      "command": "node",
      "args": ["/absolute/path/to/docuseal-mcp-server/dist/index.js"],
      "env": {
        "DOCUSEAL_URL": "http://localhost:3030",
        "DOCUSEAL_API_KEY": "<your-api-key>"
      }
    }
  }
}

Notes

• API calls use fetch and include X-Auth-Token.
• API errors include HTTP status + response body in tool output for debugging.
• get_submission_documents can optionally download returned document URLs to disk using:
  • download: true
  • optional output_dir (default: ./downloads/submission_<id>)