Extract custom JSON schemas and Excel/CSV tables from PDFs, invoices, statements, and receipts.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Extract strict, structured JSON matching any custom JSON schema or field template from a PDF or image (PNG, JPG, WEBP, TIFF). Ideal for developer pipelines, ERP/accounting ingestion, and custom document fields. Works on the free tier (2 free docs/day) or with a Smart OCR API key (10 free credits at https://smartocr.dev).
Target JSON schema or key-value object template describing the fields to extract (e.g., {"vendorName": "string", "invoiceNumber": "string", "invoiceDate": "string", "totalAmount": "number", "lineItems": [{"description": "string", "quantity": "number", "amount": "number"}]}).
Optional Smart OCR API key from https://smartocr.dev (can also be sent via x-api-key header). If omitted, uses the free tier (2 free docs/day).
Public HTTP/HTTPS URL to a PDF, PNG, JPG, WEBP, or TIFF document to extract.
Optional filename with extension (e.g., "invoice.pdf").
Base64-encoded document content (raw base64 or data:...;base64,... URI). Provide either file_url or file_base64.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http smart-ocr-pdf-invoice-receipt-json https://api.smartocr.dev/mcp
Extract strict, structured JSON matching any custom JSON schema or field template from a PDF or image (PNG, JPG, WEBP, TIFF). Ideal for developer pipelines, ERP/accounting ingestion, and custom document fields. Works on the free tier (2 free docs/day) or with a Smart OCR API key (10 free credits at https://smartocr.dev).
| Argument | Type | Description |
|---|---|---|
| schema* | object | Target JSON schema or key-value object template describing the fields to extract (e.g., {"vendorName": "string", "invoiceNumber": "string", "invoiceDate": "string", "totalAmount": "number", "lineItems": [{"description": "string", "quantity": "number", "amount": "number"}]}). |
| api_key | string | Optional Smart OCR API key from https://smartocr.dev (can also be sent via x-api-key header). If omitted, uses the free tier (2 free docs/day). |
| file_url | string | Public HTTP/HTTPS URL to a PDF, PNG, JPG, WEBP, or TIFF document to extract. |
| file_name | string | Optional filename with extension (e.g., "invoice.pdf"). |
| file_base64 | string | Base64-encoded document content (raw base64 or data:...;base64,... URI). Provide either file_url or file_base64. |
{
"type": "object",
"required": [
"schema"
],
"properties": {
"schema": {
"type": "object",
"description": "Target JSON schema or key-value object template describing the fields to extract (e.g., {\"vendorName\": \"string\", \"invoiceNumber\": \"string\", \"invoiceDate\": \"string\", \"totalAmount\": \"number\", \"lineItems\": [{\"description\": \"string\", \"quantity\": \"number\", \"amount\": \"number\"}]}).",
"additionalProperties": true
},
"api_key": {
"type": "string",
"description": "Optional Smart OCR API key from https://smartocr.dev (can also be sent via x-api-key header). If omitted, uses the free tier (2 free docs/day)."
},
"file_url": {
"type": "string",
"description": "Public HTTP/HTTPS URL to a PDF, PNG, JPG, WEBP, or TIFF document to extract."
},
"file_name": {
"type": "string",
"description": "Optional filename with extension (e.g., \"invoice.pdf\")."
},
"file_base64": {
"type": "string",
"description": "Base64-encoded document content (raw base64 or data:...;base64,... URI). Provide either file_url or file_base64."
}
}
}Extract structured table rows (line items, transactions, headers, document metadata, summary totals, Markdown table, and CSV) from a PDF or image (invoice, bank statement, credit card statement, receipt, timesheet, or scanned table). Works immediately on the free tier (2 free documents/day) or with an optional Smart OCR API key.
| Argument | Type | Description |
|---|---|---|
| preset | string | Document preset: "invoice" for vendor invoices/bills, "bank_statement" for bank or credit card statements, "receipt" for retail/expense receipts, or "auto" to auto-detect. |
| api_key | string | Optional Smart OCR API key from https://smartocr.dev (can also be sent via x-api-key header). If omitted, uses the free tier (2 free docs/day). |
| file_url | string | Public HTTP/HTTPS URL to a PDF, PNG, JPG, WEBP, or TIFF document to extract. |
| file_name | string | Optional filename with extension (e.g., "invoice.pdf", "statement.pdf", "receipt.png"). Defaults to "document.pdf". |
| file_base64 | string | Base64-encoded document content (raw base64 or data:...;base64,... URI). Provide either file_url or file_base64. |
| custom_headers | array | Optional list of custom column headers to extract (e.g., ["Date", "Description", "Amount", "Balance"]). |
{
"type": "object",
"properties": {
"preset": {
"enum": [
"auto",
"invoice",
"bank_statement",
"receipt"
],
"type": "string",
"description": "Document preset: \"invoice\" for vendor invoices/bills, \"bank_statement\" for bank or credit card statements, \"receipt\" for retail/expense receipts, or \"auto\" to auto-detect."
},
"api_key": {
"type": "string",
"description": "Optional Smart OCR API key from https://smartocr.dev (can also be sent via x-api-key header). If omitted, uses the free tier (2 free docs/day)."
},
"file_url": {
"type": "string",
"description": "Public HTTP/HTTPS URL to a PDF, PNG, JPG, WEBP, or TIFF document to extract."
},
"file_name": {
"type": "string",
"description": "Optional filename with extension (e.g., \"invoice.pdf\", \"statement.pdf\", \"receipt.png\"). Defaults to \"document.pdf\"."
},
"file_base64": {
"type": "string",
"description": "Base64-encoded document content (raw base64 or data:...;base64,... URI). Provide either file_url or file_base64."
},
"custom_headers": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional list of custom column headers to extract (e.g., [\"Date\", \"Description\", \"Amount\", \"Balance\"])."
}
}
}Check Smart OCR service status, remaining free daily document quota (2 free documents/day), or developer API key credit balance, plus links to the web converter (https://read.smartocr.dev) and API portal (https://smartocr.dev).
| Argument | Type | Description |
|---|---|---|
| api_key | string | Optional Smart OCR API key to check your remaining API credit balance. |
{
"type": "object",
"properties": {
"api_key": {
"type": "string",
"description": "Optional Smart OCR API key to check your remaining API credit balance."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 20, 2026.
Takes a password, API key or token as an argument, so the secret passes through the model's context and chat logs.
Fix: Read credentials from the server's own configuration (environment, OAuth) instead of a tool argument.