Skip to content
MCP server

MDisBetter file converter

MCP server that converts one local file per call using mdisbetter.com and an API key

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.1.0
Listing updated
3 days ago

About MDisBetter file converter

MDisBetter file converter is a freemium MCP server for design and media. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a 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

Add to claude_desktop_config.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>"
      }
    }
  }
}

Add to ~/.cursor/mcp.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>"
      }
    }
  }
}

Add to .vscode/mcp.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>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.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>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "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>"
      }
    }
  }
}

Configuration

  • MDISBETTER_API_KEYYour mdisbetter.com API key (starts with mdb_sk_), created in the dashboard under API keys.Required

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

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

What it does

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

Pricing

Freemium

Free tier; credit packs from $3; API key required

Prices change. Check mdisbetter.com before you buy.

MDisBetter file converter 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 to MDisBetter file converter

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  4. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  5. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media