agentutility(7)$ man pdf-merge
/pdf-merge
PRICE / CALL
$0.01
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
mediakitCATEGORY
media
STATUS
● live
NAME
pdf-merge — joins multiple pdf files, hosted at urls, into a single ordered document, so you don't have to merge them by hand in a desktop pdf editor
SYNOPSIS
POST https://x402.agentutility.ai/pdf-merge
Content-Type: application/json
X-PAYMENT: <signed-transferWithAuthorization>
{ ... }↳ first call →
402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.DESCRIPTION
Joins multiple PDF files, hosted at URLs, into a single ordered document, so you don't have to merge them by hand in a desktop PDF editor. Send pdf_urls as an array of 2 to 50 links in the order you want them combined, plus an optional filename; the merge engine combines them and preserves each source's bookmarks. The response returns pdf_url for the combined file and merged_count confirming how many sources it used. Use it as a PDF merger, PDF combiner, PDF concatenator, or document-joining API for stitching reports, contracts, or scanned pages into one file.
INPUT — request schema
| property | type | description | req? |
|---|---|---|---|
| pdf_urls | array | PDF URLs to merge in order. 2-50 URLs, each http/https. | required |
| filename | string | Output filename, must end in .pdf. Optional; defaults to "merged.pdf". | optional |
OUTPUT — response shape
| field | type | description |
|---|---|---|
| pdf_url | string | Public URL of the merged PDF output, hosted temporarily for download. |
| file_size_bytes | number | Size of the merged PDF in bytes. |
| merged_count | number | Number of source PDFs combined into the output file. |
| filename | string | Filename of the merged PDF (e.g. merged.pdf). |
| source_urls | array | Array of input PDF URLs that were merged, in the order they were concatenated. |
| job_id | string | CloudConvert job identifier for the merge task. |
EXAMPLES — two ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/pdf-merge \
-H 'Content-Type: application/json' \
-d '{ }'first response =
402 Payment Required with payment requirements; sign + retry with X-PAYMENT.EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster npx -y @agentutility/mcp-<cluster> # Required: EVM private key with USDC on Base export X402_PRIVATE_KEY=0x... # Then call the pdf-merge tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
- tags
- pdfmergecombineconcat
- env
- CLOUD_CONVERT_API_KEY
- methods
- POST
- cluster
- mediakit
- price
- $0.01 USDC per call
ADJACENT — other endpoints in mediakit
| endpoint | description | price |
|---|---|---|
| audio-transcribe | Transcribes audio to text with whisper-large-v3. | $0.01 |
| csv-to-ics | Converts a CSV of events into an RFC 5545 compliant ICS calendar file (VCALENDAR/VEVENT) for Google Calendar, Outlook, and Apple Calendar… | $0.01 |
| image-convert | Convert an image from one format to another. | $0.01 |
| image-format-convert | Image converter. | $0.01 |
| merge-pdf | Combines two to fifty separate PDF files into one, taking each source as a URL and stitching them together in the order supplied, bookmar… | $0.01 |
| movie-database | Finds movies or TV shows by title, with optional year and region, and returns release year, poster, overview, and language. | $0.01 |
| movie-database-api | Searches movies and TV shows by title and optional year, returning release date, rating, popularity, overview, poster URLs, TMDB links, a… | $0.01 |
| movie-info | Looks up movie and TV metadata: title, release year, rating, overview, poster, and optional streaming providers. | $0.01 |
SEE ALSO