# io.usefulapi/mindee (remote · mindee.usefulapi.io)

Turn PDFs and images into typed fields — invoices, receipts, IDs and custom models — via Mindee OCR.

- Trust score: 28/100 (low)
- Change this week: −40
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `mindee.usefulapi.io`: 28/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-mindee/mindee.md), [page](https://verifymcp.io/servers/io-usefulapi-mindee/mindee)

## Channel facts

- Endpoint: `https://mindee.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, 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-08-03.

- **Endpoint Security**: 46/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the tool list to see what that exposes.
  - HTTPS not yet verified: we couldn't determine whether a plaintext access path exists.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**Unverified: 4 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add --transport http io-usefulapi-mindee https://mindee.usefulapi.io/mcp
```

### Codex

```toml
[mcp_servers.io-usefulapi-mindee]
url = "https://mindee.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-mindee": {
      "type": "remote",
      "url": "https://mindee.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-mindee --url https://mindee.usefulapi.io/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-mindee:
    url: "https://mindee.usefulapi.io/mcp"
```

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-mindee": {
      "type": "http",
      "url": "https://mindee.usefulapi.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## 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-08-03 (score 28, −44)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Stability: 0.20 → unverified
- [security regression] Authorization: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Capabilities: fail → unverified

### 2026-08-02 (score 72, +54)

- [security improvement] Authorization: unverified → pass
- [security improvement] Transport: fail → pass
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Endpoint reachability: not serving MCP → reachable
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Stability: unverified → 0.20

### 2026-08-01 (score 18, −53)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Stability: 0.13 → unverified
- [security regression] Authorization: pass → unverified
- [security regression] Transport: pass → fail
- [functional regression] Capabilities: fail → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-07-31 (score 71, +3)

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

### 2026-07-30 (score 68, −2)

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

### 2026-07-29 (score 70, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 69, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-07-27 (score 68, +56)

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

## MCP tools (4)

### `mindee_list_models` (~88 tokens)

List extraction models

List the document-extraction models available to your Mindee account (id, name, type). Use a model's `id` as the model_id for mindee_extract_document. V2 API: GET /v2/search/models.

Input parameters:

- `model_type` (string): Optional model type filter.
- `name` (string): Optional case-insensitive name filter, e.g. 'invoice'.

### `mindee_get_job` (~95 tokens)

Get job status

Check the processing status of an enqueued document by job id. Status is Waiting | Processing | Processed | Failed. When Processed, the response carries a result_url; pass that inference id to mindee_get_inference. V2 API: GET /v2/jobs/{job_id}.

Input parameters:

- `job_id` (string, required): Job id returned by mindee_extract_document (when it times out) or an enqueue call.

### `mindee_get_inference` (~105 tokens)

Get extraction result

Fetch the structured result of a completed inference by id, returned as a compact map of extracted fields (plus raw_text if it was requested). V2 API: GET /v2/inferences/{inference_id}.

Input parameters:

- `inference_id` (string, required): Inference id (from a Processed job's result_url, or from mindee_extract_document).
- `raw` (boolean): Return the full unshaped API response instead of the compact fields map. Default false.

### `mindee_extract_document` (~308 tokens)

Extract data from a document

Submit a document (PDF or image) to a Mindee extraction model and return the structured fields. Provide EITHER document_url (a public URL) OR file_base64 (+ filename). This enqueues an inference and polls until it completes (up to ~30s); if it is still processing it returns a job_id you can poll with mindee_get_job then read with mindee_get_inference. NOTE: consumes Mindee API credits (paid, billed per page). V2 API: POST /v2/inferences/enqueue.

Input parameters:

- `alias` (string): Your own reference tag echoed back in the job/result.
- `confidence` (boolean): Return per-field confidence levels (Certain/High/Medium/Low).
- `document_url` (string): Public URL of the document to process. Use this OR file_base64.
- `file_base64` (string): Base64-encoded document bytes. Use this OR document_url; set `filename` too.
- `filename` (string): Filename for file_base64 uploads, e.g. 'invoice.pdf'.
- `model_id` (string, required): Extraction model id (from mindee_list_models).
- `polygon` (boolean): Return bounding-box polygons for fields.
- `rag` (boolean): Enable Retrieval-Augmented Generation for the model, if configured.
- `raw_text` (boolean): Also return the full OCR raw text of the document.
- `webhook_ids` (array): Webhook ids to notify on completion (async flows).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-mindee/mindee#diagnostics

## Score history

- 2026-08-03: 28
- 2026-08-02: 72
- 2026-08-01: 18
- 2026-07-31: 71
- 2026-07-30: 68
- 2026-07-29: 70
- 2026-07-28: 69
- 2026-07-27: 68
- 2026-07-26: 12

## Links

- Remote endpoint: https://mindee.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-mindee/mindee/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-mindee/mindee/changelog.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-mindee/mindee