DocConvert-PDF

What it does

Converts HTML or markdown content to a PDF via headless Playwright. Returns the PDF as a base64-encoded string. Use when an agent's output should be a downloadable document — reports, invoices, formatted summaries. Not a default step in most pipelines; use it explicitly when PDF is the right output format.

When to use it

• Agent generates a markdown report → convert to PDF → email to user via NotifyRelay
• Invoice generation for an accounting agent
• Format a research summary for archival

Request schema

{
  "from": "md",
  "to": "pdf",
  "content": "# Report\n\nThis is the body of the report."
}

Response schema

{
  "from": "md",
  "to": "pdf",
  "content": "JVBERi0xLjQKJeLjz9MKMS...",
  "encoding": "base64",
  "size_bytes": 14832
}

Code example — TypeScript via MCP

Install the MCP server once; all 16 services become tool calls.

// Configure @melis-ai/x402-tools-mcp in your MCP client
// Then call the tool:

const result = await mcpClient.callTool("docconvert_pdf", {
  "from": "md",
  "to": "pdf",
  "content": "# Report\n\nThis is the body of the report."
});

console.log(result);
// ["from","to","content","encoding","size_bytes"]...

Code example — Python via direct HTTP

import requests

# x402 payment header must be set by your wallet client
# See x402.org for client libraries

headers = {
    "Content-Type": "application/json",
    "x-payment": "<signed-x402-payment-header>",
}

resp = requests.post(
    "https://docconvert-pdf.melis.ai/convert",
    json={
      "from": "md",
      "to": "pdf",
      "content": "# Report\n\nThis is the body of the report."
    },
    headers=headers,
)
print(resp.json())

Code example — curl with internal key bypass

For testing with an issued internal key (skips x402 payment flow):

curl -X POST https://docconvert-pdf.melis.ai/convert \
  -H "Content-Type: application/json" \
  -H "x-internal-key: YOUR_KEY" \
  -d '{"from":"md","to":"pdf","content":"# Report\n\nThis is the body of the report."}'

How is this different from alternatives?

Related services

FAQ