# Handwriting OCR MCP Server

Model Context Protocol (MCP) Server for Handwriting OCR .

[What is an MCP Server?](https://www.anthropic.com/news/model-context-protocol)

## Characteristics
Attribute|Details|
|-|-|
**Image Source**|Official Image
**Docker Image**|[mcp/handwriting-ocr](https://hub.docker.com/repository/docker/mcp/handwriting-ocr)
**Author**|[Handwriting-OCR](https://github.com/Handwriting-OCR)
**Repository**|https://github.com/Handwriting-OCR/handwriting-ocr-mcp-server
**Dockerfile**|https://github.com/Handwriting-OCR/handwriting-ocr-mcp-server/blob/main/Dockerfile
**Docker Image built by**|Docker Inc.
**Docker Scout Health Score**| ![Docker Scout Health Score](https://api.scout.docker.com/v1/policy/insights/org-image-score/badge/mcp/handwriting-ocr)
**Verify Signature**|`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/handwriting-ocr --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub`
**Licence**|

## Available Tools
Tools provided by this Server|Short Description
-|-
`check_status`|Check the status of a document|
`get_text`|Retrieve the transcribed text from a document|
`upload_document`|Upload a document to Handwriting OCR API for transcription|

---
## Tools Details

#### Tool: **`check_status`**
Check the status of a document
Parameters|Type|Description
-|-|-
`id`|`string`|Document ID

---
#### Tool: **`get_text`**
Retrieve the transcribed text from a document
Parameters|Type|Description
-|-|-
`id`|`string`|Document ID

---
#### Tool: **`upload_document`**
Upload a document to Handwriting OCR API for transcription
Parameters|Type|Description
-|-|-
`file`|`string`|Path to the document (PDF, JPG, PNG, etc.)
`delete_after`|`integer` *optional*|Seconds until auto-deletion (optional)
`extractor_id`|`string` *optional*|Extractor ID (required if action is extractor, will be ignored)
`prompt_id`|`string` *optional*|Prompt ID (requires Enterprise subscription, will be ignored)

---
## Use this MCP Server

```json
{
  "mcpServers": {
    "handwriting-ocr": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "API_TOKEN",
        "mcp/handwriting-ocr"
      ],
      "env": {
        "API_TOKEN": "your-api-token"
      }
    }
  }
}
```

[Why is it safer to run MCP Servers with Docker?](https://www.docker.com/blog/the-model-context-protocol-simplifying-building-ai-apps-with-anthropic-claude-desktop-and-docker/)
