0xPdf MCP
The 0xPdf MCP server enables AI agents to parse PDFs into structured JSON, manage schemas, handle async/batch jobs, and monitor usage via the 0xPdf API.
PDF Parsing
Synchronously parse a single PDF into JSON using a schema (by ID, name, JSON definition, or template), with optional OCR support
Parse a PDF via SSE streaming for real-time results
Submit a single PDF for asynchronous background processing (with optional webhook notification), poll until completion, or check job status at any time
Batch Processing
Submit multiple PDFs at once for async batch parsing
Check batch status/results and poll until all items finish
Schema Management
List all saved JSON schemas in your account
Create and save hand-written or AI-generated schemas
Auto-generate a JSON extraction schema from a natural language description using AI (costs wallet credits)
Refine existing schemas based on new descriptions or selected text
Account & Diagnostics
Check current billing status, wallet balance, and pricing
Verify backend connectivity via health check
Retrieve and reset MCP transport/runtime metrics for debugging and optimization
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@0xPdf MCPparse the PDF at ~/Downloads/invoice.pdf"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
0xPdf MCP
Schema in → PDF in → JSON out for Claude, Cursor, and other MCP clients.
This stdio MCP server wraps the 0xPdf HTTP API (auth, billing, rate limits intact). Agents can parse invoices/forms into a JSON schema, generate schemas, and poll async jobs.

Playground · Docs / MCP setup · Pricing
Install
pip install oxpdf-mcp
# or
uvx oxpdf-mcpGet an API key at 0xpdf.io/dashboard.
Related MCP server: Doc2x MCP Server
Cursor / Claude Desktop
{
"mcpServers": {
"0xpdf": {
"command": "uvx",
"args": ["oxpdf-mcp"],
"env": {
"PDF_PARSING_API_BASE_URL": "https://api.0xpdf.io",
"PDF_PARSING_API_PREFIX": "api/v1",
"PDF_PARSING_API_KEY": "YOUR_API_KEY",
"PDF_PARSING_ALLOWED_API_HOSTS": "api.0xpdf.io",
"PDF_PARSING_REQUIRE_HTTPS": "true",
"PDF_PARSING_ALLOWED_FILE_ROOTS": "/home/YOU/Downloads:/home/YOU/Documents",
"PDF_PARSING_MCP_DISALLOW_FULL_RESPONSE_MODE": "true"
}
}
}
}Or with pip:
"command": "oxpdf-mcp"Tools (selected)
Tool | Purpose |
| Schema-first sync parse |
| Streaming parse (SSE) |
| Async jobs |
| Saved schemas |
| AI schema generation (wallet debit) |
| Balance / pricing |
| Liveness |
Full list and env vars: see source oxpdf_mcp/server.py and docs.
Env
Variable | Default | Notes |
| — | Required for authenticated tools |
|
| Production API |
| — | Required in production ( |
|
| Set |
| CWD | Colon-separated absolute paths for |
SDKs (non-MCP)
Python:
oxpdfJS/TS:
@0xpdf/client
License
MIT
Maintenance
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/risha-max/0xpdf-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server