com.pennyocr/ocr
Read PDFs and images as markdown or text, with exact costs and hard spend caps. $0.75/1k pages.
Open source Repository Open in the app JSON README (API)
About
Read PDFs and images as markdown or text, with exact costs and hard spend caps. $0.75/1k pages.
Details
- Kind
- MCP servers
- Topic
- Files & documents
- Publisher
- com.pennyocr
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 0.1.0
- Last push
- 2026-08-30T18:55:41Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:01:18
- Updated
- 2026-08-29 03:01:18
- Origin id
com.pennyocr/ocr
README
# 🪙 PennyOCR MCP server
A remote [Model Context Protocol](https://modelcontextprotocol.io) server that gives any agent
document-reading eyes: PDFs and images by URL → markdown (tables preserved) or plain text,
with **exact cost reporting and hard spend caps**.
**Hosted at `https://mcp.pennyocr.com`** — nothing to install:
```json
{
"mcpServers": {
"pennyocr": {
"url": "https://mcp.pennyocr.com",
"headers": { "Authorization": "Bearer pk_live_..." }
}
}
}
```
Keys are free (first 100 pages free) at [pennyocr.com/dashboard](https://pennyocr.com/dashboard/).
Clients that can't set headers: `https://mcp.pennyocr.com/?key=pk_live_...`
## Tools
| Tool | Input | Output |
| --- | --- | --- |
| `read_document` | `{url, pages?, output?, max_pages?, max_cost_usd?}` | `{content, pages, cost_usd, citations[]}` |
| `estimate_cost` | `{url, pages?}` | page count + exact cost — **free** |
| `check_balance` | `{}` | remaining credits + free-tier allowance — **free** |
The cost caps refuse *before* any processing, with the numbers — so autonomous agents can
reason about spend ("200 pages, $0.15 — proceed") and can never run past a prepaid balance.
## Transport
Streamable HTTP (JSON-RPC 2.0 over POST), stateless. This repo is the complete server —
a single Cloudflare Worker (`worker.js`) proxying the [PennyOCR API](https://pennyocr.com/docs/).
Pricing: $0.75 per 1,000 pages · [pennyocr.com/pricing.txt](https://pennyocr.com/pricing.txt) ·
Agent onboarding: [pennyocr.com/llms.txt](https://pennyocr.com/llms.txt)