PDFGate MCP Server

Generate documents, process PDFs, and manage e-signature workflows using the PDFGate API.

Documentation

PDFGate MCP Server

Model Context Protocol (MCP) server for the PDFGate API. Enables AI assistants to generate PDFs, manage documents and handle e-signatures.

Installation

Add the following to your MCP client configuration:

{
  "mcpServers": {
    "pdfgate": {
      "command": "npx",
      "args": ["-y", "@pdfgate/mcp-server"],
      "env": {
        "PDFGATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

Getting an API key

Keys starting with live_ connect to the production environment
Keys starting with test_ connect to the sandbox environment

Tools

PDF Operations

Tool	Description
`generate_pdf`	Generate a PDF from a URL or raw HTML
`upload_pdf`	Upload a local PDF file or from a URL
`get_document`	Retrieve document metadata and a fresh download URL
`delete_document`	Delete a document
`flatten_pdf`	Flatten an interactive PDF into a static, non-editable file
`extract_pdf_form_data`	Extract form field values from a fillable PDF
`compress_pdf`	Compress a PDF to reduce file size
`protect_pdf`	Encrypt a PDF with a password and permission restrictions
`watermark_pdf`	Apply a text or image watermark to a PDF

E-Signatures

Tool	Description
`create_envelope`	Create a signing envelope from one or more documents
`send_envelope`	Send a created envelope to recipients
`get_envelope`	Get the current status of an envelope

Webhook Management

Tool	Description
`create_webhook`	Subscribe to PDFGate events
`delete_webhook`	Remove a webhook subscription

Webhook Triggers

The server listens for incoming PDFGate events on port 3599 by default. To receive events:

Expose port 3599 to the internet (e.g. via ngrok)
Use the create_webhook tool to register your public URL

Supported events:

Event	Description
`envelope.sent`	Signing request emails have been dispatched to recipients
`envelope.completed`	All documents in the envelope have been signed
`envelope.expired`	The envelope expired before all documents were signed
`envelope.document.completed`	A single document inside the envelope has been fully signed

Received events are available via the pdfgate://events MCP resource and pushed to the client in real time.

Environment variables

Variable	Required	Default	Description
`PDFGATE_API_KEY`	Yes	—	Your PDFGate API key
`PDFGATE_WEBHOOK_PORT`	No	`3599`	Port for the webhook listener