PDF.co MCP server
34 operations0 webhooks
PDF API for converting, merging, splitting, editing, and parsing PDFs and documents, and uploading files.
Try PDF.co with your agent
Connect PDF.co, then paste this into Claude, ChatGPT or Cursor. For ideas from other apps, see the use cases.
Using Corsair, show me what you can do in PDF.co on my account, then run one read-only example and show me the result.
PDF.co tools and triggers
Tools are what your agent can do in PDF.co through Corsair's MCP server. Triggers are the PDF.co events a routine can start from.
Account Balance
- Account BalanceRead-only
Get remaining PDF.co credit balance
accountBalance
Barcode Generate
- Barcode GenerateWrite
Generate a barcode image
barcodeGenerate
Document Parser
- Document ParserRead-only
Extract structured data with a parser template
documentParser
Excel To Csv
- Excel To CsvRead-only
Convert Excel to CSV
excelToCsv
Excel To Html
- Excel To HtmlRead-only
Convert Excel to HTML
excelToHtml
Excel To Json
- Excel To JsonRead-only
Convert Excel to JSON
excelToJson
Excel To Text
- Excel To TextRead-only
Convert Excel to plain text
excelToText
Excel To Xml
- Excel To XmlRead-only
Convert Excel to XML
excelToXml
File Upload
- File UploadWrite
Upload a file URL to PDF.co storage
fileUpload
File Upload Base64
- File Upload Base64Write
Upload base64 content to PDF.co storage
fileUploadBase64
Job Check
- Job CheckRead-only
Check an async job status
jobCheck
Pdf Add
- Pdf AddWrite
Overlay text, images, or form values on a PDF
pdfAdd
Pdf Change Text Searchable
- Pdf Change Text SearchableWrite
Make scanned PDF text searchable with OCR
pdfChangeTextSearchable
Pdf Delete Pages
- Pdf Delete PagesWrite
Delete pages from a PDF
pdfDeletePages
Pdf Extract Attachments
- Pdf Extract AttachmentsRead-only
Extract embedded PDF attachments
pdfExtractAttachments
Pdf Find
- Pdf FindRead-only
Find text and coordinates in a PDF
pdfFind
Pdf Forms Info Reader
- Pdf Forms Info ReaderRead-only
Read PDF form field info
pdfFormsInfoReader
Pdf From Email
- Pdf From EmailWrite
Convert an email file to PDF
pdfFromEmail
Pdf From Html
- Pdf From HtmlWrite
Generate PDF from HTML markup
pdfFromHtml
Pdf From Text
- Pdf From TextWrite
Convert a text document to PDF
pdfFromText
Pdf Info Reader
- Pdf Info ReaderRead-only
Read PDF metadata and properties
pdfInfoReader
Pdf Merge
- Pdf MergeWrite
Merge multiple PDFs into one
pdfMerge
Pdf Rotate
- Pdf RotateWrite
Rotate selected PDF pages
pdfRotate
Pdf Search And Delete Text
- Pdf Search And Delete TextWrite
Search and delete text in a PDF
pdfSearchAndDeleteText
Pdf Search And Replace Text
- Pdf Search And Replace TextWrite
Search and replace text in a PDF
pdfSearchAndReplaceText
Pdf Split
- Pdf SplitWrite
Split a PDF into multiple files
pdfSplit
Pdf To Csv
- Pdf To CsvRead-only
Convert PDF to CSV
pdfToCsv
Pdf To Html
- Pdf To HtmlRead-only
Convert PDF to HTML
pdfToHtml
Pdf To Image
- Pdf To ImageRead-only
Convert PDF pages to images
pdfToImage
Pdf To Json
- Pdf To JsonRead-only
Convert PDF to JSON
pdfToJson
Pdf To Text
- Pdf To TextRead-only
Convert PDF to plain text
pdfToText
Pdf To Xls
- Pdf To XlsRead-only
Convert PDF to XLS
pdfToXls
Pdf To Xlsx
- Pdf To XlsxRead-only
Convert PDF to XLSX
pdfToXlsx
Pdf To Xml
- Pdf To XmlRead-only
Convert PDF to XML
pdfToXml
Connect PDF.co to Claude, ChatGPT or Cursor
- 1
Connect PDF.co in Corsair
Add your PDF.co API key once in Corsair. Corsair stores the credential encrypted and makes the PDF.co API calls for your agent, so it never goes into a prompt or a config file. Connect PDF.co
If your link lets the agent add apps, you can skip this: it gives you a sign-in link the first time it needs PDF.co. On a ChatGPT personal plan, connect PDF.co here first.
- 2
Add Corsair's MCP server to your agent
Every client uses the same address:
https://mcp.corsair.dev/mcpOpen Customize → Connectors → Add custom connector, paste the address, then select Connect.Add a custom MCP server with the address and choose OAuth. Personal plans get read tools only.Add to CursorOr add this to~/.cursor/mcp.json. Cursor opens Corsair to sign in the first time it connects.{ "mcpServers": { "corsair": { "url": "https://mcp.corsair.dev/mcp" } } }Run this, then run/mcpin Claude Code to sign in.claude mcp add --transport http corsair https://mcp.corsair.dev/mcpCodex, Gemini CLI, VS Code, Zed and other clients with OAuth sign-in work the same way. Clients without it, such as GitHub Copilot's coding agent, use a link's own address and an API key. Setup for every client
- 3
Sign in and choose what needs your approval
Your client opens Corsair to sign in. Pick a link: the apps your agent can use and a mode that decides what it may do without asking. None of PDF.co's operations are destructive, so in the default Cautious mode they all run right away. Strict mode asks before each of its 14 writes, and Read mode allows reads only.
FAQ
Install corsair and @corsair-dev/pdfco, add the PDF.co plugin, and connect with an API key. Then call methods like corsair.pdfco.api.accountBalance() from your app. Corsair keeps each tenant isolated.
Yes. PDF.co requires an API key from your PDF.co account or developer dashboard. Create credentials with access that matches what you automate, then paste them into Corsair or connect through managed auth in Hub.
Yes. One Corsair client can hit PDF.co, GitHub, Notion, Stripe, and the rest. Trigger PDF.co from a webhook, push updates to Slack, or chain actions across plugins. Same tenant context across integrations, plain TypeScript.
Teams use Corsair for pdf api for converting, merging, splitting, editing, and parsing pdfs and documents, and uploading files. Common builds include sync jobs, admin tooling, and agents that call PDF.co APIs from your backend.
The SDK is open source. Self-host and you pay Corsair nothing for the integration layer. Hub bills for hosted auth and execution, not per PDF.co API call. Hub has a generous free tier. For hobby projects you can probably run the whole thing on free. Paid plans start to matter with more tenants or heavier traffic.
We maintain @corsair-dev/pdfco in the open repo. When PDF.co ships API changes, upgrade the package. Your call sites stay typed. You should not need to rewrite the integration layer each time.
No. Corsair does not read your PDF.co data or hold individual access credentials. Credentials stay in your database. API calls run on your instance. We do not store PDF.co data on your behalf.
Yes. Add https://mcp.corsair.dev/mcp as a custom connector or MCP server in Claude, ChatGPT, Cursor, VS Code, Claude Code, Codex or any client that supports remote MCP servers with OAuth sign-in, then sign in to Corsair. On ChatGPT personal plans, custom servers currently get read tools only.
Yes. Put PDF.co on a link in Strict mode and every write waits for your approval, while destructive actions are refused. None of the PDF.co operations are destructive, so the default Cautious mode runs them all without asking. You can change a link's mode at hub.corsair.dev/me.