Document to JSON – PDF Invoice/Statement/Contract Parser
Turn any PDF into structured JSON via AI + OCR: invoices, bank statements, contracts.
Open source Repository Open in the app JSON README (API)
About
Turn any PDF into structured JSON via AI + OCR: invoices, bank statements, contracts.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- fashionmascherine-svg
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Stars
- 8
- Last push
- 2026-06-25T16:25:08Z
- Repository state
- ativo
- Language
- Python
- License
- MIT
- Added
- 2026-08-29 03:02:47
- Updated
- 2026-08-29 03:02:47
- Origin id
io.github.fashionmascherine-svg/document-to-json-mcp
README
# Document-to-JSON Converter
> **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
| 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.