Skip to main content
Glama
pdfdotco

PDF.co MCP Server

Official
by pdfdotco

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
X_API_KEYYesYour PDF.co API key. Get it from https://pdf.co

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
pdf_to_jsonB
Convert PDF and scanned images into JSON representation with text, fonts, images, vectors, and formatting preserved using the /pdf/convert/to/json2 endpoint.
Ref: https://developer.pdf.co/api/pdf-to-json/basic.md
pdf_to_csvC
Convert PDF and scanned images into CSV representation with layout, columns, rows, and tables.
Ref: https://developer.pdf.co/api/pdf-to-csv.md
pdf_to_textC
Convert PDF and scanned images to text with layout preserved.
Ref: https://developer.pdf.co/api/pdf-to-text/basic.md
pdf_to_xlsC
Convert PDF and scanned images to XLS (Excel 97-2003) format.
Ref: https://developer.pdf.co/api/pdf-to-excel/xls.md
pdf_to_xlsxC
Convert PDF and scanned images to XLSX (Excel 2007+) format.
Ref: https://developer.pdf.co/api/pdf-to-excel/xlsx.md
pdf_to_xmlC
Convert PDF and scanned images to XML format.
Ref: https://developer.pdf.co/api/pdf-to-xml.md
pdf_to_htmlC
Convert PDF and scanned images to HTML format.
Ref: https://developer.pdf.co/api/pdf-to-html.md
pdf_to_imageC
Convert PDF and scanned images to various image formats (JPG, PNG, WebP, TIFF).
Ref:
 - https://developer.pdf.co/api/pdf-to-image/jpg.md
 - https://developer.pdf.co/api/pdf-to-image/png.md
 - https://developer.pdf.co/api/pdf-to-image/webp.md
 - https://developer.pdf.co/api/pdf-to-image/tiff.md
document_to_pdfB
Convert various document types (DOC, DOCX, RTF, TXT, XLS, XLSX, CSV, HTML, JPG, PNG, TIFF, WEBP) into PDF.
Ref: https://developer.pdf.co/api/pdf-from-document/doc.md
csv_to_pdfC
Convert CSV or spreadsheet files (XLS, XLSX) to PDF.
Ref: https://developer.pdf.co/api/pdf-from-document/csv.md
image_to_pdfC
Convert various image formats (JPG, PNG, TIFF) to PDF.
Ref: https://developer.pdf.co/api/pdf-from-image.md
```
webpage_to_pdfB
Convert external webpage URL to PDF.
Ref: https://developer.pdf.co/api/pdf-from-url.md

The header and footer parameters can contain valid HTML markup with the following classes used to inject printing values into them:
- date: formatted print date
- title: document title
- url: document location
- pageNumber: current page number
- totalPages: total pages in the document
- img: tag is supported in both the header and footer parameter, provided that the src attribute is specified as a base64-encoded string.
For example, the following markup will generate Page N of NN page numbering:
```html
<span style='font-size:10px'>Page <span class='pageNumber'></span> of <span class='totalPages'></span>.</span>
html_to_pdfB
Convert HTML to PDF.
Ref: https://developer.pdf.co/api/pdf-from-html/convert.md

The header and footer parameters can contain valid HTML markup with the following classes used to inject printing values into them:
- date: formatted print date
- title: document title
- url: document location
- pageNumber: current page number
- totalPages: total pages in the document
- img: tag is supported in both the header and footer parameter, provided that the src attribute is specified as a base64-encoded string.
For example, the following markup will generate Page N of NN page numbering:
```html
<span style='font-size:10px'>Page <span class='pageNumber'></span> of <span class='totalPages'></span>.</span>
email_to_pdfC
Convert email to PDF.
Ref: https://developer.pdf.co/api/pdf-from-email.md
excel_to_csvB
Convert Excel(XLS, XLSX) to CSV.
Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards.
Ref: https://developer.pdf.co/api/convert-from-excel/csv.md
excel_to_jsonB
Convert Excel(XLS, XLSX) to JSON.
Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards.
Ref: https://developer.pdf.co/api/convert-from-excel/json.md
excel_to_htmlB
Convert Excel(XLS, XLSX) to HTML.
Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards.
Ref: https://developer.pdf.co/api/convert-from-excel/html.md
excel_to_txtA
Convert Excel(XLS, XLSX) to TXT.
Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards.
Ref: https://developer.pdf.co/api/convert-from-excel/text.md
excel_to_xmlA
Convert Excel(XLS, XLSX) to XML.
Retiring on January 5, 2027: the underlying PDF.co API endpoint is being discontinued. The tool keeps working until that date and will be removed afterwards.
Ref: https://developer.pdf.co/api/convert-from-excel/xml.md
excel_to_pdfC
Convert Excel(XLS, XLSX) to PDF.
Ref: https://developer.pdf.co/api/convert-from-excel/pdf.md
get_job_checkA
Check the status and results of a job
Status can be:
- working: background job is currently in work or does not exist.
- success: background job was successfully finished.
- failed: background job failed for some reason (see message for more details).
- aborted: background job was aborted.
- unknown: unknown background job id. Available only when force is set to true for input request.
wait_job_completionC

Wait for a job to complete

upload_fileC

Upload a file to the PDF.co API

pdf_mergeB
Merge PDF from two or more PDF, DOC, XLS, images, even ZIP with documents and images into a new PDF.
Ref: https://developer.pdf.co/api/merge/various-files.md
pdf_splitC
Split a PDF into multiple PDF files using page indexes or page ranges.
Ref: https://developer.pdf.co/api/pdf-split/by-pages.md
read_pdf_forms_infoB
Extracts information about fillable PDF fields from an input PDF file.
Ref: https://developer.pdf.co/api/forms/info-reader.md
fill_formsA
Fill existing form fields in a PDF document.

Example fields format:
[
    {
        "fieldName": "field_name_from_form_info",
        "pages": "1",
        "text": "Value to fill"
    }
]

Use 'read_pdf_forms_info' first to get the fieldName values of the form.

Ref: https://developer.pdf.co/api/pdf-add.md
create_fillable_formsB
Create new fillable form elements in a PDF document.

Example annotations format:
[
    {
        "text": "prefilled text",
        "x": 10,
        "y": 30,
        "size": 12,
        "pages": "0-",
        "type": "TextField",
        "id": "textfield1"
    },
    {
        "x": 100,
        "y": 150,
        "size": 12,
        "pages": "0-",
        "type": "Checkbox",
        "id": "checkbox1"
    }
]

Ref: https://developer.pdf.co/api/pdf-add.md
find_textC
Find text in PDF and get coordinates. Supports regular expressions.
Ref: https://developer.pdf.co/api/pdf-find/basic.md
find_tableC
Find tables in PDF and get their coordinates.
Ref: https://developer.pdf.co/api/pdf-find/table.md
pdf_make_searchableB
Convert scanned PDF documents or image files into a text-searchable PDF.
Runs OCR and adds an invisible text layer that can be used for text search.
Ref: https://developer.pdf.co/api/pdf-change-text-searchable/searchable.md
pdf_make_unsearchableB
Make existing PDF document non-searchable by removing the text layer from it.
Ref: https://developer.pdf.co/api/pdf-change-text-searchable/unsearchable.md
pdf_add_passwordC
Add password protection to a PDF file.
Ref: https://developer.pdf.co/api/pdf-password/add.md
pdf_remove_passwordC
Remove password protection from a PDF file.
Ref: https://developer.pdf.co/api/pdf-password/remove.md
pdf_info_readerB
Get detailed information about a PDF document - number of pages, metadata, security, form fields, and more.
Ref: https://developer.pdf.co/api/pdf-info-reader.md
ai_invoice_parserB
AI Invoice Parser: Extracts data from invoices using AI.
Ref: https://developer.pdf.co/api/ai-invoice-parser.md
extract_attachmentsC
Extracts attachments from a source PDF file.
Ref: https://developer.pdf.co/api/pdf-extract-attachments.md
pdf_add_annotations_images_fieldsB
Add text, images, forms, other PDFs, fill forms, links to external sites and external PDF files. You can update or modify PDF and scanned PDF files.

This tool supports three main ways to add content:

1. **annotations**: Add text, links, shapes, etc.
   Properties: text, x, y, size, pages, color, link, fontName, fontItalic, fontBold, fontStrikeout, fontUnderline

2. **images**: Add images or other PDF content
   Properties: url, x, y, width, height, pages

3. **fields**: Fill existing form fields
   Properties: fieldName, pages, text, fontName, size, fontBold, fontItalic, fontStrikeout, fontUnderline

Example annotations:
[{"text": "Sample Text - Click here to test link", "x": 250, "y": 240, "size": 24, "pages": "0-", "color": "CCBBAA", "link": "https://pdf.co/", "fontName": "Comic Sans MS", "fontItalic": true, "fontBold": true, "fontStrikeout": false, "fontUnderline": true}]

Example images:
[{"url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-edit/logo.png", "x": 270, "y": 150, "width": 159, "height": 43, "pages": "0"}]

Example fields:
[{"fieldName": "topmostSubform[0].Page1[0].YourSocial_ReadOrderControl[0].f1_05[0]", "pages": "1", "text": "Joan B.", "fontName": "Arial", "size": 6, "fontBold": true, "fontItalic": true, "fontStrikeout": true, "fontUnderline": true}]

Ref: https://developer.pdf.co/api/pdf-add.md

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

C2.9/5.0

Scored across 38 tools

Disambiguation3/5

Most conversion tools target a unique source→target pair, but the PDF-modification cluster (pdf_add_annotations_images_fields, fill_forms, create_fillable_forms) all map to the same /pdf-add endpoint and overlap heavily. Likewise excel_to_pdf, csv_to_pdf, and document_to_pdf all convert spreadsheets to PDF, forcing the agent to guess which to use.

Naming Consistency3/5

The dominant <source>_to_<target> pattern (pdf_to_text, excel_to_csv, document_to_pdf) is readable and predictable, but it is mixed with noun_verb (pdf_merge, pdf_split), verb_noun (upload_file, find_text, extract_attachments), and bare noun (ai_invoice_parser) styles. Three different conventions coexist without a clear rule for which applies where.

Tool Count2/5

38 tools is heavy and partly inflated by redundancy — three Excel→PDF paths, both pdf_to_xls and pdf_to_xlsx, and five excel_to_* converters explicitly marked as retiring in 2027. A conversion matrix naturally needs many entries, but several could be consolidated into parameterized tools.

Completeness3/5

Conversion and inspection coverage is broad (formats in and out, OCR, forms, search, attachments, job polling), but core page-level operations are missing: no delete/rotate/reorder/extract-pages, no compression, and no document splitting by barcode or text. Agents can convert and inspect but cannot fully restructure a PDF.

Maintenance

ActivityMaintained
ResponsivenessNo issues