FastOCR MCP server
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| FASTOCR_API_KEY | Yes | Required. Your FastOCR API key. | |
| FASTOCR_BASE_URL | No | Optional. Overrides https://api.fastocr.org. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| ocr_fileA | OCR a local PDF or image with FastOCR and return its text or save a searchable PDF. Uploads the file, runs OCR and waits up to 45 seconds. With output='text' the text is returned; text longer than 20,000 characters is cut, and the full text is written to output_path or to .ocr.txt next to the input file. With output='pdf' the searchable PDF is saved to output_path or to .searchable.pdf next to the input file. Either default file replaces an earlier result with the same name. Each processed page uses one page of the account's balance; an image is one page. Large documents take longer: then this returns a document id, and get_document with the same output fetches the result. Never call ocr_file again for that file, which bills it again. |
| ocr_pdfB | The same tool as ocr_file, kept under its earlier name. Prefer ocr_file. |
| get_documentA | Get a FastOCR document's status, and optionally its text or searchable PDF. Statuses: awaiting_upload, processing, completed, partial (the account ran out of pages partway), failed. With output='text' or 'pdf' this waits up to 45 seconds; if the document is still processing, call it again. Fetching a result again costs no pages. Without output_path, long text and PDFs are saved in the system temp directory. |
| list_documentsA | List the most recent documents in the FastOCR account with their status and page counts. |
| get_balanceA | Get how many pages the FastOCR account can still process. Costs no pages. Documents spend free pages first (they reset monthly), then contract pages, then Page Packs. pages_remaining counts the Page Packs only, so add the free and contract pages for the total. contract_* are omitted without an API contract. statement_pages_remaining is a separate balance that OCR does not spend. Check this before OCRing a large PDF; buy_pages_url is where to add pages. |
| delete_documentA | Permanently delete a FastOCR document and its stored files (original, text, searchable PDF). A document that is still processing cannot be deleted. Local files are not touched. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
The five distinct operations (OCR, list, get, balance, delete) are clearly separable by resource and action. The only overlap is ocr_pdf, which is explicitly documented as a legacy alias of ocr_file with a 'prefer ocr_file' instruction, but its presence still creates a real risk of double-billing if an agent calls both.
All six names use a uniform snake_case verb_noun pattern (ocr_file, list_documents, get_document, get_balance, delete_document). The single deviation, ocr_pdf, fits the same pattern and is deliberately framed as a legacy alias of ocr_file.
Six tools is well-scoped for an OCR service covering submit, list, retrieve, quota, and delete. However, one of the six is a redundant alias rather than a unique capability, so effectively five tools carry the surface.
The lifecycle is covered end-to-end: OCR a file, check status/results, list recent documents, check remaining page balance, and delete documents. Minor gaps remain, such as no multi-file/batch submission and no pagination or filtering options for list_documents.