# Mervext

Turns invoices, receipts and contracts into structured JSON with a confidence score per field. Useful when an agent has to read a PDF or a photo of a document.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: VStudioDigital
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/VStudioDigital/mervext-mcp
- Updated: 2026-10-09
- HTML: https://affpapa.org/en/nevibecode/mcp/mervext

## What it does

Mervext is a thin wrapper around a deployed engine at `https://api.vstudiodigital.com`. The server keeps no state and stores no secrets. It ships five tools: `extract_document` reads one document (PDF, photo or text) into JSON with per-field confidence, `classify_document` names the document type without pulling fields, `list_schemas` lists the built-in schemas, `check_balance` reports plan and remaining credits, and `delete_document` removes a document by id.

The API key travels with each request from the client, so the worker never holds it. Over HTTP that means an `X-API-Key: fw_…` or `Authorization: Bearer fw_…` header; over stdio it is the `MERVEKT_API_KEY` variable. Keys with free trial credits come from `https://mervext.com`, or you can mint a device key with `POST /v1/keys/device`. No key, no output.

It runs on Cloudflare Workers at `https://mcp.vstudiodigital.com/mcp` over Streamable HTTP. For a local build, run `npm install` then `npm run build`, and start either `node dist/stdio.js` or `node dist/http.js` on port 8787. Point `MERVEKT_API_URL` elsewhere to override the engine base URL. MIT licensed.

## Requirements
- Remote server: `https://mcp.vstudiodigital.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http mervext https://mcp.vstudiodigital.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add mervext --url https://mcp.vstudiodigital.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mervext": {
            "url": "https://mcp.vstudiodigital.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mervext": {
            "type": "http",
            "url": "https://mcp.vstudiodigital.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http mervext https://mcp.vstudiodigital.com/mcp
```

## When to use it
- pull invoice fields out of a PDF
- read a scanned receipt that has no text layer
- identify a document type before extracting anything
- check remaining credits and the current plan
- delete a document by id with zero retention

## Example prompts
- Extract `invoice.pdf` using the invoice schema and show per-field confidence
- Classify the document in `scan.jpg`, don't extract fields yet
- List the built-in schemas and my remaining credits

## Similar
- [Foxit PDF API MCP Server](https://affpapa.org/en/nevibecode/mcp/foxit-pdf-api-mcp-server.md) — MCP server · ★ 12
- [Document to JSON – PDF Invoice/Statement/Contract Parser](https://affpapa.org/en/nevibecode/mcp/document-to-json-pdf-invoicestatementcontract-parser.md) — MCP server · ★ 8
- [hwp](https://affpapa.org/en/nevibecode/skills/hwp.md) — skill · 8500 installs
- [mistral-mcp](https://affpapa.org/en/nevibecode/mcp/mistral-mcp.md) — MCP server · ★ 15
- [cli-anything-libreoffice](https://affpapa.org/en/nevibecode/skills/cli-anything-libreoffice.md) — skill · 677 installs
- [Paperless-ngx](https://affpapa.org/en/nevibecode/mcp/paperless-ngx.md) — MCP server · ★ 11

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md