Smart OCR

Multi-provider AI OCR and structured JSON/table extraction API for PDFs, invoices, and receipts.

Should I use this

Quality & Safety

A
Description quality
100%
Schema completeness
93%
Naming quality
87%
Poisoning risk
60%
Permission match
100%
Protocol compliance
100%

Findings (3)

  • HIGHTool poisoning patterns detected
  • MEDIUMTool description contains URL to non-standard domainin extract_document_json
  • MEDIUMTool description contains URL to non-standard domainin get_smartocr_status

Based on automated analysis of tool definitions and protocol compliance.

Context Cost

~887Tokens (tool definitions)
~2.2 KBTypical response size
Moderate attention impact (0.69% of 128k context)

This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.

Install

One-Click Install

Add this to your `claude_desktop_config.json` file:

{
  "mcpServers": {
    "smartocr": {
      "url": "https://api.smartocr.dev/mcp"
    }
  }
}

Remote endpoints

https://api.smartocr.dev/mcpstreamable-http

What it can do

Tool inventory

Tools (3)

🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟢extract_document_table(file_url, file_base64, file_name, preset, custom_headers, ...)

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.

Input Schema

{
  "type": "object",
  "properties": {
    "file_url": {
      "type": "string",
      "description": "Public HTTP/HTTPS URL to a PDF, PNG, JPG, WEBP, or TIFF document to extract."
    },
    "file_base64": {
      "type": "string",
      "description": "Base64-encoded document content (raw base64 or data:...;base64,... URI). Provide either file_url or file_base64."
    },
    "file_name": {
      "type": "string",
      "description": "Optional filename with extension (e.g., \"invoice.pdf\", \"statement.pdf\", \"receipt.png\"). Defaults to \"document.pdf\"."
    },
    "preset": {
      "type": "string",
      "enum": [
        "auto",
        "invoice",
        "bank_statement",
        "receipt"
      ],
      "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."
    },
    "custom_headers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional list of custom column headers to extract (e.g., [\"Date\", \"Description\", \"Amount\", \"Balance\"])."
    },
    "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)."
    }
  }
}
🟢extract_document_json(file_url, file_base64, schema, file_name, api_key)

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

Input Schema

{
  "type": "object",
  "properties": {
    "file_url": {
      "type": "string",
      "description": "Public HTTP/HTTPS URL to a PDF, PNG, JPG, WEBP, or TIFF document to extract."
    },
    "file_base64": {
      "type": "string",
      "description": "Base64-encoded document content (raw base64 or data:...;base64,... URI). Provide either file_url or file_base64."
    },
    "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
    },
    "file_name": {
      "type": "string",
      "description": "Optional filename with extension (e.g., \"invoice.pdf\")."
    },
    "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)."
    }
  },
  "required": [
    "schema"
  ]
}
🟢get_smartocr_status(api_key)

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

Input Schema

{
  "type": "object",
  "properties": {
    "api_key": {
      "type": "string",
      "description": "Optional Smart OCR API key to check your remaining API credit balance."
    }
  }
}

Community

Rate this Server

Evidence

Recent observations

verifiedversion not recorded3 tools