@enconvert/mcp

Web and file reading for AI agents with a 0-1 render_quality score on every read. EnConvert perceives pages, discovers URLs, searches the live web, extracts structured data, ingests RAG-ready chunks and watches for changes, all through one API key, and every web read comes back scored with named deductions so a blocked, challenge or empty-SPA page is flagged instead of mistaken for content.

Official Model Context Protocol (MCP) server for EnConvert. It lets any MCP-compatible AI agent (Claude Code, Cursor, Windsurf, Claude Desktop, Continue, etc.) read the web and convert files through a single command.

Listed on: Official MCP Registry · Glama · LobeHub · npm

What you get

Twenty-four tools, optimized for reliable LLM tool selection. All URL/browser work goes through the V2 tools (perceive_url and friends); the V1 tools cover local/remote FILE conversion. All 24 are registered by default; see Toolsets to register only the web or only the file tools.

Every web read is scored

perceive_url (and everything built on it) returns render_quality (0.0-1.0) with named deductions such as anti_bot_challenge, http_error or login_wall, plus the source status_code. The contract your agent can rely on:

• A detected content-free block is HTTP 200 with is_blocked: true, empty outputs and billed: false. The tool text says Blocked: yes (not billed). There is nothing to read; do not retry the same URL expecting a different answer.
• Reads whose deductions include http_error or login_wall are also not billed (billed: false, text Not billed.). Cache hits are billed.
• Treat render_quality below 0.40 as not-content: surface the score and deductions instead of the markdown.
• A 429 comes back as plain text: Rate limited; retry after N seconds, from the gateway's Retry-After header.

File conversion (6)

Compression and sizing

compress_image never changes the format: a PNG comes back as a PNG, a JPEG as a JPEG, a WebP as a WebP, and the result is never larger than the input. It goes lossless first (metadata stripped, ICC profile and EXIF orientation preserved), then downscales with the aspect ratio locked if target_size_kb is still out of reach. An unreachable target_size_kb is not an error: you get back the smallest file achieved, so check file_size on the result. Animated APNG and animated WebP are rejected.

width and height on convert_image apply to SVG input only (svg to png, jpeg or webp; SVG to HEIC does not take them), 1 to 10000 each. Pass one alone and the other dimension is derived from the SVG's own aspect ratio. Pass both to set the exact canvas, which may change the aspect ratio. Omit both and the SVG's intrinsic size is kept.

V2: web data for agents (18, private API key required, plan-gated)

Not exposed by design: the webhook signing-secret endpoints (GET/POST /v2/ingest/webhook-secret*), because secrets do not belong in LLM context. Fetch those from the EnConvert dashboard.

Prompts (7)

Invokable workflows, surfaced as /mcp__enconvert__<name> in Claude Code. Each encodes ordering and cost rules the individual tools cannot enforce on their own.

Resources (4)

Read-only context addressed by URI. No resource read triggers a browser render, so attaching them costs no quota.

Requirements

• Node.js ^20.20.0 || >=22.22.0 (matches the package's engines field)
• An EnConvert API key. Get one at enconvert.com/dashboard/api-keys

Install in one command

npx @enconvert/mcp setup

That's it. The wizard:

1. Detects your AI tools (Claude Code, Claude Desktop, Cursor, Windsurf, VS Code, Zed, Gemini CLI, Codex CLI, OpenCode) and lets you pick which get EnConvert. Detected tools are preselected.
2. Asks for your secret API key once (hidden input) and validates it live against the API. It even tells you if you pasted a public key by mistake.
3. Writes every config correctly, including the cmd /c npx wrapper Windows needs. Your key is stored once in ~/.enconvert/config.json (permissions 600), never copied into client configs.

$ npx @enconvert/mcp setup

  EnConvert MCP - setup

? Which AI tools should get EnConvert?
  [x] Claude Code (detected)    [x] Cursor (detected)
  [ ] Claude Desktop            [ ] Windsurf   ...
? Paste your SECRET API key (sk_live_..., input hidden): ********
  ✔ API key is valid.
  + Claude Code - claude CLI (user scope)
  + Cursor - ~/.cursor/mcp.json

  Done. Restart your AI tools to pick up the server.

Restart your AI tools afterwards, and you're running.

Manage it just as easily

Scripting? setup --clients claude-code,cursor --api-key sk_live_... --yes skips all prompts. rotate-key with no argument prompts with hidden input so the key never lands in your shell history.

Where the key lives

setup stores your key once in ~/.enconvert/config.json (mode 600) instead of pasting it into every client's plaintext config. The server reads it at startup; the ENCONVERT_API_KEY environment variable always overrides it (for Docker, CI, or manual setups). Rotating is therefore a single-file change, and every client picks it up on its next launch.

Advanced: manual configuration

Prefer to wire it yourself? Add this to your client's MCP config (~/.cursor/mcp.json, ~/.codeium/windsurf/mcp_config.json, etc.):