Deterministic PDF tools for AI agents: inspect fields, fill forms, merge PDFs, invoices.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Optional. Works without a key (keyless trial cap); a free key from https://pdfops.dev/pricing#free-key raises it. Format: Bearer <PDFOPS_API_KEY>
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Fill AcroForm form fields in a PDF and return the result. Field names must exist in the PDF (use pdf_inspect first). All values are strings; checkboxes take "true"/"false"; dropdown/radio/optionlist values must be one of the field's options; text values must respect the field's maxLength from pdf_inspect. The source PDF is never modified. Returns the filled PDF inline as an application/pdf resource. Encrypted PDFs are rejected with decrypt advice (common for government blanks with an empty user password).
Field name → string value (from pdf_inspect's fillTemplate)
Template PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths).
Bake values into page content and drop the AcroForm so fields are no longer editable
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Fill AcroForm form fields in a PDF and return the result. Field names must exist in the PDF (use pdf_inspect first). All values are strings; checkboxes take "true"/"false"; dropdown/radio/optionlist values must be one of the field's options; text values must respect the field's maxLength from pdf_inspect. The source PDF is never modified. Returns the filled PDF inline as an application/pdf resource. Encrypted PDFs are rejected with decrypt advice (common for government blanks with an empty user password).
| Argument | Type | Description |
|---|---|---|
| fields* | object | Field name → string value (from pdf_inspect's fillTemplate) |
| flatten | boolean | Bake values into page content and drop the AcroForm so fields are no longer editable |
| pdf_path* | string | Template PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths). |
{
"type": "object",
"required": [
"pdf_path",
"fields"
],
"properties": {
"fields": {
"type": "object",
"description": "Field name → string value (from pdf_inspect's fillTemplate)",
"additionalProperties": {
"type": "string"
}
},
"flatten": {
"type": "boolean",
"description": "Bake values into page content and drop the AcroForm so fields are no longer editable"
},
"pdf_path": {
"type": "string",
"description": "Template PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
}
},
"additionalProperties": false
}List a PDF's AcroForm form fields — names, types, options, current values, per-field maxLength where declared — plus a paste-ready fillTemplate object for pdf_fill and a hasXFA flag (hybrid AcroForm/XFA inputs lose their XFA layer when filled). A PDF with no fillable form returns count 0. Read-only: the PDF is fetched but never modified. Call this FIRST when filling an unfamiliar PDF, since pdf_fill rejects unknown field names and over-length values.
| Argument | Type | Description |
|---|---|---|
| pdf_path* | string | PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths). |
{
"type": "object",
"required": [
"pdf_path"
],
"properties": {
"pdf_path": {
"type": "string",
"description": "PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
}
},
"additionalProperties": false
}Generate a complete, professionally laid-out invoice PDF from structured data — no template needed. Deterministic: the same input produces byte-identical output (safe to re-run). Note: without a paid PDFops key the output carries a small "Generated with pdfops.dev" footer line. Returns the invoice inline as an application/pdf resource. Use this when you have invoice DATA and no document; if you already have an invoice PDF or a fillable template to populate, use pdf_fill instead.
| Argument | Type | Description |
|---|---|---|
| invoice* | object | Invoice data |
{
"type": "object",
"required": [
"invoice"
],
"properties": {
"invoice": {
"type": "object",
"required": [
"from",
"to",
"items"
],
"properties": {
"to": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"lines": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
]
},
"due": {
"type": "string"
},
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Calendar date in YYYY-MM-DD form (other formats are rejected with invalid_date). Shown on the invoice; also pins metadata for determinism"
},
"from": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"lines": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
}
]
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"description",
"unit_price"
],
"properties": {
"quantity": {
"type": "number",
"exclusiveMinimum": 0
},
"unit_price": {
"type": "number",
"minimum": 0
},
"description": {
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 100,
"minItems": 1
},
"notes": {
"type": "string",
"maxLength": 1000
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
},
"tax_rate": {
"type": "number",
"maximum": 100,
"minimum": 0
},
"invoice_number": {
"type": "string"
}
},
"description": "Invoice data",
"additionalProperties": false
}
},
"additionalProperties": false
}Merge two or more PDFs into one, in the order given, and return the result. Sources are read only and never modified. Returns the merged PDF inline as an application/pdf resource. This tool only concatenates whole documents: it does not reorder, rotate or delete pages within them, and it does not fill forms — use pdf_fill for a fillable form and pdf_invoice to build a document from data. An unreadable or rejected input fails with an error, so a partial merge is never returned.
| Argument | Type | Description |
|---|---|---|
| pdf_paths* | array | In order, each a PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths). |
{
"type": "object",
"required": [
"pdf_paths"
],
"properties": {
"pdf_paths": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 2,
"description": "In order, each a PDF source: an https:// URL or a data:application/pdf;base64,… URI (this hosted server cannot read local file paths)."
}
},
"additionalProperties": false
}Check the current PDFops API quota for the configured key: tier, limit, used, remaining, the billing period, and the reset timestamp. Read-only and safe to call before a batch to confirm there is headroom. Uses the API key this connection authenticated with.
No arguments.
{
"type": "object",
"properties": {}
}