English Français العربية

PDFMonkey

السجل الرسمي أخرى

Generate PDFs from templates using the PDFMonkey API

الشيفرة المصدرية الموقع التوثيق

ماذا يمكنك أن تفعل مع PDFMonkey؟

  • Download URLs expire after one hour. Download the file right away, or use a share link (Pro+ and Premium plans).
  • If a generation takes longer than 3 minutes, call get_document_status later with the document ID.

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package pdfmonkey-mcp-server
Claude Code 
claude mcp add pdfmonkey -e 'PDFMONKEY_API_KEY=<your pdfmonkey_api_key>' -- npx -y pdfmonkey-mcp-server@1.0.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "pdfmonkey": {
            "command": "npx",
            "args": [
                "-y",
                "pdfmonkey-mcp-server@1.0.1"
            ],
            "env": {
                "PDFMONKEY_API_KEY": "<your pdfmonkey_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • PDFMONKEY_API_KEY إلزامي سري Your PDFMonkey API key from https://dashboard.pdfmonkey.io/account

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. PDFMonkey MCP Server
  2. Get your API key
  3. Setup
  4. Tools
  5. Example
  6. Development
  7. Troubleshooting
  8. Resources
  9. License

PDFMonkey MCP Server

The official Model Context Protocol (MCP) server for PDFMonkey. It lets AI assistants such as Claude, Cursor or any other MCP client list your templates, generate documents and check your quota through the PDFMonkey API.

The MCP server works with existing templates: it can read them but not create or edit them. To let an agent build and preview templates, use the PDFMonkey CLI.

Get your API key

Sign up at dashboard.pdfmonkey.io/register, then copy your API key from your account page.

Setup

The server needs Node.js 18 or later and reads your key from the PDFMONKEY_API_KEY environment variable.

Claude Code
claude mcp add pdfmonkey -e PDFMONKEY_API_KEY=your-api-key -- npx -y pdfmonkey-mcp-server
Claude Desktop, Cursor and other clients

Add this to your client’s MCP configuration (claude_desktop_config.json for Claude Desktop, .cursor/mcp.json for Cursor):

{
  "mcpServers": {
    "pdfmonkey": {
      "command": "npx",
      "args": ["-y", "pdfmonkey-mcp-server"],
      "env": {
        "PDFMONKEY_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Desktop’s configuration file lives in ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.

Docker

No image is published yet, so build it locally:

docker build -t pdfmonkey-mcp-server .
{
  "mcpServers": {
    "pdfmonkey": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "PDFMONKEY_API_KEY", "pdfmonkey-mcp-server"],
      "env": {
        "PDFMONKEY_API_KEY": "your-api-key"
      }
    }
  }
}

See DOCKER-MCP-TOOLKIT.md to use it with the Docker MCP Toolkit.

Tools

ToolWhat it does
list_workspacesList the workspaces your API key can access
list_templatesList the templates of a workspace
get_templateGet a template’s HTML, CSS and sample data
generate_documentGenerate a document and wait for it (polls every 1.5 s, up to 3 minutes)
get_document_statusCheck a document’s status and get its download URL
list_documentsList documents, filtered by status, template or update time
delete_documentDelete a document permanently
list_snippetsList the Liquid snippets of a workspace
get_snippetGet a snippet’s code
get_quotaGet your quota and plan
get_user_infoGet your account details

The server also exposes four prompts: list-templates-formatted, show-documents-status, generate-invoice and workspace-overview.

Good to know:

  • Download URLs expire after one hour. Download the file right away, or use a share link (Pro+ and Premium plans).
  • If a generation takes longer than 3 minutes, call get_document_status later with the document ID.

Example

You: Generate an invoice for ACME with my invoice template.

Claude: [calls list_templates, then generate_document]
Your invoice is ready: https://…

Development

npm install
npm run build      # compile to dist/
npm test           # run the test suite
npm run watch      # rebuild on change

To try the server against the real API:

PDFMONKEY_API_KEY=your-api-key npm start

Troubleshooting

  • “PDFMONKEY_API_KEY environment variable is required”: the key is missing from your client configuration.
  • 401 errors: the key is wrong or was regenerated. Copy it again from your account page.
  • Docker container exits immediately: run it with -i, MCP talks over stdin.

Resources

Questions about the server? Open an issue. Questions about PDFMonkey itself? Contact us.

License

MIT, see LICENSE.

الأسئلة الشائعة

ما هو PDFMonkey؟

Generate PDFs from templates using the PDFMonkey API

كيف أثبّت PDFMonkey؟

يعمل على جهازك. في Claude Code: claude mcp add pdfmonkey -e 'PDFMONKEY_API_KEY=<your pdfmonkey_api_key>' -- npx -y pdfmonkey-mcp-server@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج PDFMonkey إلى مفتاح API؟

نعم. يتطلب PDFMONKEY_API_KEY، وتضبطها في إعداداته.

هل PDFMonkey مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون PDFMonkey؟

ينشره pdfmonkey. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.