Skip to main content
Glama

0xPdf MCP

PyPI 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.

0xPdf — schema in, PDF in, JSON out

Playground · Docs / MCP setup · Pricing

Install

pip install oxpdf-mcp
# or
uvx oxpdf-mcp

Get an API key at 0xpdf.io/dashboard.

Related MCP server: PDF Figures 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

parse_pdf_sync

Schema-first sync parse

parse_pdf_stream

Streaming parse (SSE)

submit_parse_job / wait_for_job_completion

Async jobs

list_schemas / create_schema

Saved schemas

generate_schema_from_description

AI schema generation (wallet debit)

get_pricing_current

Balance / pricing

health_check

Liveness

Full list and env vars: see source oxpdf_mcp/server.py and docs.

Env

Variable

Default

Notes

PDF_PARSING_API_KEY

—

Required for authenticated tools

PDF_PARSING_API_BASE_URL

https://api.0xpdf.io

Production API

PDF_PARSING_ALLOWED_API_HOSTS

—

Required in production (api.0xpdf.io)

PDF_PARSING_REQUIRE_HTTPS

false

Set true for production

PDF_PARSING_ALLOWED_FILE_ROOTS

CWD

Colon-separated absolute paths for pdf_path

SDKs (non-MCP)

License

MIT

Available Tools

15 tools
create_schemaA

Save a JSON schema to your account (POST /api/v1/schemas). Requires API key. No wallet charge per save; subject to max saved schemas limit. Use after generate_schema_from_description or for hand-written schemas.

Inputs: name (required), schema_def (required), is_default, response_mode, +1 more. Returns: object

generate_schema_from_descriptionA

AI-generate a JSON schema from a description (POST /api/v1/schemas/generate). Requires API key, payment method, and prepaid wallet balance. Debits the same wallet ledger as PDF/OCR parsing on each successful generation. Pair with create_schema to persist.

Inputs: description (required), refinement, response_mode, selected_text, +2 more. Returns: object

get_mcp_runtime_metricsA

Get MCP runtime transport metrics for optimization/debugging.

Inputs: no named parameters. Returns: object

get_parse_batch_statusC

Get status for an async parse batch created by submit_parse_batch.

Inputs: batch_id (required), item_limit, include_items, response_mode, +2 more. Returns: object

get_parse_job_statusC

Get status for an async parse job created by submit_parse_job.

Inputs: job_id (required), response_mode, include_result, max_estimated_tokens_override. Returns: object

get_pricing_currentC

Get current billing/pricing status for the authenticated user.

Inputs: response_mode, max_estimated_tokens_override. Returns: object

health_checkA

Health check for backend connectivity. Useful before running parse tools.

Inputs: no named parameters. Returns: object

list_schemasC

List user schemas from /api/v1/schemas.

Inputs: limit, offset, response_mode, max_estimated_tokens_override. Returns: object

parse_pdf_streamC

Parse one PDF as SSE stream through /api/v1/pdf/parse-stream.

Inputs: pdf_path (required), pages, use_ocr, schema_id, +9 more. Returns: object

parse_pdf_syncC

Parse one PDF synchronously through /api/v1/pdf/parse.

Inputs: pdf_path (required), pages, use_ocr, schema_id, +6 more. Returns: object

reset_mcp_runtime_metricsA

Reset MCP runtime transport metrics counters.

Inputs: no named parameters. Returns: object

submit_parse_batchC

Submit multiple PDFs for async batch parsing via /api/v1/pdf/batch.

Inputs: pdf_paths (required), use_ocr, schema_id, ocr_engine, +4 more. Returns: object

submit_parse_jobC

Submit one PDF for async processing via /api/v1/pdf/upload.

Inputs: pdf_path (required), use_ocr, schema_id, ocr_engine, +4 more. Returns: object

wait_for_batch_completionA

Poll batch status with exponential backoff and jitter until it is completed/failed/partial or times out.

Inputs: batch_id (required), jitter_factor, timeout_seconds, max_interval_seconds, +1 more. Returns: object

wait_for_job_completionA

Poll job status with exponential backoff and jitter until it is completed/failed or times out.

Inputs: job_id (required), jitter_factor, timeout_seconds, max_interval_seconds, +1 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 15 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose. PDF parsing tools differentiate by sync/stream/async modes, schema tools are separate from parsing, and status, metrics, health, and pricing tools are all unique with no overlap.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern in lowercase snake_case, e.g., create_schema, get_parse_job_status, wait_for_batch_completion. No mixed conventions or vague verbs.

    Tool Count5/5

    15 tools is well-scoped for the domain of PDF parsing and schema management. Each tool serves a necessary role without bloat.

    Completeness4/5

    Covers core workflows: PDF parsing (sync, stream, async), schema generation/persistence, status polling, and administrative tools. Minor gap: no schema update or delete, and no cancel/retry for async jobs.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to parse and convert PDFs and images to structured text formats using the Doc2x v2 API. Supports asynchronous document processing, format conversion, and file downloads with configurable polling and timeout settings.
      14
      65 npm
      3
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Extracts figures and tables from PDF documents via a FastAPI service, wrapping PDFFigures 2.0. Enables AI agents to programmatically retrieve structured figure and table data from scholarly PDFs.
      9
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Extracts text and tables from PDFs for AI agents via MCP, enabling structured data retrieval from invoices, reports, and statements.
      49 PyPI
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to parse and analyze PDF invoices, including text, field, and table extraction, OCR for scanned documents, ZUGFeRD support, compliance validation, and batch processing via MCP.
      -