# EnConvert MCP server

> EnConvert enables AI agents to perceive web pages, search the live web, extract structured data, and convert various file formats into RAG-ready content.

- Repository: https://github.com/enconvert/mcp
- Page: https://hostedmcp.org/servers/enconvert/mcp
- Transport: stdio
- Stars: 7
- License: MIT
- Latest version: 0.5.1

## Install

### Claude Code

```sh
claude mcp add mcp -- npx -y @enconvert/mcp
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@enconvert/mcp"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@enconvert/mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@enconvert/mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@enconvert/mcp"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add mcp -- npx -y @enconvert/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "npx"
args = ["-y", "@enconvert/mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user mcp npx -- -y @enconvert/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@enconvert/mcp"
      ]
    }
  }
}
```

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `ENCONVERT_API_KEY` | no | no |  |
| `ENCONVERT_TOOLSETS` | no | no |  |

## FAQ

### How can I tell if a web page was blocked or failed to render?

The server returns a render_quality score and named deductions like anti_bot_challenge or login_wall. A blocked page returns HTTP 200 with is_blocked: true and empty outputs.

### What file formats can be converted to PDF?

You can convert DOC(X), XLS(X), PPT(X), ODT, ODS, ODP, OTS, Pages, Numbers, EPUB, HTML, MD, CSV, JSON, XML, and YAML to PDF.

### Does the image compression tool change the file format?

No, the compression tool maintains the original format, such as PNG, JPEG, or WebP, and ensures the result is not larger than the input.
