Smart OCR
io.github.Saneth98/smartocr
Multi-provider AI OCR and structured JSON/table extraction API for PDFs, invoices, and receipts.
Connect this server
One click to install, or copy the config below. Suits: Cursor · HTTP clients.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"smartocr": {
"url": "https://api.smartocr.dev/mcp"
}
}
}claude mcp add --transport http smartocr https://api.smartocr.dev/mcpcode --add-mcp '{"name":"smartocr","type":"http","url":"https://api.smartocr.dev/mcp"}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- Documents & Knowledge
- Version
- 1.0.1
- Registry
- active
- Published
- 11/21/2026
Is it safe? Is it maintained?
Serverdex check: Nov 22, 2026Mostly fine: Smart OCR is hosted endpoint answering without a key.
- Maintained
- No commit data
- The repository has not been read yet, so the last-commit date is unknown.
- Official registry
- Active
- Published as io.github.Saneth98/smartocr in the official MCP registry, version 1.0.1.
- Source
- No licence found
- Public repository, but GitHub reports no recognised licence. Check the README before shipping it in a product.
- Runs
- Hosted by the publisher
- Your client talks to api.smartocr.dev: prompts and tool arguments leave your machine for that host.
- Credentials
- None needed to connect
- The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
- Owner
- Unclaimed
- Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.
Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.
Live check
checked Nov 22, 2026, 08:07 UTCStatus history & uptime →The endpoint answered the MCP handshake as "smartocr-mcp" and listed 3 tools. Answering since Nov 21, 2026.
Context cost ≈ 957 tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 3 tools.
Tools (3)
extract_document_table6 paramsExtract 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.
Show parametersHide parameters
file_urlstringPublic HTTP/HTTPS URL to a PDF, PNG, JPG, WEBP, or TIFF document to extract.file_base64stringBase64-encoded document content (raw base64 or data:...;base64,... URI). Provide either file_url or file_base64.file_namestringOptional filename with extension (e.g., "invoice.pdf", "statement.pdf", "receipt.png"). Defaults to "document.pdf".presetstringDocument preset: "invoice" for vendor invoices/bills, "bank_statement" for bank or credit card statements, "receipt" for retail/expense receipts, or "auto" to acustom_headersarrayOptional list of custom column headers to extract (e.g., ["Date", "Description", "Amount", "Balance"]).api_keystringOptional 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_json5 paramsExtract 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).
Show parametersHide parameters
file_urlstringPublic HTTP/HTTPS URL to a PDF, PNG, JPG, WEBP, or TIFF document to extract.file_base64stringBase64-encoded document content (raw base64 or data:...;base64,... URI). Provide either file_url or file_base64.schemaobjectrequiredTarget JSON schema or key-value object template describing the fields to extract (e.g., {"vendorName": "string", "invoiceNumber": "string", "invoiceDate": "strifile_namestringOptional filename with extension (e.g., "invoice.pdf").api_keystringOptional 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).
get_smartocr_status1 paramCheck 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).
Show parametersHide parameters
api_keystringOptional Smart OCR API key to check your remaining API credit balance.
Checked by Serverdex with a plain initialize + tools/list call to api.smartocr.dev/mcp, no credentials, about once a day. A failed check is never a removal.
Remotes
- streamable-http
https://api.smartocr.dev/mcp
Alternatives to Smart OCR
All Smart OCR alternatives →Best Documents & Knowledge servers →The most-starred Documents & Knowledge servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Context7 | 65,010 | Nov 2026 | Working |
| Codebase Memory | 48,994 | Nov 2026 | Local / not checked |
| Reactive Resume | 45,960 | Nov 2026 | Needs sign-in |
| Sui Knowledge Base (kapa.ai) | 7,785 | Nov 2026 | Needs sign-in |
| Agent-Native Slides | 7,735 | Nov 2026 | Needs sign-in |
Smart OCR: questions people ask
- Is Smart OCR a remote or a local MCP server?
- According to its entry in the official MCP registry, Smart OCR ships as a hosted endpoint (streamable-http) that your client connects to by URL.
- Does Smart OCR need an API key?
- Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
- Is Smart OCR safe to use?
- Mostly fine: Smart OCR is hosted endpoint answering without a key. In detail — maintained: No commit data; official registry: Active; source: No licence found; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
- What tools does Smart OCR expose?
- 3 tools as listed by the server itself during the live check, including extract_document_table, extract_document_json, get_smartocr_status. The full list with parameters is in the Live check section above.
- How do I add Smart OCR to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More from Saneth98
All 2 servers by Saneth98 →More Documents & Knowledge servers
Browse all Documents & Knowledge →Free the Tools
sapience-design
Local PDF, image, data and text tools for AI assistants. Files stay on your computer.
World Model MCP
SaravananJaichandar
Temporal knowledge graph for codebases with constraint enforcement at the edit boundary.
mdshare
urbanmorph
Share markdown as a link anyone can comment on and edit, no account. MCP server and CLI.
MCP Server for Excel
sbroenne
Excel automation for AI - Sheets, Power Query, DAX, VBA, Tables, Ranges and more. Windows only.
MCP Server for PowerPoint
sbroenne
Create, edit, and export presentations with AI. Requires desktop Microsoft PowerPoint on Windows.
Quipu
scbrown
Local knowledge graph memory for agents. SHACL rules refuse bad facts; SPARQL and time travel.
Add the badge to your site
Show visitors that Smart OCR is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/io-github-saneth98-smartocr?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="Smart OCR — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/io-github-saneth98-smartocr?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.
Install buttons — for your README
[](https://serverdex.io/install/cursor/io-github-saneth98-smartocr) [](https://serverdex.io/install/vscode/io-github-saneth98-smartocr) [](https://serverdex.io/install/claude-code/io-github-saneth98-smartocr)One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.
Install buttons — HTML for your docs
<a href="https://serverdex.io/install/cursor/io-github-saneth98-smartocr"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/io-github-saneth98-smartocr"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/io-github-saneth98-smartocr"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>Same buttons as plain links for a docs page or website.
Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).