Schema in, PDF in, JSON out — PDF parsing API for builders & AI agents. PAYG + MCP.

devto

medium

github

0xPdf API  • Peerlist

<h3>About</h3>
<p>This project provides an MCP server for 0xPdf, enabling schema-first PDF to structured JSON conversion specifically designed for AI agents. It acts as a wrapper for the 0xPdf HTTP API, preserving its authentication, billing, and rate limiting features. AI agents can leverage this server to parse invoices and forms into a defined JSON schema, generate schemas dynamically, and manage asynchronous parsing jobs.</p>

<h3>Key Features</h3>
<ul>
<li><strong>Schema-First Parsing:</strong> Converts PDF documents into structured JSON based on a provided schema.</li>
<li><strong>AI Agent Integration:</strong> Designed to work seamlessly with AI agents like Claude and Cursor.</li>
<li><strong>0xPdf API Wrapper:</strong> Utilizes the robust 0xPdf HTTP API for core functionality.</li>
<li><strong>Schema Generation:</strong> Supports generating JSON schemas from natural language descriptions using AI.</li>
<li><strong>Asynchronous Job Processing:</strong> Allows agents to submit parsing jobs and poll for completion.</li>
<li><strong>Tool Support:</strong> Includes tools for synchronous and streaming PDF parsing, job management, schema handling, and pricing information.</li>
</ul>

<h3>Installation</h3>
<p>Install via pip:</p>
pip install oxpdf-mcp
<p>Or using uvx:</p>
uvx oxpdf-mcp
<p>An API key from 0xpdf.io/dashboard is required.</p>

<h3>Configuration for Cursor/Claude Desktop</h3>
<p>Configure your MCP settings with the provided JSON structure, including API endpoints, keys, and allowed hosts/file roots.</p>

<h3>Environment Variables</h3>
<p>Key environment variables include:</p>
<ul>
<li>PDF_PARSING_API_KEY: Your API key (required).</li>
<li>PDF_PARSING_API_BASE_URL: The base URL for the 0xPdf API.</li>
<li>PDF_PARSING_ALLOWED_API_HOSTS: Hosts allowed for API calls (e.g., api.0xpdf.io).</li>
<li>PDF_PARSING_REQUIRE_HTTPS: Set to true for production environments.</li>
<li>PDF_PARSING_ALLOWED_FILE_ROOTS: Specifies allowed directories for PDF files.</li>
</ul>

<h3>SDKs</h3>
<p>In addition to the MCP server, official SDKs are available:</p>
<ul>
<li>Python: oxpdf</li>
<li>JavaScript/TypeScript: @0xpdf/client</li>
</ul>

<h3>License</h3>
<p>This project is licensed under the MIT License.</p>