# Workato → PDF with makesPDF

> For AI agents: a documentation index is available at https://makespdf.com/llms.txt — every docs page also has a markdown twin (append .md to the page URL), including this one: https://makespdf.com/docs/integrations/workato.md

[Workato](https://www.workato.com/) can proxy an external MCP server: you register makesPDF's hosted MCP server in Workato, and agents then connect to one Workato MCP URL instead of to makesPDF directly. Every makesPDF MCP tool is available through the proxy.

## Connect

You need a makesPDF [API key](https://makespdf.com/settings/api-keys?ref=workato).

1. In Workato, go to **AI Hub > Enterprise MCP > Custom servers** and click **+ Create an MCP server**.
2. Under **Start from scratch**, click **New MCP server** and choose **External MCP Server** as the tool source.
3. Set **External MCP server URL** to `https://makespdf.com/api/v1/mcp`.
4. Choose **Bearer Token** in the **Authentication Type** menu and enter your API key as the token, with no `Bearer ` prefix, then click **Connect**. **API Key (Header)** also works: set **Custom Header Name** to `Authorization` (it defaults to `X-API-Key`) and **API Key** to `Bearer <makesPDF API key>`.
5. Set **Server name** and **Location to save this server** (the project), then click **Create MCP Server**.

The server's **Details** tab shows its tools and the remote MCP URL Workato generated. Add that URL to the LLM or agent settings of the client you use with Workato. If makesPDF adds a tool later, click **Refresh tools** under **Tools from external MCP server**.

## Render a PDF

The agent that uses your Workato MCP URL chooses the tool from its prompt, so describe the document. It can call:

| Tool | Arguments | What it does |
| --- | --- | --- |
| `render_markdown` | `markdown`, optional `options` | Markdown → PDF (1 credit per 10 pages) |
| `render_template` | `templateId`, `data` | A stored or library template filled with your data |
| `validate_markdown` | `markdown` | Free accessibility check before you render |
| `list_templates` | optional `q`, `category`, `tags` | Find a library template such as `invoice-classic` |

Each render result carries `pageCount`, `creditsDeducted`, `artifactId` and a `downloadUrl`.

## Get the file

`downloadUrl` is a signed link that needs no API key, so any step that downloads a URL can fetch the PDF. The link expires 15 minutes after the render. To fetch an older render, call `get_render_download_url` with its `artifactId` for a fresh link (free).

## OAuth (untested)

Workato's proxy also supports OAuth with a Client ID Metadata Document, which makesPDF supports. We have not tested that sign-in with Workato, so use the API key.

## Billing and limits

Renders bill your makesPDF credits exactly like the API: 1 credit per 10 pages on success, nothing on failure. Validation and listing tools are free. On the Free and Hobbyist plans, unless the account holds Growth credits, each page carries a small makespdf.com link. Workato's own charges are separate. The full tool reference is on the [MCP page](https://makespdf.com/docs/mcp).
