PDF MCP server.
Built for AI workflows.

Simple plans, without surprises.

Free beta is available now. Paid plans below are proposals, not subscriptions you can buy today.

Uploads, downloads, job status and usage checks do not use credits. Requests are rate-limited; beta processing runs one job at a time across the service. No uptime SLA. Limits may change with notice on this page.

Bring your own MCP client.

1. Create your key. Sign in to the developer dashboard with a PaperLumo account, label a key and save it in your client’s secret settings. Keys expire after 90 days and can be revoked.
2. Add the remote endpoint. Use Streamable HTTP at https://paperlumo.com/api/mcp with the header Authorization: Bearer YOUR_API_KEY.
3. Upload, process, download. Get consent before uploading documents. Pass the returned file IDs into a tool, then download the output before its ten-minute expiry.

{
  "mcpServers": {
    "paperlumo": {
      "type": "http",
      "url": "https://paperlumo.com/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Configuration syntax varies by client. This beta supports clients that allow a remote Streamable HTTP endpoint and a custom Bearer header. OAuth-only connectors are not supported yet. Never put an API key in a URL, prompt, repository or shared screenshot.

Tools you can call

Example: merge uploaded PDFs

{
  "name": "pdf_merge",
  "arguments": {
    "requestId": "merge-example-001",
    "fileIds": [
      "FIRST_FILE_ID",
      "SECOND_FILE_ID"
    ]
  }
}

Supply real file IDs returned by upload. Reuse the same requestId with identical inputs when retrying; successful retries are not charged again for 90 days. A completed job can outlive its file. After expiry, upload again and use a new requestId.

Binary file API

For large files, upload raw bytes with POST /api/mcp/files, your Bearer header, X-File-Extension: pdf (or docx, xlsx, pptx) and X-Paperlumo-Upload-Consent: yes. Download with authenticated GET /api/mcp/files?id=FILE_ID; delete with the same URL and DELETE. Never send document URLs: this service does not fetch them.

Keep each file under 5 MB. Your temporary storage is limited to 10 MB and 20 files, including outputs. Download and delete unused files to make room. Storage is shared across your keys; a server restart clears it.