Which integrations are available for this server?

Allows Windsurf (Codeium) to generate PDFs and images from templates, JSON, HTML, or URLs, and manage templates. Enables running the MCP server as a Docker container for use with MCP-compatible clients, including Docker Desktop's MCP Toolkit. Allows GitHub Copilot in VS Code to generate PDFs and images from templates, JSON, HTML, or URLs, and manage templates. Allows JetBrains IDEs via the Continue extension to generate PDFs and images from templates, JSON, HTML, or URLs, and manage templates.

How do I use PDF Gen Studio MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@PDF Gen Studio MCP Server Generate a PDF from this URL: https://example.com" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

PDF Gen Studio MCP Server

by Majid9287

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

PDF Gen Studio MCP Server

A Model Context Protocol (MCP) server for PDF Gen Studio - Generate PDFs and images from templates, JSON, HTML, or URLs.

npm version License: MIT

Features

📄 Template Rendering - Render saved templates with dynamic data injection
🔧 JSON Rendering - Convert JSON design documents to PDF/images
🌐 HTML Rendering - Convert HTML/CSS content to PDF/images
📸 URL Rendering - Screenshot any website URL as PDF/images
📋 Template Management - List and retrieve your saved templates

Related MCP server: Yakpdf MCP Server

Installation

Using npm (Global)

npm install -g @pdfgenstudio/mcp

Using npx (No Install)

npx @pdfgenstudio/mcp

From Source

git clone https://github.com/Majid9287/pdfgenstudio-mcp.git
cd pdfgenstudio-mcp
npm install
npm run build

Using Docker

docker pull mcp/pdfgenstudio:latest

Or build locally:

docker build -t mcp/pdfgenstudio .

Configuration

Environment Variables

Set your PDF Gen Studio API key:

export PDFGENSTUDIO_API_KEY="your-api-key-here"

Or on Windows (PowerShell):

$env:PDFGENSTUDIO_API_KEY = "your-api-key-here"

Or on Windows (Command Prompt):

set PDFGENSTUDIO_API_KEY=your-api-key-here

Optional Configuration

Variable	Description	Default
`PDFGENSTUDIO_API_KEY`	Your PDF Gen Studio API key	Required
`PDFGENSTUDIO_BASE_URL`	API base URL	`https://api.pdfgenstudio.com`

Usage

As stdio Server (Default)

# Using global install
pdfgenstudio-mcp

# Using npx
npx @pdfgenstudio/mcp

# With explicit transport
pdfgenstudio-mcp --transport stdio

As HTTP Server

# Start HTTP server on port 3100
pdfgenstudio-mcp --transport http --port 3100

# Or with custom port
pdfgenstudio-mcp -t http -p 8080

Development & Testing

# Test with fastmcp CLI
npm run test

# Inspect with MCP Inspector
npm run inspect

🔌 Client Integrations

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

Linux: ~/.config/Claude/claude_desktop_config.json

Using npx (Recommended)

{
  "mcpServers": {
    "pdfgenstudio": {
      "command": "npx",
      "args": ["-y", "@pdfgenstudio/mcp"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Using Local Installation

{
  "mcpServers": {
    "pdfgenstudio": {
      "command": "node",
      "args": ["/absolute/path/to/pdfgenstudio-mcp/dist/index.js"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

After editing, restart Claude Desktop completely.

Docker Desktop (MCP Toolkit)

PDF Gen Studio MCP is available in Docker Desktop's MCP Toolkit catalog.

Option 1: Using Docker Desktop MCP Toolkit UI

Open Docker Desktop
Go to Extensions → MCP Toolkit
Search for "pdfgenstudio" in the catalog
Click Install and configure your API key

Option 2: Manual Configuration

Add to your Claude Desktop configuration to use the Docker image:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "pdfgenstudio": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "PDFGENSTUDIO_API_KEY=your-api-key-here",
        "mcp/pdfgenstudio:latest"
      ]
    }
  }
}

Running Docker Container Directly

# Run in stdio mode (default) - for MCP client integration
docker run -it --rm \
  -e PDFGENSTUDIO_API_KEY="your-api-key-here" \
  mcp/pdfgenstudio:latest

# Run in HTTP mode - for local development/testing
docker run -it --rm -p 3100:3100 \
  -e PDFGENSTUDIO_API_KEY="your-api-key-here" \
  mcp/pdfgenstudio:latest node dist/index.js --transport http --port 3100

Using Docker Compose

# Create .env file with your API key
echo "PDFGENSTUDIO_API_KEY=your-api-key-here" > .env

# Run in stdio mode (default)
docker-compose up -d pdfgenstudio-mcp

# Run in HTTP mode (for local testing)
docker-compose --profile http up -d pdfgenstudio-mcp-http

VS Code (GitHub Copilot)

VS Code supports MCP servers through the GitHub Copilot extension.

Step 1: Enable MCP in VS Code

Open VS Code Settings (Ctrl+, or Cmd+,)
Search for github.copilot.chat.experimental.mcp
Enable the setting

Step 2: Configure MCP Server

Create or edit .vscode/mcp.json in your workspace:

{
  "servers": {
    "pdfgenstudio": {
      "command": "npx",
      "args": ["-y", "@pdfgenstudio/mcp"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Or add to your VS Code User Settings (settings.json):

{
  "github.copilot.chat.experimental.mcp": true,
  "mcp": {
    "servers": {
      "pdfgenstudio": {
        "command": "npx",
        "args": ["-y", "@pdfgenstudio/mcp"],
        "env": {
          "PDFGENSTUDIO_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

Using Local Installation in VS Code

{
  "servers": {
    "pdfgenstudio": {
      "command": "node",
      "args": ["C:/path/to/pdfgenstudio-mcp/dist/index.js"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Cursor has built-in MCP support. Configure it in Cursor settings.

Step 1: Open Cursor Settings

Open Cursor
Go to Settings → Cursor Settings → MCP
Or press Ctrl+Shift+P / Cmd+Shift+P and search "MCP"

Step 2: Add MCP Server

Add the following configuration:

{
  "mcpServers": {
    "pdfgenstudio": {
      "command": "npx",
      "args": ["-y", "@pdfgenstudio/mcp"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Alternative: Edit Config File Directly

macOS: ~/.cursor/mcp.json

Windows: %USERPROFILE%\.cursor\mcp.json

Linux: ~/.cursor/mcp.json

{
  "mcpServers": {
    "pdfgenstudio": {
      "command": "npx",
      "args": ["-y", "@pdfgenstudio/mcp"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Windsurf (Codeium)

Windsurf supports MCP through its configuration.

Configuration File Location

macOS: ~/.codeium/windsurf/mcp_config.json

Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Linux: ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pdfgenstudio": {
      "command": "npx",
      "args": ["-y", "@pdfgenstudio/mcp"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  }
}

Zed Editor

Zed has native MCP support. Configure in Zed settings.

Configuration

Edit ~/.config/zed/settings.json:

{
  "language_models": {
    "mcp_servers": {
      "pdfgenstudio": {
        "command": "npx",
        "args": ["-y", "@pdfgenstudio/mcp"],
        "env": {
          "PDFGENSTUDIO_API_KEY": "your-api-key-here"
        }
      }
    }
  }
}

Continue (VS Code/JetBrains Extension)

Continue supports MCP servers for enhanced AI capabilities.

Configuration

Edit ~/.continue/config.json:

{
  "mcpServers": [
    {
      "name": "pdfgenstudio",
      "command": "npx",
      "args": ["-y", "@pdfgenstudio/mcp"],
      "env": {
        "PDFGENSTUDIO_API_KEY": "your-api-key-here"
      }
    }
  ]
}

HTTP/SSE Mode (For Custom Clients)

For clients that support HTTP-based MCP connections:

Start the Server

# Start HTTP server
npx @pdfgenstudio/mcp --transport http --port 3100

Endpoints

HTTP Streaming: http://localhost:3100/mcp
SSE: http://localhost:3100/sse
Health Check: http://localhost:3100/health

Example Client Connection

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const transport = new StreamableHTTPClientTransport(
  new URL("http://localhost:3100/mcp")
);

const client = new Client({
  name: "my-client",
  version: "1.0.0",
});

await client.connect(transport);

Troubleshooting

Common Issues

"API key not configured"
- Ensure PDFGENSTUDIO_API_KEY is set in the env section
- Check for typos in the environment variable name
"Command not found" (npx)
- Make sure Node.js 18+ is installed
- Try using the full path to npx: /usr/local/bin/npx
Server not connecting
- Restart your IDE/application after configuration changes
- Check the logs for error messages
- Verify the path is correct for local installations
Windows path issues
- Use forward slashes / or escaped backslashes \\ in paths
- Use absolute paths

Debug Mode

Run with debug logging:

DEBUG=* npx @pdfgenstudio/mcp

Verify Installation

# Test the server directly
npx @pdfgenstudio/mcp --help

# Test with MCP Inspector
npx fastmcp inspect /path/to/pdfgenstudio-mcp/src/index.ts

Available Tools

Template Tools

Tool	Description
`render_template`	Render a template to PDF/PNG/JPG with data injection
`render_template_image`	Render template and return viewable image

JSON Tools

Tool	Description
`render_json`	Convert JSON design document to PDF/image
`render_json_image`	Render JSON and return viewable image

HTML Tools

Tool	Description
`render_html`	Convert HTML/CSS to PDF/image
`render_html_image`	Render HTML and return viewable image

URL Tools

Tool	Description
`render_url`	Screenshot webpage as PDF/image
`render_url_image`	Screenshot and return viewable image

Management Tools

Tool	Description
`list_templates`	List all saved templates
`get_template`	Get template details
`get_template_schema`	Get modifiable template elements

Resources

The MCP server provides these resources:

URI	Description
`pdfgenstudio://templates`	List of all templates
`pdfgenstudio://templates/{id}`	Specific template details
`pdfgenstudio://docs/api`	API documentation
`pdfgenstudio://config`	Current configuration status

Prompts

Pre-built prompts for common tasks:

Prompt	Description
`generate-invoice`	Generate invoice PDFs
`generate-report`	Create report documents
`capture-webpage`	Screenshot webpages
`use-template`	Render templates with data
`html-to-pdf`	Convert HTML to PDF

Example Usage

Render a Template

Use the render_template tool to generate a PDF from template ID "abc123" 
with the following data: {"name": "John Doe", "amount": "$500"}

Screenshot a Webpage

Capture a full-page screenshot of https://example.com as PNG

Generate HTML Report

Convert this HTML to PDF:
<html>
  <body>
    <h1>Monthly Report</h1>
    <p>Content here...</p>
  </body>
</html>

API Reference

For detailed API documentation, visit docs.pdfgenstudio.com

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

# Test with MCP CLI
npm run test

# Inspect with MCP Inspector
npm run inspect

License

MIT License - see LICENSE for details.

Support

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

PdfBroker.io A
io.pdfbroker
Cloud PDF generation from HTML, CSS and XSL-FO, with PDF/A and PDF/UA support.
Developer Tools Workplace & Productivity
21
Carbone MCP A
io.carbone
Generate PDF/DOCX/XLSX/PPTX from templates+JSON. Convert Office/HTML/MD to PDF. Universal templating
App Automation File Systems Workplace & Productivity
1154
Galley Render A
com.galleyrender
JSON in, PDF out. Render invoices, certificates, reports and cards from a template and a payload.
Developer Tools Workplace & Productivity
161
HTML/CSS to Image API AOAuth
io.github.htmlcsstoimage
Generate images and PDFs from HTML/CSS, live websites, and reusable templates.
Image & Video Processing
261

Related MCP Servers

PDF-Tools MCP Server
Documentation Access File Systems App Automation
Theorhd
A
license
A
quality
D
maintenance
Enables PDF generation from HTML, text, and Markdown content with customizable formatting options. Provides secure cross-platform PDF creation tools that automatically save to user directories like Downloads, Documents, or Desktop.
Updated a year ago (2025-09-15 01:37 UTC)
4
38 npm
MIT
Yakpdf MCP Server
Web Scraping App Automation
BACH-AI-Tools
A
license
B
quality
D
maintenance
Enables PDF generation from URLs or HTML strings through the Yakpdf API, allowing users to convert web content into PDF documents.
Updated 10 months ago (2025-12-08 00:21 UTC)
1
MIT
docjet-mcpofficial
AI & Machine Learning Design Tools Workplace & Productivity
docjet-dev
A
license
A
quality
C
maintenance
Render branded PDF documents (invoices, reports, certificates) and PNG social images directly from any MCP client using DocJet templates or raw HTML with JSON data.
Updated 4 months ago (2026-06-12 22:02 UTC)
3
31 npm
MIT
DocuQueue MCP Serverofficial
Workplace & Productivity Legal & Compliance
docuqueue
A
license
Not graded
quality
B
maintenance
Enables creating professional documents (invoices, contracts, certificates, proposals, reports) via the DocuQueue API, with tools for template management, filling, previewing, and PDF generation.
Updated a month ago (2026-08-26 11:44 UTC)
1
MIT

PDF Gen Studio MCP Server

Features

Installation

Using npm (Global)

Using npx (No Install)

From Source

Using Docker

Configuration

Environment Variables

Optional Configuration

Usage

As stdio Server (Default)

As HTTP Server

Development & Testing

🔌 Client Integrations

Claude Desktop

Using npx (Recommended)

Using Local Installation

Docker Desktop (MCP Toolkit)

Option 1: Using Docker Desktop MCP Toolkit UI

Option 2: Manual Configuration

Running Docker Container Directly

Using Docker Compose

VS Code (GitHub Copilot)

Step 1: Enable MCP in VS Code

Step 2: Configure MCP Server

Using Local Installation in VS Code

Cursor

Step 1: Open Cursor Settings

Step 2: Add MCP Server

Alternative: Edit Config File Directly

Windsurf (Codeium)

Configuration File Location

Zed Editor

Configuration

Continue (VS Code/JetBrains Extension)

Configuration

HTTP/SSE Mode (For Custom Clients)

Start the Server

Endpoints

Example Client Connection

Troubleshooting

Common Issues

Debug Mode

Verify Installation

Available Tools

Template Tools

JSON Tools

HTML Tools

URL Tools

Management Tools

Resources

Prompts

Example Usage

Render a Template

Screenshot a Webpage

Generate HTML Report

API Reference

Development

License

Support

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

PDF-Tools MCP Server

Yakpdf MCP Server

docjet-mcpofficial

DocuQueue MCP Serverofficial