@foxitsoftware/foxit-pdf-api-mcp-server

v0.2.2

Published

13 days ago

MCP server for Foxit PDF API

Foxit PDF API MCP Server

Model Context Protocol (MCP) server that exposes Foxit Cloud PDF API operations as tools for AI agents like Claude Desktop, Cursor, and other MCP-compatible applications.

Features

30+ PDF Operations Available:

📄 Document Lifecycle - Upload, download, delete documents
🔄 PDF Creation - Convert Word, Excel, PPT, HTML, URL, text, images to PDF
📤 PDF Conversion - Convert PDF to Word, Excel, PPT, HTML, text, images
✂️ Manipulation - Split, extract, flatten, compress, manipulate pages
🔒 Security - Add/remove passwords, set permissions
🎨 Enhancement - Merge, watermark, linearize PDFs
🔍 Analysis - Get properties, compare PDFs, etc.

Quick Start

1. Get API Credentials

Client ID
Client Secret

2. Install the Server

The server is published on npm and can be run directly with npx:

npx @foxitsoftware/foxit-pdf-api-mcp-server

Or install globally:

npm install -g @foxitsoftware/foxit-pdf-api-mcp-server

Integration

Claude Desktop

Add to your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "foxit-pdf": {
      "command": "npx",
      "args": ["-y", "@foxitsoftware/foxit-pdf-api-mcp-server"],
      "env": {
        "FOXIT_CLOUD_API_HOST": "https://na1.fusion.foxit.com/pdf-services",
        "FOXIT_CLOUD_API_CLIENT_ID": "your_client_id",
        "FOXIT_CLOUD_API_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Restart Claude Desktop. The PDF tools will appear in the tools menu.

Cursor / VS Code (with Cline Extension)

Add to Cline MCP settings:

{
  "mcpServers": {
    "foxit-pdf": {
      "command": "npx",
      "args": ["-y", "@foxitsoftware/foxit-pdf-api-mcp-server"],
      "env": {
        "FOXIT_CLOUD_API_HOST": "https://na1.fusion.foxit.com/pdf-services",
        "FOXIT_CLOUD_API_CLIENT_ID": "your_client_id",
        "FOXIT_CLOUD_API_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Other MCP Clients

For any MCP-compatible client, configure a stdio transport server:

Command: npx
Args: ["-y", "@foxitsoftware/foxit-pdf-api-mcp-server"]
Environment: Set the three FOXIT_CLOUD_API_* variables

Usage Examples

Converting Documents to PDF

Ask your AI assistant:

"Convert my Word document report.docx to PDF"

The agent will:

Upload the document
Convert it to PDF
Download the result
Clean up temporary files

Merging PDFs

"Merge chapter1.pdf, chapter2.pdf, and chapter3.pdf into one document"

Adding Watermarks

"Add a watermark 'CONFIDENTIAL' to my PDF document"

Converting PDF to Other Formats

"Convert this PDF to a Word document so I can edit it"

Available Tools

The server exposes 30+ tools organized by category:

Document Management

upload_document - Upload files for processing
download_document - Download processed documents
delete_document - Remove uploaded documents

PDF Creation (to PDF)

pdf_from_word - Word → PDF
pdf_from_excel - Excel → PDF
pdf_from_ppt - PowerPoint → PDF
pdf_from_html - HTML → PDF
pdf_from_url - Web page → PDF
pdf_from_text - Plain text → PDF
pdf_from_image - Images → PDF

PDF Conversion (from PDF)

pdf_to_word - PDF → Word
pdf_to_excel - PDF → Excel
pdf_to_ppt - PDF → PowerPoint
pdf_to_html - PDF → HTML
pdf_to_text - PDF → Plain text
pdf_to_image - PDF → Images

PDF Operations

pdf_merge - Combine multiple PDFs
pdf_split - Split PDF into parts
pdf_extract - Extract specific pages
pdf_compress - Reduce file size
pdf_flatten - Flatten form fields and annotations
pdf_manipulate - Rotate, reorder, delete pages

Security

pdf_protect - Add password protection
pdf_remove_password - Remove password protection

Enhancement

pdf_watermark - Add text/image watermarks
pdf_linearize - Optimize for web viewing

Analysis

pdf_compare - Compare two PDFs

Troubleshooting

Server Not Starting

Ensure FOXIT_CLOUD_API_CLIENT_ID and FOXIT_CLOUD_API_CLIENT_SECRET are set in your MCP client config
Verify your API credentials at Foxit Developer Portal
Check that npx can access the npm registry (try npx -y @foxitsoftware/foxit-pdf-api-mcp-server --version)

Tools Not Appearing

Restart your MCP client (Claude Desktop, etc.) after configuration changes
Check the client logs for connection errors
Ensure the -y flag is included in npx args to auto-accept installation

API Errors

Ensure your API credentials are valid and not expired
Check your API usage quota at the developer portal
Verify the API host URL is correct for your region

Development

See CONTRIBUTING.md for development setup, architecture details, and contribution guidelines.

License

MIT