filecheck-mcp is a Model Context Protocol server for the Filecheck API. It lets AI tools work in your Filecheck account. The hosted server is at:
What you can do
- Check files: preflight a PDF or image, fix bleed, colour and fonts, validate PDF/A and PDF/UA, make files smaller, and render page previews. Every file it checks is a normal Filecheck job on your account, so it shows up in your dashboard like any other.
- Set up your products: build workflows, upload rules and preflight profiles for a product, try them on a real file, and make your Shopify products open them. See Set up products with AI.
- Delivery and webhooks: send finished files to SFTP and FTP hotfolders, S3, email or a webhook, with a test delivery first, and set up webhooks for job and proof events. See Set up delivery with AI.
- Storefront: change how the Filecheck upload box appears on your product pages.
- Jobs: find past jobs, read their full preflight reports, and download the fixed files.
Before you start
Open the Dev Hub in your Filecheck dashboard, under API keys, and copy a secret key (sk_…). Create one per AI tool and label it, so you can revoke one without the others. The key goes in your AI tool’s settings or on the Filecheck sign-in page; the model never sees it.
Chat apps connect to the hosted server and sign in: you paste a secret key once, on a Filecheck page, and the app gets its own access from then on. Coding tools can run the server locally with npx, which needs Node.js 18 or later; the local server reads files straight from your disk and saves the fixed copy next to them. Either way, file bytes go to Filecheck over a presigned upload, never through the model’s context.
ChatGPT
- Add the server: turn on developer mode and add a custom MCP server (OpenAI’s guide shows where, for your plan). Name it Filecheck, use the URL
https://api.filecheck.io/mcpand choose OAuth authentication. - Connect: ChatGPT opens a Filecheck page. Paste your secret key and click Allow access.
- Test: ask “Which workflows does my Filecheck account have?”
ChatGPT keeps the list of tools it saw when you added the server. When Filecheck adds new tools, open the connection in ChatGPT’s settings, click Refresh, and start a new chat. On a Business or Enterprise workspace, an admin may need to refresh it.
Claude
- Add the connector: on claude.ai, open Settings → Connectors and click Add custom connector. Name it Filecheck and use the URL
https://api.filecheck.io/mcp. - Connect: click Connect. Claude opens a Filecheck page: paste your secret key and click Allow access.
- Test: ask “Which workflows does my Filecheck account have?”
Claude Desktop
To let Claude Desktop read and save files on your computer, run the local server instead of the connector. Open Settings → Developer → Edit Config and add Filecheck toclaude_desktop_config.json, then restart Claude Desktop:
claude_desktop_config.json
Claude Code
Run in your terminal:claude mcp add --transport http filecheck https://api.filecheck.io/mcp, then /mcp in Claude Code, pick filecheck and choose Authenticate. Your browser opens the Filecheck page.
Cursor
Add to~/.cursor/mcp.json:
~/.cursor/mcp.json
VS Code
Add to.vscode/mcp.json. VS Code asks for the key when the server starts, so it is never written to the file:
.vscode/mcp.json
Codex
Add to~/.codex/config.toml:
~/.codex/config.toml
Any MCP client (hosted server)
If your client cannot runnpx, or you are building your own agent, connect to the hosted server over Streamable HTTP. Clients that support MCP sign-in (OAuth) find the Filecheck sign-in page on their own, as ChatGPT and Claude do. Anything else sends the key as a Bearer header:
For example, in Claude Code:
save_artifact is not available. Long jobs return pending: true after about 20 seconds; the agent then polls with get_job.
A signed-in app acts with the same access as the secret key you pasted. Revoking that key in the Dev Hub disconnects the app at its next request.
Example requests
- “Check business-card.pdf for print. Fix what you can and save the print-ready copy next to it.”
- “Validate every PDF in ./invoices for PDF/A and list the ones that fail, with the reason.”
- “Which jobs failed this week, and what was wrong with them?”
- “Set up business cards at 85 × 55 mm with 3 mm bleed as a draft workflow, and try it on business-card.pdf.”
- “Make the Premium Business Cards product in my Shopify store open that workflow.”
- “Send finished files to our SFTP hotfolder and test the delivery.”
Tools
Check files
Set up your account
Every create and update can run as a dry run first: the record is checked and shown as it would be saved, and nothing changes. When the API refuses a record, the agent gets the field at fault and every problem, and fixes them before trying again. Drafts that are never published are deleted after 30 days.
On WooCommerce, PrestaShop and OpenCart, a product’s workflow is chosen in the Filecheck plugin’s product settings, so the agent builds the workflow and you pick it there.
Reading results
Every job carries two independent fields, and agents are instructed to read both:status: did the check run:pending,running,done,skippedorerror.outcome: the verdict:pass,warn,fail,fixed,unchanged,naormixed.
status: done with outcome: fail means the check completed and the file is not print-ready. The same two-axis model applies across the whole API.
Download URLs are presigned and expire after about 60 minutes.
get_job returns freshly signed URLs on every call, so agents fetch them again instead of storing links.