# Document to JSON โ€“ PDF Invoice/Statement/Contract Parser [Health: Active] **Category:** โš–๏ธ Legal **Repository:** https://github.com/fashionmascherine-svg/document-to-json-mcp **GitHub Stars:** 8 **Views:** 0 **Installs:** 0 **Upvotes:** 0 **Directory Page:** https://allmcps.com/mcp/document-to-json-pdf-invoice-statement-contract-parser ## Description Turn any PDF into structured JSON via AI + OCR: invoices, bank statements, contracts. ## Claude Desktop Quick Installation Install path detected from listing signals. Uses `npx` (confidence: high): ```json "mcpServers": { "contract-parser": { "command": "npx", "args": ["-y","mcp-remote","https://mcp.apify.com/?actors=opportunity-biz/document-to-json-mcp","--header","Authorization: Bearer YOUR_APIFY_TOKEN"] } } ``` ## Documentation & README # Document-to-JSON Converter > **Turn PDFs into structured JSON in seconds. AI-powered, no coding needed.** ![MCP Server](https://img.shields.io/badge/MCP-Server-blue) ![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg) ![Apify](https://img.shields.io/badge/Apify-Actor-green) --- ## ๐Ÿš€ What does it do? Paste a PDF URL โ†’ get structured JSON. That's it. **Powered by AI.** Instead of rigid templates or fragile regex, an AI model actually *reads and understands* each document โ€” so it adapts to any layout, language, or vendor, and even handles scanned files. That's why the same tool works on an Italian invoice, a Spanish receipt, or an English contract without any configuration. Perfect for: - **Accountants** โ€” extract invoice data (numbers, dates, totals, VAT, IBAN) - **Developers** โ€” automate document processing in your apps - **Business analysts** โ€” convert bank statements to spreadsheets - **Legal teams** โ€” extract contract clauses and dates automatically ## ๐Ÿ“‹ Supported documents | Type | What you get | Price | |---|---|---| | **Invoice** | Seller, buyer, line items, totals, VAT, IBAN, payment info | $0.01 | | **Bank Statement** | All transactions, balances, fees, account holder | $0.015 | | **Contract** | Parties, key clauses, dates, financial terms, jurisdiction | $0.02 | | **Generic** | Full text + tables from any document | **Free during launch** | ## โœจ Example output ```json { "success": true, "data": { "document_type": "invoice", "confidence": 0.97, "metadata": { "invoice_number": "INV-2024-00123", "invoice_date": "2024-03-15", "currency": "EUR" }, "seller": { "name": "Acme S.p.A.", "vat_id": "IT01234567890" }, "line_items": [ { "description": "Consulting services", "quantity": 1, "unit_price": 5000.00, "net_amount": 5000.00, "vat_rate": 22.0, "total": 6100.00 } ], "totals": { "net_total": 5000.00, "vat_total": 1100.00, "grand_total": 6100.00 }, "payment_info": { "iban": "IT60X0542811101000000123456" } } } ``` ## ๐Ÿงช Live examples โ€” try them now Run the Actor on these public sample PDFs (synthetic data) to see the extraction quality for yourself: | Type | Sample PDF | What the AI extracts (highlights) | |---|---|---| | **Invoice** | [sample-invoice.pdf](https://raw.githubusercontent.com/fashionmascherine-svg/document-to-json-mcp/main/examples/sample-invoice.pdf) | Invoice `INV-2026-0042`, seller + buyer with VAT IDs, 2 line items, VAT 22%, **grand total โ‚ฌ1,889.78** โ€” *confidence 1.0* | | **Bank statement** | [sample-bank-statement.pdf](https://raw.githubusercontent.com/fashionmascherine-svg/document-to-json-mcp/main/examples/sample-bank-statement.pdf) | 7 transactions auto-categorized, opening/closing balances **reconciled to โ‚ฌ8,655.28** โ€” *confidence 1.0* | | **Contract** | [sample-contract.pdf](https://raw.githubusercontent.com/fashionmascherine-svg/document-to-json-mcp/main/examples/sample-contract.pdf) | 2 parties + roles, effective/expiry/renewal dates, fee โ‚ฌ5,000, **5 key clauses** with summaries, jurisdiction โ€” *confidence 0.95* | Just paste one of these URLs as `file_url`, pick the matching `document_type`, and run. Each extraction takes ~15โ€“20 seconds. ## ๐ŸŽฏ Why this Actor? | Feature | Benefit | |---|---| | **AI understanding** | An AI reads documents like a human โ€” adapts to any layout, no templates or rules to maintain | | **Multi-language** | English, Italian, Spanish (OCR) | | **OCR included** | Works with scanned documents too | | **Validation** | Auto-checks totals and dates for accuracy | | **Pay per use** | No subscription, pay only for what you process | ## ๐Ÿ”ง How to use 1. **Get a public PDF URL** (Dropbox, Google Drive, your server) 2. **Select the document type** 3. **Run the Actor** 4. **Get your JSON** in seconds That's it. No configuration, no API keys needed. ## ๐Ÿ’ฐ Pricing | Document type | Price | |---|---| | Invoice | **$0.01** ($10/1000) | | Bank statement | **$0.015** ($15/1000) | | Contract | **$0.02** ($20/1000) | | Generic | **Free during launch** | *Pay-per-event via Apify. Pay only for successful extractions. No subscription, no hidden fees.* ## ๐Ÿ”’ Privacy - PDFs are processed and **not stored** after extraction - Data is available in your private dataset - All API keys stay encrypted ## ๐Ÿ“š Supported OCR languages `eng` (English), `ita` (Italian), `spa` (Spanish) Combine with `+` for multi-language scanned documents: `eng+ita+spa` (default) ## ๐Ÿค– Built for AI agents (MCP) This Actor is an **MCP server**: AI agents can call it directly as a tool to turn any PDF into JSON, with zero configuration โ€” just pass a public `file_url`. Specialized tools (`parse_invoice`, `parse_bank_statement`, `parse_contract`) and a free `parse_generic_document` make it easy for an LLM to pick the right one for the task. ## ๐Ÿ”Œ Integrations > Replace `YOUR_APIFY_TOKEN` with your token from [Apify โ†’ Settings โ†’ Integrations](https://console.apify.com/account/integrations). ### Claude Code (CLI) ```bash claude mcp add --transport http apify \ "https://mcp.apify.com/?actors=opportunity-biz/document-to-json-mcp" ``` ### Claude Desktop / Cursor (MCP) Add to your MCP config (`claude_desktop_config.json` or Cursor's `mcp.json`): ```json { "mcpServers": { "document-to-json": { "command": "npx", "args": [ "-y", "mcp-remote", "https://mcp.apify.com/?actors=opportunity-biz/document-to-json-mcp", "--header", "Authorization: Bearer YOUR_APIFY_TOKEN" ] } } } ``` The agent then sees `parse_invoice`, `parse_bank_statement`, `parse_contract`, and `parse_generic_document` as tools and calls them on its own. ### REST API (any language) One call in, JSON out โ€” `run-sync-get-dataset-items` returns the result directly: ```bash curl -X POST \ "https://api.apify.com/v2/acts/opportunity-biz~document-to-json-mcp/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \ -H "Content-Type: application/json" \ -d '{"file_url": "https://example.com/invoice.pdf", "document_type": "invoice", "validate_totals": true}' ``` ### Python ```python from apify_client import ApifyClient client = ApifyClient("YOUR_APIFY_TOKEN") run = client.actor("opportunity-biz/document-to-json-mcp").call(run_input={ "file_url": "https://example.com/invoice.pdf", "document_type": "invoice", }) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) ``` ### JavaScript / TypeScript ```javascript import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' }); const run = await client.actor('opportunity-biz/document-to-json-mcp').call({ file_url: 'https://example.com/invoice.pdf', document_type: 'invoice', }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(items); ``` ### n8n Use an **HTTP Request** node (POST) to the REST API URL above, or the official **Apify** node โ†’ select `document-to-json-mcp` โ†’ set `file_url` and `document_type`. Great for "watch inbox โ†’ extract invoice โ†’ append to Google Sheet" workflows. ### LangChain / CrewAI / any MCP framework Point your agent framework's MCP client at `https://mcp.apify.com/?actors=opportunity-biz/document-to-json-mcp` โ€” the parsing tools are exposed automatically.