Skip to main content
Glama
Sign In
deenesjakoruzh
PennyOCR

PennyOCR

by imiraoui
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Remote

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

Related MCP server: shuck-file

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

Cursor plugin

This repository includes a Cursor plugin manifest at .cursor-plugin/plugin.json and a plugin-specific mcp.json. In the plugin configuration, set PENNYOCR_API_KEY to your own API key from https://pennyocr.com/dashboard/. The repository contains only a variable placeholder, never a live key. Document reading uses your PennyOCR credits; use cost estimates and spend caps as appropriate. The separate .mcp.json uses Cursor environment-variable interpolation for direct MCP configuration.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    This server cannot be deployed

    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    Resources

    Related MCP Connectors

    Related MCP Servers

    • document-parser

      agenson-tools
      A
      license
      Not graded
      quality
      Not graded
      maintenance
      Provides AI agents with comprehensive document parsing capabilities including PDF text extraction, OCR, HTML-to-markdown conversion, table extraction, and summarization, optimized for agent workflows.
      72 npm
      MIT

    • shuck-file

      Shan-Zhu
      A
      license
      Not graded
      quality
      D
      maintenance
      Provides AI agents with document conversion to Markdown, intelligently routing small and large files, and enabling targeted extraction via sections, search, and token budgets.
      6
      MIT

    • doc2md

      skyzhao1223
      A
      license
      A
      quality
      B
      maintenance
      Converts documents to clean Markdown for AI agents from a URL or base64 — no API key, built for remote hosting. Supports PDF (tables preserved as Markdown/CSV/JSON), DOCX, PPTX, XLSX, EPUB, HTML and CSV; scanned PDFs and images go through offline OCR. Includes full-text search, page-range reading, metadata inspection, PDF split/merge and image export, with SSRF-protected fetching, 30 MB limits and
      10
      AGPL 3.0