Odel
pdfgate mcp server

pdfgate mcp server

@pdfgateTypeScriptMITUpdated 2 days ago

MCP server for the PDFGate API. Generate PDFs, manage documents and handle e-signatures.

Server endpointStreamable HTTPOAuthProbed

This is the third-party server itself — Odel doesn't run it. Hitting this URL directly talks straight to the upstream server with no auth or proxying. Connect through Odel to front it with managed auth.

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"
      }
    }
  }
}

Hosted server (remote)

If you prefer not to run anything locally, we also host the MCP server, so you can connect straight to it — no npx, no local process. Point any client that supports remote (Streamable HTTP) MCP servers at:

https://mcp.pdfgate.com/server

You can authenticate in two ways.

Option 1 — OAuth

For clients that support remote MCP servers with OAuth (such as Claude and ChatGPT), add the server by its URL alone and sign in through your browser. There is no key to copy or store: the client registers itself, sends you to the PDFGate dashboard to approve access, and receives a scoped token automatically.

{
  "mcpServers": {
    "pdfgate": {
      "type": "http",
      "url": "https://mcp.pdfgate.com/server"
    }
  }
}

Many clients let you add this from their UI instead of a config file — for example, in Claude: Settings → Connectors → Add custom connector, then enter the URL above. OAuth sessions run against your production account; for the sandbox, use an X-API-KEY with a test_ key.

Option 2 — API key

Pass your key in the X-API-KEY header:

{
  "mcpServers": {
    "pdfgate": {
      "type": "http",
      "url": "https://mcp.pdfgate.com/server",
      "headers": {
        "X-API-KEY": "your_api_key_here"
      }
    }
  }
}

live_ keys use production and test_ keys use the sandbox — the environment is selected automatically from the key.

The hosted server provides the full PDFGate toolset (PDF generation, processing, form fields, e-signatures and webhooks). The exact client config field names (e.g. type / transport, headers) may vary by MCP client.

Getting an API key

Sign up at pdfgate.com to get your API key.

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

Tools

PDF Operations

ToolDescription
generate_pdfGenerate a PDF from a URL or raw HTML
upload_fileUpload a local PDF file or from a URL
get_documentRetrieve document metadata and a fresh download URL
download_fileDownload the raw PDF bytes of a stored document
delete_documentDelete a document
flatten_pdfFlatten an interactive PDF into a static, non-editable file
extract_form_dataExtract form field values from a fillable PDF
add_form_fieldsAdd interactive form fields to a PDF (placeholder tags or explicit positions)
compress_pdfCompress a PDF to reduce file size
protect_pdfEncrypt a PDF with a password and permission restrictions
watermark_pdfApply a text or image watermark to a PDF

E-Signatures

ToolDescription
create_envelopeCreate a signing envelope from one or more documents
send_envelopeSend a created envelope to recipients
get_envelopeGet the current status of an envelope
void_envelopeVoid an envelope so it can no longer be signed
delete_envelopeDelete an envelope and remove its signed documents

Webhook Management

ToolDescription
create_webhookSubscribe to PDFGate events
get_webhookRetrieve a webhook subscription by ID
delete_webhookRemove a webhook subscription

Webhook Triggers

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

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

Supported events:

EventDescription
envelope.sentSigning request emails have been dispatched to recipients
envelope.completedAll documents in the envelope have been signed
envelope.expiredThe envelope expired before all documents were signed
envelope.document.completedA single document inside the envelope has been fully signed
envelope.recipient.signedA recipient has signed a document in the envelope
envelope.voidedThe envelope was voided by the sender
envelope.deletedThe envelope was deleted

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

Environment variables

VariableRequiredDefaultDescription
PDFGATE_API_KEYYesYour PDFGate API key
PDFGATE_WEBHOOK_PORTNo3599Port for the webhook listener

smithery badge