English Français العربية

com.pennyocr/ocr

Official registry Productivity

Read PDFs and images as markdown or text, with exact costs and hard spend caps. $0.75/1k pages.

Source code Website Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http ocr 'https://mcp.pennyocr.com' --header 'Authorization: <Bearer pk_live_... — free API key from https://pennyocr.com/dashboard/ (100 pages/month included)>'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "ocr": {
            "type": "http",
            "url": "https://mcp.pennyocr.com",
            "headers": {
                "Authorization": "<Bearer pk_live_... — free API key from https://pennyocr.com/dashboard/ (100 pages/month included)>"
            }
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

🪙 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

ToolInputOutput
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 com.pennyocr/ocr?

Read PDFs and images as markdown or text, with exact costs and hard spend caps. $0.75/1k pages.

How do I install com.pennyocr/ocr?

It runs as a remote server. In Claude Code: claude mcp add --transport http ocr 'https://mcp.pennyocr.com' --header 'Authorization: <Bearer pk_live_... — free API key from https://pennyocr.com/dashboard/ (100 pages/month included)>'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does com.pennyocr/ocr need an API key?

Yes. It expects Authorization, which you set in its configuration.

Is com.pennyocr/ocr open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains com.pennyocr/ocr?

It is published by imiraoui. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.