pennyocr-mcp
๐ช Remote MCP server: read any PDF/image into agent context with exact cost reporting. Hosted at mcp.pennyocr.com
Documentation
๐ช PennyOCR MCP server
A remote Model Context Protocol 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:
{
"mcpServers": {
"pennyocr": {
"url": "https://mcp.pennyocr.com",
"headers": { "Authorization": "Bearer pk_live_..." }
}
}
}Keys are free (first 100 pages free) at 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.
Pricing: $0.75 per 1,000 pages ยท pennyocr.com/pricing.txt ยท
Agent onboarding: pennyocr.com/llms.txt
Frequently asked questions
What is pennyocr-mcp?
pennyocr-mcp is ๐ช Remote MCP server: read any PDF/image into agent context with exact cost reporting. Hosted at mcp.pennyocr.com
How do I install pennyocr-mcp?
Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.
Is pennyocr-mcp open source?
Yes โ it is hosted on GitHub at https://github.com/imiraoui/pennyocr-mcp.
Related MCP tools
๐ฅ Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.
This is a 12306 ticket search server based on the Model Context Protocol (MCP).
Official remote MCP server for Atlassian. Securely connect Jira, Confluence, Jira Service Management, Bitbucket, and Compass to Claude, ChatGPT, Cursor, VS Code, and other AI tools using OAuth 2.1 or API tokens.
A model context protocol server to work with JetBrains IDEs: IntelliJ, PyCharm, WebStorm, etc. Also, works with Android Studio
Give your AI agent eyes for PDFs โ structured text, tables, OCR, visual evidence, and page-level citations via MCP. Native Rust, local-first.
๐ฅ Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients. JavaScript-based implementation.
Run your own MCP server? See who uses it and what to fix.
Measure it with TrackMCP