fastocr-mcp 0.2.0

OCR any scanned PDF or image from Claude, Cursor and other MCP clients.

Website · Docs · Get an API key

An MCP server that lets your client OCR a local scanned PDF or image over stdio; files go only to the FastOCR API.

Quickstart

1. Create an API key in the developer console.
2. Add the server to Claude Code:

claude mcp add fastocr -e FASTOCR_API_KEY=your_api_key -- uvx fastocr-mcp

3. Ask: "OCR ~/Scans/contract.pdf".

With uv there is nothing to install; the client runs uvx fastocr-mcp. Prefer pip? Run pip install fastocr-mcp and use the command fastocr-mcp. Python 3.10 or newer.

Other clients

Every client needs the same command, uvx fastocr-mcp, and your key in FASTOCR_API_KEY.

{
  "mcpServers": {
    "fastocr": {
      "command": "uvx",
      "args": ["fastocr-mcp"],
      "env": { "FASTOCR_API_KEY": "your_api_key" }
    }
  }
}

{
  "mcpServers": {
    "fastocr": {
      "type": "stdio",
      "command": "uvx",
      "args": ["fastocr-mcp"],
      "env": { "FASTOCR_API_KEY": "your_api_key" }
    }
  }
}

{
  "servers": {
    "fastocr": {
      "type": "stdio",
      "command": "uvx",
      "args": ["fastocr-mcp"],
      "env": { "FASTOCR_API_KEY": "your_api_key" }
    }
  }
}

If you installed with pip, use "command": "fastocr-mcp" and "args": [].

Examples

Ask your client in plain language:

• "OCR ~/Downloads/scanned-contract.pdf and summarize the termination clause."
• "Read the text in /Users/me/Desktop/receipt.jpg."
• "Make a searchable copy of /Users/me/archive/1998-letters.pdf."
• "List my last five FastOCR documents."

The text above is the unedited output FastOCR returned for a scanned page.

Tools

What you get back

Languages and files

• 100+ languages, detected automatically. No language setting is needed.
• PDF files up to 1 GiB, and PNG, JPG, JPEG, GIF, WebP and BMP images up to 20 MiB. An image counts as one page.
• Built on the official fastocr-sdk and the official MCP Python SDK.

Pages and pricing

Any signed-in FastOCR account can create an API key and start right away. Every account gets 50 free pages a month, shared with PDFs on the website; an image is one page. When you need more, buy a Page Pack on the pricing page. Packs and the page balance are the same on the website and in the API; ask your agent to run get_balance to see what is left. Accounts process 2 documents at once, or 10 with an API contract or 10,000 or more pages bought. You accept the API terms with your first key.

Support and license

Questions: support@fastocr.org. Bugs and requests: GitHub issues. Python SDK: fastocr-python. MIT license; see LICENSE. Made by FastOCR.