# MDisBetter file converter

> MDisBetter file converter is a freemium MCP server for design and media. MCP server that converts one local file per call using mdisbetter.com and an API key. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://mdisbetter.com
- **Repository:** https://github.com/dresseurmonster2-oss/mdisbetter-mcp
- **MCP Registry name:** io.github.dresseurmonster2-oss/mdisbetter-mcp
- **Categories:** design and media, files and documents
- **Listing updated:** 2026-11-14

## About

Reach is the main feature: the server fronts a converter that lists 3,649 proven conversions across 162 input formats in eleven families, including images, documents, ebooks, audio, video, office files, fonts, archives, data formats, subtitles and bibliographies. It is not limited to PDF output.

Only two tools exist. `list_conversions` returns either every accepted input extension or, for a given one such as docx, the output formats proven for it; unreadable extensions are refused rather than answered with an empty list. `convert_file` takes a path and output format and writes the result locally. The README lists limits: no batch mode, URL input, webhooks or streaming, and re-encoded video is capped at 120 seconds of source.

An mdisbetter.com account and API key (starting `mdb_sk_`) are required, and conversions spend credits from the same balance as the website. Node.js 20 or later is needed.

## Features

- **Broad format coverage:** 3,649 conversions across 162 input formats.
- **Format discovery:** list_conversions shows what an extension can become.
- **Local file output:** convert_file writes the converted file to disk.
- **Shared credit balance:** Programmatic use draws from the website's credits.
- **Honest limits:** No batch, URL input or streaming; re-encoded video is capped at 120 s.

## Good for

- Convert a Word file to another format from an agent
- Check which formats a file type supports
- Turn an audio file into another audio format
- Prepare documents before adding them to a project

## Install

### Claude Code (Terminal)

```sh
claude mcp add mdisbetter-mcp --env MDISBETTER_API_KEY='<MDISBETTER_API_KEY>' -- npx -y https://github.com/dresseurmonster2-oss/mdisbetter-mcp/releases/download/v0.1.0/mdisbetter-mcp.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mdisbetter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/dresseurmonster2-oss/mdisbetter-mcp/releases/download/v0.1.0/mdisbetter-mcp.mcpb"
      ],
      "env": {
        "MDISBETTER_API_KEY": "<MDISBETTER_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mdisbetter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/dresseurmonster2-oss/mdisbetter-mcp/releases/download/v0.1.0/mdisbetter-mcp.mcpb"
      ],
      "env": {
        "MDISBETTER_API_KEY": "<MDISBETTER_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "mdisbetter-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/dresseurmonster2-oss/mdisbetter-mcp/releases/download/v0.1.0/mdisbetter-mcp.mcpb"
      ],
      "env": {
        "MDISBETTER_API_KEY": "<MDISBETTER_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mdisbetter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/dresseurmonster2-oss/mdisbetter-mcp/releases/download/v0.1.0/mdisbetter-mcp.mcpb"
      ],
      "env": {
        "MDISBETTER_API_KEY": "<MDISBETTER_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mdisbetter-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/dresseurmonster2-oss/mdisbetter-mcp/releases/download/v0.1.0/mdisbetter-mcp.mcpb"
      ],
      "env": {
        "MDISBETTER_API_KEY": "<MDISBETTER_API_KEY>"
      }
    }
  }
}
```

## Tools

- `convert_file`: Converts a local file to another format
- `list_conversions`: Lists supported input and output formats

## FAQ

### Do I need an account?

Yes, an mdisbetter.com account and an API key are required.

### Can it batch files?

No, it converts one local file per call.

### Does video conversion have limits?

Re-encoded video is capped at 120 seconds of source.

### How is it priced?

Conversions use credits; the website lists a free tier and credit packs from $3.

### Is MDisBetter file converter free?

MDisBetter file converter has a free plan, with paid plans for more usage or features.

### How do I add MDisBetter file converter to Claude Code?

Run this command in your terminal: claude mcp add mdisbetter-mcp --env MDISBETTER_API_KEY='<MDISBETTER_API_KEY>' -- npx -y https://github.com/dresseurmonster2-oss/mdisbetter-mcp/releases/download/v0.1.0/mdisbetter-mcp.mcpb

### What are the best alternatives to MDisBetter file converter?

The closest alternatives to MDisBetter file converter are HyperFrames by HeyGen, ffmpeg-skill, ASTra, AvatarSay — Fictional Character & Talking Video MCP and ChartAnt.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/mdisbetter-file-converter
