English Français العربية

Mervext

Registre officiel Finance et paiements

Extract invoices, receipts and contracts into structured JSON. EU-hosted, per-field confidence.

Code source Site web Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http mervext 'https://mcp.vstudiodigital.com/mcp'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mervext": {
            "type": "http",
            "url": "https://mcp.vstudiodigital.com/mcp"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. mervext-mcp
  2. Hosted endpoint (live)
  3. Tools
  4. Auth
  5. Run locally
  6. Deploy (Cloudflare Workers)
  7. Smoke tests
  8. Status
  9. License

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.

Tools

ToolWhat it does
extract_documentOne document (PDF / photo / text) → structured JSON with per-field confidence. Built-in schema id or your own schema_json.
classify_documentDetect document type without extracting fields.
list_schemasThe built-in schemas (id + what each extracts).
check_balancePlan, remaining credits, usage.
delete_documentExplicit 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

# stdio (local clients)
MERVEKT_API_KEY=fw_live_… node dist/stdio.js

# HTTP (local / testing)
node dist/http.js            # :8787 — POST /mcp, GET /healthz

Engine base URL override: MERVEKT_API_URL (default https://api.vstudiodigital.com).

Deploy (Cloudflare Workers)

npx wrangler deploy
  • 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

# stdio, against the live engine (1–2 credits)
node scripts/mcp-smoke.ts [--image path.jpg] [--schema invoice]

# hosted worker, real Streamable-HTTP client
MERVEKT_API_KEY=… node scripts/mcp-http-smoke.ts [https://…/mcp]

Status

  • [x] v0 — five tools, stateless HTTP + stdio, tested against the live engine
  • [x] Hosted on Cloudflare Workers — live at mcp.vstudiodigital.com, verified end-to-end through the hosted stack: text invoice 2.1 s (confidence 1.0, source-grounded); scanned receipt without a text layer (vision path) 7.6 s; clean 422 naming valid schemas for raw images.
  • [x] Official MCP registry: com.vstudiodigital/mervext (DNS-verified publisher)
  • [x] Static server card at /.well-known/mcp/server-card.json (metadata for registries/scanning)
  • [x] Smithery: contact-3yen/mervext — published
  • [ ] mcp.so / Glama (public-repo listings)

License

MIT — see LICENSE.

Not in the Mervext product repo on purpose — that repo runs its own deploy pipeline.

Questions fréquentes

Qu'est-ce que Mervext ?

Extract invoices, receipts and contracts into structured JSON. EU-hosted, per-field confidence.

Comment installer Mervext ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http mervext 'https://mcp.vstudiodigital.com/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Mervext ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Mervext est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Mervext ?

Il est publié par vstudiodigital. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.