# cheap.doc/mcp (npm · @doc-cheap/mcp)

Passport, ID and MRZ recognition via doc.cheap – Free: 100 documents every month, then $0.01 each

- Trust score: 87/100 (high trust)
- Change this week: +23
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-28

## Components

- remote · `mcp.doc.cheap`: 80/100, [markdown](https://verifymcp.io/servers/cheap-doc-mcp/mcp.md), [page](https://verifymcp.io/servers/cheap-doc-mcp/mcp)
- mcpb · `doc-cheap-0.3.7.mcpb`: 49/100, [markdown](https://verifymcp.io/servers/cheap-doc-mcp/https-gitlab-com-doccheap-ocr-mcp-releases-v0-3-7-downloads-doc-cheap-0-3-7-mcpb.md), [page](https://verifymcp.io/servers/cheap-doc-mcp/https-gitlab-com-doccheap-ocr-mcp-releases-v0-3-7-downloads-doc-cheap-0-3-7-mcpb)
- npm · `@doc-cheap/mcp`: 87/100 (this document), [markdown](https://verifymcp.io/servers/cheap-doc-mcp/doc-cheap-mcp.md), [page](https://verifymcp.io/servers/cheap-doc-mcp/doc-cheap-mcp)

## Channel facts

- Registry: `npm`
- Package: `@doc-cheap/mcp`
- Version: `0.3.7`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-28.

- **Supply Chain Security**: 99/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 31 of 112 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to doccheap/ocr-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 2 days ago).
  - Security-disclosure policy not yet verified: we couldn't inspect the source repository.
- **Schema Quality & AI Usability**: 90/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 3225 tokens (~47/item across 68 items; 3 tools + 65 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 23/100
  - Stability observed for 7 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 3 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 5 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the cheap.doc/mcp server?

cheap.doc/mcp runs locally as an npm package, launched with npx -y @doc-cheap/mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add cheap-doc-mcp -- npx -y @doc-cheap/mcp
```

### Cursor

```json
{
  "mcpServers": {
    "cheap-doc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@doc-cheap/mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "cheap-doc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@doc-cheap/mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add cheap-doc-mcp -- npx -y @doc-cheap/mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cheap-doc-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@doc-cheap/mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add cheap-doc-mcp --command npx --arg -y --arg @doc-cheap/mcp
```

### Hermes

```yaml
mcp_servers:
  cheap-doc-mcp:
    command: "npx"
    args: ["-y", "@doc-cheap/mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "cheap-doc-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@doc-cheap/mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add cheap-doc-mcp -t stdio -c npx -a -y @doc-cheap/mcp
```

### Other

```json
{
  "mcpServers": {
    "cheap-doc-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@doc-cheap/mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-28 (score 87, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-09-26 (score 86, +1)

- [functional] Package version: 0.3.5 → 0.3.7

### 2026-09-25 (score 85, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-09-24 (score 84, +26)

- [security regression] Stability: 0.07 → unverified
- [security regression] Tool safety: pass → unverified
- [security improvement] Known CVEs: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [functional regression] Schema quality: 100 → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Capabilities: pass → unverified
- [functional improvement] Dependency health: unverified → 0.88
- [functional] Package version: 0.3.3 → 0.3.5

### 2026-09-23 (score 58, −6)

- [security regression] Malware scan: pass → unverified
- [security regression] Known CVEs: pass → unverified
- [security regression] Tool safety: pass → unverified
- [security regression] Tool safety: pass → unverified
- [security regression] Known CVEs: pass → partial
- [security improvement] Provenance: fail → pass
- [security improvement] Source repository: fail → pass
- [security] Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet.
- [security] Stability: Stability not yet verified: this package could not be installed in a clean environment, so we have no schema to compare.
- [security] The attested source repository moved: doccheap/ocr-mcp
- [functional regression] Dependency health: 0.88 → unverified
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Capabilities: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional improvement] Stability: unverified → 0.07
- [functional improvement] Schema quality: fail → pass
- [functional] First check of Schema quality: 100
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: unverified
- [functional] First check of Schema quality: unverified
- [functional] Dependency health: 0.88 → partial
- [functional] Package version: 0.1.0 → 0.3.3
- [functional] Package version: 0.1.0 → 0.3.2
- [functional] Package version: 0.1.0 → 0.3.1
- [functional] Package version: 0.1.0 → 0.3.0
- [functional] Package version: 0.1.0 → 0.2.0
- [functional] Package version: 0.1.0 → 0.1.2
- [functional] Package version: 0.1.0 → 0.1.1

### 2026-09-21 (score 64)

First indexed and scored.

## MCP tools (3)

### `scan_document` (~576 tokens)

Recognise a passport or ID document

Recognise a passport, national ID card or driver's licence from a photo or scan and return what is printed on it as structured JSON. Inputs: the image as image_base64 (always available), image_path (a local file, and only inside the directory DOC_CHEAP_IMAGE_ROOT names) or image_url (https, on a public address); plus the optional expect_country, return_portrait, retain_hours, reference and idempotency_key. Output: a Scan object – meta (id, status, billed, confidence, timing), document (kind, issuing country, number, series, date of issue, date of expiry, whether it has expired and how many days are left), holder (given names, surname, date of birth, sex, nationality), fields (every field read off the printed page, each with its own confidence), mrz (whether the machine-readable zone checks out, why not when it does not, and its lines exactly as read), images, quality and authenticity – plus a one-line summary of the same result. Calls POST /v1/scans. Cost: it bills one credit ($0.01) only when a document is recognised; an unreadable image, an empty frame or an unsupported type costs nothing, and meta.billed says which happened. Without a key, the public sandbox key is used. It gives 10 free recognised documents per address in all, and at most 10 requests per address an hour, whatever their answer. Registering gives 100 free documents every month. Use it whenever someone hands over an identity document and wants it read, transcribed, or checked against what they claim – a name, a document number, a date of birth or an expiry date.

Input parameters:

- `expect_country` (string): ISO 3166-1 alpha-3 country you expect, or omit for any.
- `idempotency_key` (string): Makes a retried scan return the first result instead of charging again.
- `image_base64` (string): The document image as base64 (a data: URL is also accepted).
- `image_path` (string): Path to a local image file, inside the directory named by DOC_CHEAP_IMAGE_ROOT. Disabled unless that variable is set; send image_base64 instead.
- `image_url` (string): https: URL of an image on a public internet address, which the server fetches (25 MB maximum).
- `reference` (string): Your own correlation string, echoed back in the result.
- `retain_hours` (integer): Hours the result stays readable via GET /v1/scans/{id} (0 = store nothing). Omit it to use the account's own history-retention setting.
- `return_portrait` (boolean): Whether to include the holder photograph crop, images.main_photo (default true).

Output parameters:

- `authenticity`
- `document`
- `fields` (array): Every field the engine extracted off the printed document, re-keyed to our vocabulary – the open set. Always present; empty when nothing was extracted. A field read in more than one language appears…
- `holder`
- `images`
- `meta`
- `mrz`
- `quality`

### `check_balance` (~175 tokens)

Check remaining credits

Return how many credits are left on the account and what the current period has used: the balance, split into this month's free credits (100 every month, drawn first) and the paid credits, the credits spent, and the scan counters broken down by status (recognized, unreadable, no document found, unsupported document, rejected). Takes no arguments and calls GET /v1/usage; under the public sandbox key it answers without calling anything. One recognised document draws one credit, at $0.01; scans that recognised nothing are counted and never charged. Needs a real API key – under the public sandbox key there is no account behind the call, and the answer says so instead of reporting zeros that read like a balance. Use it before working through a batch of documents, or when a scan is refused for lack of credit.

Output parameters:

- `balance_credits`: Credits currently available to the account: this month's free credits plus the paid credits; null for a key with no account (the public sandbox key).
- `credits_spent` (integer): Credits charged within the period.
- `credits_spent_by_kind` (object): Credits charged within the period, by the kind that paid.
- `free_allowance`: This month's free credits, drawn before paid credits; null when the account may not draw free credits (its email address is not confirmed, or its free credits were withdrawn) and for a key with no ac…
- `paid_balance_credits`: Paid credits: bought or granted to the account, drawn once this month's free credits are used up, and never reset; null only for a key with no account (the public sandbox key).
- `period` (object): Bounds of the current usage period (UTC calendar month).
- `scans` (object)

### `search_docs` (~164 tokens)

Search the doc.cheap API documentation

Full-text search over the doc.cheap API documentation – endpoints, request options, every response field, the error codes and what to do about each, MRZ rules, retention and pricing. Takes a query and an optional limit (1 to 20, default 5), and answers with the matching sections: title, a snippet, and a link to the page. It reads a copy of the documentation shipped beside this server, so it makes no network call and works offline. Use it before guessing at a field name, an error code or a scan option – what it returns is the published contract rather than a recollection of it.

Input parameters:

- `limit` (integer): Maximum number of results (default 5).
- `query` (string, required): What to search the documentation for.

Output parameters:

- `results` (array): Matching sections, best first; empty when nothing matched.

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/cheap-doc-mcp/doc-cheap-mcp#diagnostics

## Score history

- 2026-09-28: 87
- 2026-09-27: 86
- 2026-09-26: 86
- 2026-09-25: 85
- 2026-09-24: 84
- 2026-09-23: 58
- 2026-09-22: 64
- 2026-09-21: 64

## Common questions

### What is the cheap.doc/mcp server?

cheap.doc/mcp is listed in the public MCP registry as cheap.doc/mcp. Passport, ID and MRZ recognition via doc.cheap – Free: 100 documents every month, then $0.01 each. This page covers its npm package (@doc-cheap/mcp).

### Is the cheap.doc/mcp server safe to use?

cheap.doc/mcp scores 87 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 28 September 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the cheap.doc/mcp server expose?

cheap.doc/mcp exposes 3 tools: scan_document, check_balance, search_docs. Their descriptions and schemas cost roughly 915 tokens of context every time the server is loaded.

### Is the cheap.doc/mcp server still maintained?

cheap.doc/mcp is still listed as active in the MCP registry. We last reached this channel on 28 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the cheap.doc/mcp server under?

cheap.doc/mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- npm package: https://www.npmjs.com/package/@doc-cheap/mcp
- Socket report: https://socket.dev/npm/package/@doc-cheap/mcp
- Repository: https://gitlab.com/doccheap/ocr-mcp
- Website: https://doc.cheap/docs/guides/use-the-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/cheap-doc-mcp/doc-cheap-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/cheap-doc-mcp/doc-cheap-mcp.json
- HTML version of this page: https://verifymcp.io/servers/cheap-doc-mcp/doc-cheap-mcp