TextIn OCR MCP

What is TextIn OCR MCP about?

Provides three core tools for document handling: recognition_text for raw text extraction, doc_to_markdown for converting documents to Markdown, and general_information_extration for extracting specified key‑value pairs or table data from PDFs, Word/Excel files, and common image formats.

How to use TextIn OCR MCP?

1. Register on the TextIn website to obtain APP_ID and APP_SECRET.
2. Deploy the MCP server via npx using the configuration below.
3. Call the desired tool through the MCP protocol, supplying a path (local file path or public URL) and optional parameters (key, table_header).

Key Features of TextIn OCR MCP

• recognition_text: Returns plain text from images, PDFs, and Word documents.
• doc_to_markdown: Generates Markdown representation of PDFs, Word/Excel files, and images.
• general_information_extration: Outputs a JSON object containing user‑specified textual keys and table headers.
• Supports common file types: JPEG, JPG, PNG, BMP, PDF, DOCX, XLSX.
• Works with public URLs; protected resources are not supported.
• Configurable timeout via MCP_SERVER_REQUEST_TIMEOUT.

Use Cases of TextIn OCR MCP

• Automating data entry by extracting invoice details into structured JSON.
• Converting legacy documents into searchable Markdown for knowledge bases.
• Pulling ID or passport information for verification workflows.
• Bulk processing of scanned contracts to retrieve clauses or dates.
• Integrating OCR capabilities into custom AI agents or chatbots.

FAQ

Q: What file formats are supported? A: JPEG, JPG, PNG, BMP, PDF, Word (DOCX), and Excel (XLSX).

Q: Can I process files behind authentication? A: No. The server only accepts publicly accessible URLs or local file paths.

Q: How do I set the request timeout? A: Define MCP_SERVER_REQUEST_TIMEOUT (in milliseconds) in the environment variables; the default in the example is 600000 (10 minutes).

Q: Do I need to install any additional dependencies? A: The server runs via npx and pulls the required package @intsig/server-textin automatically.

Q: Where can I find the license? A: The project is released under the MIT License; see the LICENSE file in the repository.

TextIn OCR MCP

English | 中文

TextIn OCR MCP Server

TextIn MCP Server is a tool for extracting text and performing OCR on documents, including document text recognition, ID recognition, and invoice recognition. It also supports converting documents into Markdown format.

Tools

• recognition_text

  • Text recognition from images, Word documents, and PDF files.
  • Inputs:
    • path (string, required): file path or a URL (HTTP/HTTPS) pointing to a document
  • Return: Text of the document.
  • Supports conversion for:
    • PDF
    • Image (Jpeg, Jpg, Png, Bmp)

• doc_to_markdown

  • Convert images, PDFs, and Word documents to Markdown.
  • Inputs:
    • path (string, required): file path or a URL (HTTP/HTTPS) pointing to a document
  • Return: Markdown of the document.
  • Supports conversion for:
    • PDF
    • Microsoft Office Documents (Word, Excel)
    • Image (Jpeg, Jpg, Png, Bmp)

• general_information_extration

  • Automatically identify and extract information from documents, or identify and extract user-specified information.
  • Inputs:
    • path (string, required): file path or a URL (HTTP/HTTPS) pointing to a document
    • key (string[], optional): The non-tabular text information that the user wants to identify, input format is an array of strings.
    • table_header (string[], optional): The table information that the user wants to identify, input format is an array of strings.
  • Return: The key information JSON.
  • Supports conversion for:
    • PDF
    • Microsoft Office Documents (Word, Excel)
    • Image (Jpeg, Jpg, Png, Bmp)

When the input is a URL, it does not support handling access to protected resources.

Setup

APP_ID and APP_SECRET

Click here to register for a TextIn account.

Get Textin APP_ID and APP_SECRET by following the instructions here.

NPX

{
  "mcpServers": {
    "textin-ocr": {
      "command": "npx",
      "args": [
        "-y",
        "@intsig/server-textin"
      ],
      "env": {
        "APP_ID": "<YOUR_APP_ID>",
        "APP_SECRET": "<YOUR_APP_SECRET>",
        "MCP_SERVER_REQUEST_TIMEOUT": "600000"
      },
      "timeout": 600
    }
  }
}

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.