luminpdf/lumin-mcp-server

Lumin PDF MCP Server

The Lumin PDF MCP Server enables seamless integration between MCP-compatible AI assistants (such as Claude Desktop and Cursor) and Lumin’s API services. This allows AI assistants to perform actions like managing documents, sending signature requests, retrieving workspace details, and generating PDFs—directly through natural-language commands.

🚀 Features

This MCP server provides access to the following Lumin API tools:

• get_lumin_user_information – Retrieve information about the current Lumin user.
• get_signature_request_on_lumin_by_id – Fetch details of a signature request using its ID.
• cancel_signature_request_on_lumin_by_id – Cancel a pending signature request.
• send_signature_request_on_lumin – Create and send a signature request with attached documents.
• upload_file_to_lumin – Upload files to Lumin.
• get_workspace_list_of_user_on_lumin – Retrieve all workspaces associated with the user.
• lumin_markdown2pdf – Convert Markdown content into a PDF via Lumin.

📦 Installation

For Cursor Users

If you're using Cursor, simply open the provided integration link—Cursor handles installation automatically.

For Claude Desktop Users

Add the following configuration to your claude_desktop_config.json file:

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

Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "lumin": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.luminpdf.com/mcp"]
    }
  }
}

Support for additional MCP clients will be added soon.

🛠 Troubleshooting

Cursor Authentication Issues

If installation fails or Cursor cannot authenticate, try clearing cached credentials:

/Users/<your-username>/.mcp-auth/

Restart Cursor and reinstall the integration afterward.

📘 Example Natural-Language Commands

(See below for expanded full workflow examples.)

Here are examples of instructions you can give an MCP-enabled AI assistant:

Get User Information

Get my user information from Lumin.

Cancel a Signature Request

Cancel my signature request with ID: my-signature-request-id

Send a Signature Request

Send a signature request with these details:
- Title: Contract Agreement
- Signers: john@example.com (John Doe), mary@example.com (Mary Smith)
- Expiry: 7 days from now
- File URL: https://www.w3.org/WAI/ER/tests/xhtml/testfiles/resources/pdf/dummy.pdf

(Note: Public URL document support will be enhanced in future versions.)

🔄 Comprehensive Workflow Examples

Below are end-to-end workflow examples showing how an AI assistant can combine all Lumin MCP tools.

🔐 Workflow 1: Upload a Document and Send a Signature Request

1. Get my user information from Lumin.
2. Retrieve my list of workspaces on Lumin.
3. Upload the file named "service-agreement.pdf" to my primary workspace.
4. Send a signature request using the uploaded file with:
   - Title: Service Agreement
   - Signer: client@example.com (Primary Signer)
   - Message: Please review and sign.
   - Expiry: 5 days from now

📄 Workflow 2: Check Status and Generate a PDF Summary

1. Get details of my signature request with ID: req_12345.
2. Convert the following Markdown into a PDF using Lumin:
   """
   # Signature Request Summary
   - Request ID: req_12345
   - Status: <insert-status-from-response>
   - Generated: Today
   """
3. Save or download the generated summary PDF.

🚫 Workflow 3: Cancel a Signature Request and Verify

1. Cancel my signature request with ID: req_12345.
2. Retrieve the request again to confirm it is now cancelled.

🗂 Workflow 4: Manage Workspaces and Document Conversion

1. Retrieve all workspaces associated with my Lumin account.
2. Upload a file named "proposal.md" to my "Client Projects" workspace.
3. Convert the uploaded Markdown file into a PDF using Lumin.
4. Send that generated PDF as part of a signature request.

🔁 Workflow 5: Full Automation Chain

1. Upload the document "nda.pdf" to Lumin.
2. Create a signature request using the uploaded document.
3. Periodically check the status of the request until it is completed.
4. Once completed, generate a PDF summary of the signing details using Markdown.
5. Upload the summary PDF into my workspace for archival.

📚 API Documentation

For full reference documentation, visit: 👉 https://developers.luminpdf.com/api/