mervext-mcp
MCP server for Mervext — documents in, structured JSON out, for AI agents
(Claude, Claude Code, Codex, Cursor, Hermes, Gemini CLI, …).
Thin wrapper over the deployed Mervext engine (https://api.vstudiodigital.com).
Standalone: no changes to the engine repo, no state, no stored secrets.
Hosted endpoint (live)
https://mcp.vstudiodigital.com/mcp — Streamable HTTP, stateless, on
Cloudflare Workers (scale-to-zero). Health: GET /healthz.
Client config (any MCP client that supports HTTP + headers):
{
"mcpServers": {
"mervext": {
"type": "http",
"url": "https://mcp.vstudiodigital.com/mcp",
"headers": { "X-API-Key": "fw_…your key…" }
}
}
}
The API key is supplied per request by the client — the worker stores
nothing, keeps no sessions, and holds no secrets. Get a key with free trial
credits at https://mervext.com, or mint a device key: POST /v1/keys/device.
| Tool | What it does |
|---|
extract_document | One document (PDF / photo / text) → structured JSON with per-field confidence. Built-in schema id or your own schema_json. |
classify_document | Detect document type without extracting fields. |
list_schemas | The built-in schemas (id + what each extracts). |
check_balance | Plan, remaining credits, usage. |
delete_document | Explicit zero-retention delete by document id. |
Auth
The MCP client supplies the Mervext API key; the server never stores it:
- stdio:
MERVEKT_API_KEY=fw_live_…
- HTTP:
X-API-Key: fw_… or Authorization: Bearer fw_… header per request
Run locally
npm install
npm run build
MERVEKT_API_KEY=fw_live_… node dist/stdio.js
node dist/http.js
Engine base URL override: MERVEKT_API_URL (default https://api.vstudiodigital.com).
Deploy (Cloudflare Workers)
wrangler.toml: worker mervext-mcp, route mcp.vstudiodigital.com/* (zone
vstudiodigital.com). workers_dev is off — route only (no workers.dev
subdomain on the account).- Run from WSL — wrangler OAuth lives there (skill:
cloudflare-pages-deploys).
Smoke tests
node scripts/mcp-smoke.ts [--image path.jpg] [--schema invoice]
MERVEKT_API_KEY=… node scripts/mcp-http-smoke.ts [https://…/mcp]
Status
License
MIT — see LICENSE.
Not in the Mervext product repo on purpose — that repo runs its own deploy pipeline.