How to merge and split PDF files with Claude MCP and Medux

Give Claude a clear instruction

Keep the request direct. Name the files, state the operation, and mention that Medux should be called through MCP.

Use Medux to merge a.pdf and b.pdf into one PDF.
Upload the files with curl, run the merge task,
and save the final result in the current project folder.

Let Claude request upload URLs from Medux

Claude checks the available Medux tools and calls the file-upload helper for each PDF. Medux returns a temporary upload URL and a file ID.

medux_file_create_upload_url
{
  "extension": "pdf",
  "media_type": "DOCUMENT"
}

Upload the PDF files with curl

Run the generated commands in your own terminal. Long signed URLs are intentionally allowed to wrap inside this page, so the command block never extends beyond the content width.

curl -X PUT   -H "Content-Type: application/pdf"   --data-binary @"/path/to/a.pdf"   "PASTE_THE_UPLOAD_URL_FOR_A_HERE"

curl -X PUT   -H "Content-Type: application/pdf"   --data-binary @"/path/to/b.pdf"   "PASTE_THE_UPLOAD_URL_FOR_B_HERE"

A successful upload normally returns HTTP 200. After both files are uploaded, tell Claude to continue.

Run the Medux PDF operation

Claude passes the uploaded file IDs to the appropriate Medux PDF tool. For a merge task, preserve the file order you want in the final document.

Merge these uploaded PDF files in this order:
1. a.pdf
2. b.pdf

Return one combined PDF and save it as merged.pdf.

Download and verify the result

When Medux finishes, Claude retrieves the result URL and downloads the output into the working folder. Open the file and verify the page order, page count, and filename.

curl -L "RESULT_DOWNLOAD_URL"   -o "./merged.pdf"

open "./merged.pdf"