PDF metadata, in your AI tools.
Inspect page counts, author fields, dates, and software details in ChatGPT, Claude, or your code editor.
Try anonymous analysis. No PDFCheck API key required.
Connect your app
Open web setup or install in your editor.
A few steps, then you’re connected.
Choose your app for instructions. Editor links open an installation prompt; web apps need a custom connection.
ChatGPTCustom app · developer mode
- In ChatGPT on the web, open Settings → Security and login and enable Developer mode.
- Open Plugins, select the plus button, and create an app named PDFCheck. Paste the MCP URL and choose No Authentication.
- Enable PDFCheck from the Developer mode menu in your chat.
Requires an eligible paid ChatGPT plan and permission to use developer mode. Workspace administrators may restrict custom apps. The setup link opens a new tab.
https://pdfcheck.online/api/mcp
This setup uses anonymous access: 10 metadata checks per day per IP. Keep the initial result; anonymous analyses cannot be retrieved later through MCP.
ClaudeCustom connector
- Open Claude’s Connectors settings. Select the plus button, then Add custom connector.
- Name it PDFCheck and paste the MCP URL. Leave the optional OAuth fields empty, then add the connector.
- In a chat, open the plus menu → Connectors and enable PDFCheck.
Free accounts can add one custom connector. Team and Enterprise workspaces require an owner to add it first. The setup link opens a new tab.
https://pdfcheck.online/api/mcp
This setup uses anonymous access: 10 metadata checks per day per IP. Keep the initial result; anonymous analyses cannot be retrieved later through MCP.
VS CodeGitHub Copilot · Agent mode
- Select Add to VS Code, allow your browser to open the editor, and confirm the server configuration.
- Start PDFCheck and review the server trust prompt. Enable its tools in Copilot’s Agent mode.
- If the link does not open, save the configuration in .vscode/mcp.json instead.
Requires VS Code with Copilot Agent support. For saved results and your account allowance, add an API token using the authenticated configuration below.
{
"servers": {
"pdfcheck": {
"type": "http",
"url": "https://pdfcheck.online/api/mcp"
}
}
}
This setup uses anonymous access: 10 metadata checks per day per IP. Keep the initial result; anonymous analyses cannot be retrieved later through MCP.
CursorRemote MCP server
- Select Add to Cursor and allow your browser to open the editor.
- Review the PDFCheck server configuration, install it, and enable its tools in Agent.
- If the link does not open, save the configuration in .cursor/mcp.json instead.
Requires Cursor installed on your computer. For saved results and your account allowance, add an API token using the authenticated configuration below.
{
"mcpServers": {
"pdfcheck": {
"url": "https://pdfcheck.online/api/mcp"
}
}
}
This setup uses anonymous access: 10 metadata checks per day per IP. Keep the initial result; anonymous analyses cannot be retrieved later through MCP.
Windsurf / CascadeManual configuration
- In Windsurf’s Cascade MCP settings, open the raw configuration file.
- Add the pdfcheck entry to mcpServers in ~/.codeium/windsurf/mcp_config.json. Preserve your existing server entries.
- Refresh the server list and enable PDFCheck’s tools in Cascade.
These steps apply to the legacy Cascade client, now documented under Devin Desktop. Devin Local uses a different configuration; follow its current client documentation.
{
"mcpServers": {
"pdfcheck": {
"serverUrl": "https://pdfcheck.online/api/mcp"
}
}
}
This setup uses anonymous access: 10 metadata checks per day per IP. Keep the initial result; anonymous analyses cannot be retrieved later through MCP.
To analyze a PDF, your assistant needs a file-reading tool that can send its base64 contents. Connecting MCP alone does not provide access to your files. Copy the agent instructions
Start with a connection
Try anonymous analysis, or use an API token to connect your account and access its analysis history.
Create your API token
Create a free account, then generate a token in API Tokens. Keep the token in your client settings or environment variables.
Create a free accountUse the MCP endpoint
Add this URL to a client that supports remote HTTP MCP servers. For account access, configure a bearer Authorization header.
https://pdfcheck.online/api/mcp
Anonymous metadata analysis: 10 checks per day per IP. Free account: 100 checks per day. Individual tools can have different limits.
Choose how to connect
Use MCP inside an assistant, REST in your application, or a small shell function in your terminal.
Want to retrieve results later? Use an account token when analyzing.
Create a free accountMCP serverFor assistants that call tools
Connect to the remote HTTP server and let your client discover the available tools. Configuration formats vary by client.
Replace YOUR_API_TOKEN with your account token. For anonymous analysis, omit the headers object. Clients that require OAuth-only connections are not supported by this setup.
Full MCP reference{
"mcpServers": {
"pdfcheck": {
"url": "https://pdfcheck.online/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
Send the PDF contents
The analyze_pdf tool accepts file_base64 and filename. Your client must read the PDF and encode it as base64; a local file path alone will not work.
Example tools/call payload
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "analyze_pdf",
"arguments": {
"file_base64": "BASE64_PDF_CONTENT",
"filename": "document.pdf"
}
}
}
Replace BASE64_PDF_CONTENT with the encoded PDF. MCP returns the result as JSON inside content[0].text.
Using VS Code?
VS Code uses a servers object and an explicit HTTP transport. Store your token through your client’s supported secret settings.
{
"servers": {
"pdfcheck": {
"type": "http",
"url": "https://pdfcheck.online/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_TOKEN"
}
}
}
}
REST APIFor applications and custom agents
Send a PDF as multipart form data. The response contains the analysis ID, file details, metadata, and your remaining checks.
Replace YOUR_API_TOKEN and the file path. Omit the Authorization header to try anonymous analysis.
Read the API docscurl --fail-with-body --show-error \
'https://pdfcheck.online/api/v1/pdf/analyze' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer YOUR_API_TOKEN' \
-F 'file=@./document.pdf'
Work with the response
Read page count from data.metadata.basic.pages and author from data.metadata.document.author. For analyses created with your account token, use data.id to retrieve results later. Keep the initial response when using anonymous analysis.
Text and Markdown extraction are separate REST endpoints. See the tool reference below for availability.
Shell functionFor scripts and terminal agents
This small wrapper calls the REST API using cURL. Add it to your shell configuration, then set PDFCHECK_API_TOKEN in your environment.
Requires cURL. This is a shell wrapper, not a separate CLI package. Run: pdfcheck ./document.pdf
pdfcheck() {
if [ -z "${PDFCHECK_API_TOKEN:-}" ]; then
echo 'Set PDFCHECK_API_TOKEN first.' >&2
return 1
fi
if [ "$#" -ne 1 ] || [ ! -r "$1" ]; then
echo 'Usage: pdfcheck ./document.pdf' >&2
return 1
fi
curl --fail-with-body --show-error \
'https://pdfcheck.online/api/v1/pdf/analyze' \
-H 'Accept: application/json' \
-H "Authorization: Bearer $PDFCHECK_API_TOKEN" \
-F "file=@\"$1\""
}
Know which tools are available
MCP exposes metadata analysis and account history. REST also offers text and Markdown extraction. The browser tool collection has a wider set of PDF utilities.
| Task | REST endpoint | MCP tool |
|---|---|---|
| Analyze metadata | POST/pdf/analyze | analyze_pdf |
| Retrieve an analysis | GET/pdf/{token} | get_analysis |
| List your analyses | GET/pdf | list_analyses |
| Check account usage | GET/user | check_usage |
| Extract text | POST/pdf/extract-text | REST only |
| Convert to Markdown | POST/pdf/to-markdown | REST only |
REST history, saved analyses, and account usage require a token. MCP list_analyses requires a token; get_analysis allows owned or public results. Anonymous MCP analyses are private, so retain the initial response. check_usage also supports anonymous access.
Looking for the browser tools?
These tools have their own upload pages. They are not exposed by the MCP tools listed above; their browser form URLs are not REST endpoints.
Useful signals. Clear limits.
Give your agent the checks it can explain, and keep conclusions tied to the evidence returned.
Inspect the document details
Read author, dates, creator, producer, page count, and PDF version. Metadata can be missing or edited; it does not verify a document’s authenticity.
Treat AI indicators as clues
ReportLab, WeasyPrint, pdf-lib, and similar libraries appear in both AI and non-AI workflows. Their presence does not prove who wrote the content.
Keep specialist review in the workflow
Metadata analysis does not establish signature trust, certify PDF/A or PDF/UA compliance, or confirm accessibility. Use appropriate specialist checks when those outcomes matter.
Give your agent clear instructions
Use these instructions after connecting the tools. A prompt alone does not install an integration or grant access to files.
MCP assistant
When the user asks to inspect a PDF, use PDFCheck’s analyze_pdf tool with file_base64 and filename. Read and base64-encode the file using your client’s file tools. Do not pass a local file path to the remote server.
Read the JSON result from content[0].text. Report the filename, page count, PDF version, author, creator, producer, and dates when present. Explain missing values. Distinguish returned facts from your interpretation.
For analysis created with your account token, use get_analysis with the returned data.id to revisit results. Use list_analyses for account history and check_usage for the current allowance. Retain the initial response from anonymous analysis; it cannot be retrieved later through MCP.
Do not infer AI authorship, document authenticity, signature trust, standards compliance, or accessibility from metadata. Other PDF operations need separately available tools.
REST API agent
When the user asks to inspect PDF metadata, POST the file to /api/v1/pdf/analyze as multipart/form-data using the field file. Use the configured bearer token for account access. Never include the token in your response.
Read data.metadata.basic for page count and PDF version, data.metadata.document for document fields, and data.metadata.dates for dates. Use data.id to retrieve the saved analysis from GET /api/v1/pdf/{token}.
For text extraction, use POST /api/v1/pdf/extract-text. For Markdown, use POST /api/v1/pdf/to-markdown. Both use the multipart pdf field; consult their documentation for limits and response formats.
Handle unsuccessful HTTP responses and quota errors before reporting results. Metadata is editable and cannot prove AI authorship or authenticity.
Reusable PDF skills
Copy these task instructions into your agent’s skill system. Each makes the required tools and limits explicit.
Inspect and explain a PDFMetadata analysis with a consistent report format.
# PDF analysis
Requires: PDFCheck MCP tools or REST API access, plus a file-reading tool.
1. Read the PDF and submit it to analyze_pdf (base64 and filename) or POST /api/v1/pdf/analyze (multipart file).
2. Report filename, page count, PDF version, document fields, and dates returned by the service.
3. Mark missing fields as unavailable. Metadata values are editable and are not authenticity evidence.
4. Include the returned analysis ID. Account-created analyses can be retrieved later; for anonymous MCP analysis, retain the initial response.
5. If a request fails, report the error and a concrete next step without inventing results.
Generate, then inspectCreate a PDF using your own generation tools.
# PDF generation and inspection
Requires: a local PDF-generation library and PDFCheck analysis access. PDFCheck does not expose a PDF-generation API.
1. Generate the document with the tools available in your environment.
2. Open the rendered PDF and review page breaks, text, and images.
3. Submit the PDF to PDFCheck for metadata analysis.
4. Check the returned page count, document fields, and PDF version against the intended output.
5. Use separate specialist validation when accessibility or standards compliance is required.
Review with the right checksSeparate metadata signals from formal validation.
# PDF review
Requires: PDFCheck for metadata; separate tools for structural or formal compliance checks.
1. Inspect metadata with PDFCheck.
2. Use the browser PDF structure checker when appropriate. It is not a public MCP tool.
3. For PDF/A, PDF/UA, accessibility, or signature trust, use suitable specialist validators and manual review.
4. Report each check, its result, and its scope. Never turn metadata indicators into a compliance certificate.
Build a document workflowRoute documents using returned information.
# Document workflow
Requires: PDFCheck REST API plus your own storage, routing, and review tools.
1. Analyze metadata using POST /api/v1/pdf/analyze.
2. Extract text or Markdown using the corresponding REST endpoint if needed.
3. Handle empty output, failed requests, and daily limits.
4. Pass the returned data to your routing rules and flag uncertain cases for review.
5. Use separate tools for compression, merging, or signing. Do not call browser upload endpoints as if they were public API methods.
Put the results to work
Example workflows that combine PDFCheck with your own file, routing, and review tools.
Triage incoming documents
Inspect metadata, extract text through REST, then pass the results to your own routing rules. Send uncertain cases for review.
Check generated output
Create a PDF with your preferred library, visually review it, then compare its reported page count and metadata with the intended output.
Build an analysis index
Analyze documents with an account token. Retrieve saved analyses and use their IDs in your own document index.
Keep the reference close
Request formats, setup details, and plain-text documentation for your agent.
/mcp-server
REST API documentation/api-docs
Short agent reference/llms.txt
Extended agent reference/llms-full.txt
Use the availability table on this page for the supported integration tools.