pdf-api-mcp 1.0.0

MCP server for Simple PDF API — generate and manipulate PDFs from Claude Desktop, Cursor, and Windsurf

Simple PDF API — MCP Server

Use Simple PDF API tools directly inside Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.

8 tools available: html_to_pdf, url_to_pdf, merge_pdfs, split_pdf, watermark_pdf, compress_pdf, protect_pdf, rotate_pdf, extract_text.

Prerequisites

• A RapidAPI key (free tier available)
• Python 3.10+ and uv installed

Setup

Option A — uvx (no install needed)

PDF_API_KEY=your_rapidapi_key uvx --from "git+https://github.com/mahiuddinalkamal/pdf-api#subdirectory=mcp" pdf-api-mcp

Option B — local clone

git clone https://github.com/mahiuddinalkamal/pdf-api
cd pdf-api/mcp
uv run server.py

---

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "pdf-api": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mahiuddinalkamal/pdf-api#subdirectory=mcp",
        "pdf-api-mcp"
      ],
      "env": {
        "PDF_API_KEY": "your_rapidapi_key_here"
      }
    }
  }
}

Restart Claude Desktop. You'll see PDF tools in the toolbar.

---

Cursor

Add to .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global):

{
  "mcpServers": {
    "pdf-api": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mahiuddinalkamal/pdf-api#subdirectory=mcp",
        "pdf-api-mcp"
      ],
      "env": {
        "PDF_API_KEY": "your_rapidapi_key_here"
      }
    }
  }
}

---

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "pdf-api": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/mahiuddinalkamal/pdf-api#subdirectory=mcp",
        "pdf-api-mcp"
      ],
      "env": {
        "PDF_API_KEY": "your_rapidapi_key_here"
      }
    }
  }
}

---

Tools

Tool	Description
html_to_pdf	Convert HTML string → PDF
url_to_pdf	Render a public URL → PDF
merge_pdfs	Merge multiple PDFs into one
split_pdf	Extract page ranges from a PDF
watermark_pdf	Add CONFIDENTIAL / DRAFT overlays
compress_pdf	Reduce file size
protect_pdf	AES password-encrypt
rotate_pdf	Rotate all or selected pages
extract_text	Pull plain text from a PDF

All output files are saved to ~/Downloads/.

Environment Variables

Variable	Required	Description
PDF_API_KEY	Yes	Your RapidAPI key
PDF_API_HOST	No	Override base URL (for self-hosted)