@pdfbroker/mcp-server

@pdfbroker/mcp-server

Generate PDFs from HTML using AI agents via PdfBroker.io.

This package connects Claude Desktop, Cursor, and other MCP clients to the PdfBroker.io cloud PDF generation API.

Setup

• Sign up at pdfbroker.io
• Go to Members → API Credentials and copy your Client ID and Client Secret
• Add to your Claude Desktop config (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "pdfbroker": {
      "command": "npx",
      "args": ["-y", "@pdfbroker/mcp-server"],
      "env": {
        "PDFBROKER_CLIENT_ID": "pb_cid_your_id_here",
        "PDFBROKER_CLIENT_SECRET": "pb_sec_your_secret_here"
      }
    }
  }
}

• Restart Claude Desktop

Available Tools

• html_to_pdf — Convert HTML/CSS to PDF using WeasyPrint (PDF/A, PDF/UA support)
• html_to_pdf_wk — Convert HTML to PDF using wkhtmltopdf (JS support, free tier)

Both tools accept optional extraArguments (a string-to-string map of engine flags — including enable-forms: "" for fillable wkhtmltopdf PDF forms) and resources (base64-encoded files keyed by relative path, for embedded images and custom fonts). Connected clients can read the full argument list from the docs://pdfbroker/api-reference resource the server exposes.

Example

Ask Claude: "Create a PDF invoice for Acme Corp with 3 line items"

Claude will generate HTML, call the html_to_pdf tool, and return a download link for the PDF.

Cursor / VS Code

Add to .vscode/mcp.json:

{
  "servers": {
    "pdfbroker": {
      "command": "npx",
      "args": ["-y", "@pdfbroker/mcp-server"],
      "env": {
        "PDFBROKER_CLIENT_ID": "pb_cid_your_id_here",
        "PDFBROKER_CLIENT_SECRET": "pb_sec_your_secret_here"
      }
    }
  }
}

Claude Code

Claude Code supports direct HTTP connections — no wrapper needed:

claude mcp add-json pdfbroker '{
  "type": "http",
  "url": "https://mcp.pdfbroker.io/",
  "headers": {
    "X-PdfBroker-ClientId": "pb_cid_your_id_here",
    "X-PdfBroker-ClientSecret": "pb_sec_your_secret_here"
  }
}'

Requirements

• Node.js 18+
• PdfBroker.io account with API credentials

Environment Variables

Variable	Required	Description
PDFBROKER_CLIENT_ID	Yes	Your Client ID from pdfbroker.io
PDFBROKER_CLIENT_SECRET	Yes	Your Client Secret from pdfbroker.io

Note: earlier versions accepted a PDFBROKER_MCP_URL override. As of 1.1.0 the server URL is fixed at https://mcp.pdfbroker.io/ (the MCP server is hosted-only). If the variable is still set in your environment the wrapper logs a warning and ignores it.