# mcp-server

Connects your assistant to the PDFGate API to convert HTML into PDF documents, manage form fields, and coordinate digital signatures.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: pdfgate
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pdfgate/pdfgate-mcp-server
- Updated: 2026-09-20
- HTML: https://affpapa.org/en/nevibecode/mcp/pdfgate-mcp-server

## What it does

This integration connects coding assistants to document operations on the PDFGate platform. The model can convert HTML markup into static files, flatten form controls, and apply watermark graphics. It also handles file encryption through passwords and permission flags.

Digital signatures use signing envelopes. You can track completion states, void active requests, or generate embedded signing links for recipients. An optional webhook server listens for status events on local port `3599`. To capture live envelope changes, you must forward this port via a tunnel.

Setup works either through the hosted endpoint at `https://mcp.pdfgate.com/server` or locally with `@pdfgate/mcp-server`. You need an API token. Environment routing depends entirely on the token prefix: `test_` routes calls to the sandbox, while `live_` triggers the production endpoint.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.pdfgate.com/server`
- Environment variables: `PDFGATE_API_KEY`, `PDFGATE_WEBHOOK_PORT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp-server https://mcp.pdfgate.com/server
```

2. **Platform CLI**
```bash
claude mcp add --env PDFGATE_API_KEY=<PDFGATE_API_KEY> --env PDFGATE_WEBHOOK_PORT=<PDFGATE_WEBHOOK_PORT> --transport stdio pdfgate-mcp-server -- npx -y @pdfgate/mcp-server
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add pdfgate-mcp-server --url https://mcp.pdfgate.com/server
```

2. **Platform CLI**
```bash
codex mcp add pdfgate-mcp-server --env PDFGATE_API_KEY=<PDFGATE_API_KEY> --env PDFGATE_WEBHOOK_PORT=<PDFGATE_WEBHOOK_PORT> -- npx -y @pdfgate/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pdfgate-mcp-server": {
            "url": "https://mcp.pdfgate.com/server"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "pdfgate-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@pdfgate/mcp-server"
            ],
            "env": {
                "PDFGATE_API_KEY": "<PDFGATE_API_KEY>",
                "PDFGATE_WEBHOOK_PORT": "<PDFGATE_WEBHOOK_PORT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pdfgate-mcp-server": {
            "type": "http",
            "url": "https://mcp.pdfgate.com/server"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "pdfgate-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@pdfgate/mcp-server"
            ],
            "env": {
                "PDFGATE_API_KEY": "<PDFGATE_API_KEY>",
                "PDFGATE_WEBHOOK_PORT": "<PDFGATE_WEBHOOK_PORT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http pdfgate-mcp-server https://mcp.pdfgate.com/server
```

2. **Platform CLI**
```bash
gemini mcp add -e PDFGATE_API_KEY=<PDFGATE_API_KEY> -e PDFGATE_WEBHOOK_PORT=<PDFGATE_WEBHOOK_PORT> pdfgate-mcp-server npx -y @pdfgate/mcp-server
```
Replace <…> with your own values

## When to use it
- convert raw HTML or URL targets into PDF files
- dispatch signing envelopes to multiple recipients
- insert interactive fields and flatten forms
- compress output documents and apply password protection

## Example prompts
- Generate an invoice PDF from this HTML snippet and compress the output
- Prepare a contract envelope and create an embedded signing link for the user
- Read the filled form data from the uploaded agreement

## Similar
- [Excel MCP Server](https://affpapa.org/en/nevibecode/mcp/excel-mcp-server.md) — MCP server · ★ 4268
- [kordoc](https://affpapa.org/en/nevibecode/mcp/kordoc.md) — MCP server · ★ 2795
- [Power BI Authoring MCP Server (Local)](https://affpapa.org/en/nevibecode/mcp/power-bi-authoring-mcp-server-local.md) — MCP server · ★ 1248
- [Microsoft 365 MCP Server](https://affpapa.org/en/nevibecode/mcp/microsoft-365-mcp-server.md) — MCP server · ★ 1085
- [anymd](https://affpapa.org/en/nevibecode/mcp/anymd.md) — MCP server · ★ 1054
- [Docling MCP](https://affpapa.org/en/nevibecode/mcp/docling-mcp.md) — MCP server · ★ 779

## Other versions with the same name
- [mcp-server · heyputer](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — ★ 43902
- [mcp-server · mapbox](https://affpapa.org/en/nevibecode/mcp/mapbox-mcp-server.md) — ★ 363
- [mcp-server · packmindhub](https://affpapa.org/en/nevibecode/mcp/packmindhub-mcp-server.md) — ★ 319
- [mcp-server · bingowon](https://affpapa.org/en/nevibecode/mcp/bingowon-mcp-server.md) — ★ 121
- [mcp-server · ui5](https://affpapa.org/en/nevibecode/mcp/ui5-mcp-server.md) — ★ 105

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md