Document-to-JSON Converter

MCP serverDocs & knowledge

This integration lets your AI turn PDF documents into structured JSON. Invoices, bank statements, and contracts become organized data your AI can read and work with. Scanned pages are handled too, using built-in OCR.

Use Document-to-JSON Converter in Claude, ChatGPT or Ahel Desktop

Free. Sign in, add Document-to-JSON Converter and connect your AI. About a minute.

Also: Claude Code · Cursor · Codex

Then ask your AI: use Document-to-JSON Converter

Details

Available today. Use it from your connected AI after setup.

Add the integration, then share a PDF with your AI and ask it to convert the document to JSON.

Document-to-JSON ConverterStart free

What your AI can do with it

  • Convert PDF invoices into structured JSON
  • Extract data from bank statements
  • Turn contracts into organized JSON
  • Read scanned documents using OCR
  • Get document contents as structured data your AI can use

Install Document-to-JSON Converter

The server’s own address, for the clients that take one directly. Or connect Ahel once and every client you use reads it from one address, with the account kept on Ahel rather than in each client’s config.

  • Claude Code

    claude mcp add --transport http --scope user document-to-json-converter 'https://mcp.apify.com/?actors=opportunity-biz/document-to-json-mcp'

    Run it once in your project, then open /mcp to approve any sign-in the server asks for.

  • Claude Desktop

    https://mcp.apify.com/?actors=opportunity-biz/document-to-json-mcp

    Add a custom connector in Settings, paste this address, and approve the sign-in.

  • Cursor

    cursor://anysphere.cursor-deeplink/mcp/install?name=document-to-json-converter&config=eyJ1cmwiOiJodHRwczovL21jcC5hcGlmeS5jb20vP2FjdG9ycz1vcHBvcnR1bml0eS1iaXovZG9jdW1lbnQtdG8tanNvbi1tY3AifQ==

    Open the link and Cursor adds the server at that address.

  • ChatGPT

    https://mcp.apify.com/?actors=opportunity-biz/document-to-json-mcp

    In Settings, enable Developer mode, create an MCP app, and paste this address. Your plan and workspace must allow custom apps.

  • Codex

    codex mcp add document-to-json-converter --url 'https://mcp.apify.com/?actors=opportunity-biz/document-to-json-mcp'

    Run it once, then sign in with codex mcp login document-to-json-converter if the server asks for an account.

From the project's README

As published by fashionmascherine-svg/document-to-json-mcp in README.md.

Turn PDFs into structured JSON in seconds. AI-powered, no coding needed.


🚀 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

TypeWhat you getPrice
InvoiceSeller, buyer, line items, totals, VAT, IBAN, payment info$0.01
Bank StatementAll transactions, balances, fees, account holder$0.015
ContractParties, key clauses, dates, financial terms, jurisdiction$0.02
GenericFull text + tables from any documentFree during launch

✨ Example output

{
  "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:

TypeSample PDFWhat the AI extracts (highlights)
Invoicesample-invoice.pdfInvoice INV-2026-0042, seller + buyer with VAT IDs, 2 line items, VAT 22%, grand total €1,889.78 — confidence 1.0
Bank statementsample-bank-statement.pdf7 transactions auto-categorized, opening/closing balances reconciled to €8,655.28 — confidence 1.0
Contractsample-contract.pdf2 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?

FeatureBenefit
AI understandingAn AI reads documents like a human — adapts to any layout, no templates or rules to maintain
Multi-languageEnglish, Italian, Spanish (OCR)
OCR includedWorks with scanned documents too
ValidationAuto-checks totals and dates for accuracy
Pay per useNo 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 typePrice
Invoice$0.01 ($10/1000)
Bank statement$0.015 ($15/1000)
Contract$0.02 ($20/1000)
GenericFree 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.

Claude Code (CLI)

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):

{
  "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:

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

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

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.

Signals

GitHub stars
8
Last commit
Jun 2026
Advanced
Delivery
document-to-json-mcp MCP server → your Ahel connector (mcp.ahel.ai) → your AI.
Item type
mcp-server
Key
io-github-fashionmascherine-svg-document-to-json-mcp
Source
github.com/fashionmascherine-svg/document-to-json-mcp
Hosted endpoint
https://mcp.apify.com/?actors=opportunity-biz/document-to-json-mcp