v1.6.2 — Better filenames + smarter tool description

Two UX fixes for the MCP, no breaking changes:

Filenames. convert_document now accepts a fileName parameter so downloads have meaningful names (no more content-1778298071915.docx). When not provided, the MCP derives a name from the markdown's first H1 heading.

Smarter tool description. Claude was sometimes ambiguous about whether 'pdf' meant a single file or DOCX+PDF in a zip. The tool description now spells out exactly what each format returns, tells Claude to ask before calling if the user is ambiguous, and tells it to call list_all_templates first when hitting 'template not found' errors instead of silently falling back to its built-in code execution.

v1.6.1 — Registry metadata

Metadata-only release. Adds mcpName to package.json and a server.json so this package can be listed on the official MCP registry at registry.modelcontextprotocol.io. No functional changes from v1.6.0.

v1.6.0 — Initial public release

v1.6.0 — Initial public release

Convert Markdown to professional DOCX, PDF, and HTML directly from Claude Desktop, Claude Code, Cursor, OpenClaw, or any MCP-compatible AI assistant.

Install

{
  "mcpServers": {
    "mdmagic": {
      "command": "npx",
      "args": ["-y", "@mdmagic/mcp-server"],
      "env": {
        "MDMAGIC_API_KEY": "mdmagic-xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Get your API key at mdmagic.ai/account.

What's included

Two transports: stdio (default, for local installs) and Streamable HTTP (for self-hosted deployments).

Seven tools:

• convert_document — Markdown → DOCX, PDF, HTML, or all formats. Returns secure expiring download URLs.
• estimate_conversion_cost — pre-flight cost estimation based on word count, page count, and format.
• check_credit_balance — view your subscription + purchased credit pools.
• list_all_templates / list_builtin_templates / list_custom_templates — browse the 18 built-in template families plus any custom templates you've uploaded.
• show_default_settings — your preferred page size, orientation, and template defaults.

Privacy posture:

• No telemetry, no analytics, no phone-home.
• The MCP only calls the same public API the MDMagic web app uses.
• Documents are processed and deleted within seconds — never permanently stored.
• Fully open source, MIT licensed. Audit every line.

Links

• Package: https://www.npmjs.com/package/@mdmagic/mcp-server
• MDMagic: https://mdmagic.ai
• MCP spec: https://modelcontextprotocol.io