How do I install Mdmagic?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Mdmagic need an API key?

The publisher lists these environment variables: MDMAGIC_API_KEY, MDMAGIC_BASE_URL, REQUEST_TIMEOUT, MCP_TRANSPORT, MCP_HTTP_PORT, MCP_HTTP_HOST.

When was Mdmagic last checked?

Last checked 2026-11-09. Use your own Word templates to convert Markdown → DOCX/PDF/HTML from any MCP-compatible AI.

Mdmagic MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://api.mdmagic.ai/mcp

Credentials from the publisher

MDMAGIC_API_KEY — Your personal MDMagic API key (format: mdmagic-XXXXXXXXXXXXXXXX). Get yours at https://mdmagic.ai/account — the 'Connect to AI Assistants via MCP' card on your account page generates the key and pre-fills a copy-pasteable config block.
MDMAGIC_BASE_URL — Override the MDMagic API base URL. Defaults to https://api.mdmagic.ai. Only set this if you're running MDMagic against a local dev backend.
REQUEST_TIMEOUT — Request timeout in milliseconds. Increase for very large documents on slow connections. Default: 30000 (30s).
MCP_TRANSPORT — Transport mode: 'stdio' (default, for local clients like Claude Desktop) or 'http' (for self-hosted Streamable HTTP).
MCP_HTTP_PORT — Port for HTTP transport mode. Default: 3001. Only used when MCP_TRANSPORT=http.
MCP_HTTP_HOST — Bind address for HTTP transport mode. Default: 127.0.0.1. Only used when MCP_TRANSPORT=http.

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http io.github.mdmagic-mcp-mdmagic-mcp-server https://api.mdmagic.ai/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.mdmagic-mcp-mdmagic-mcp-server": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://api.mdmagic.ai/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

MDMagic MCP Server

Convert Markdown to DOCX, PDF, and HTML using your own Word templates — your letterhead, your branding, your fonts. Plus 15 designer-built templates for when you don't have your own.

MDMagic plugs straight into Claude, Cursor, VS Code, and any MCP-compatible AI assistant — giving them direct access to a professional document conversion pipeline (Pandoc + Microsoft Graph + Mammoth.js) and, more importantly, your templates. Upload your existing letterhead, stationery, brand guidelines, contract shells, or proposal templates — anything you already use in Microsoft Word — and your AI assistant can convert any Markdown directly into a polished document carrying your logo, fonts, colours, footers, page numbers, watermarks, and signature blocks. The output looks like it came from your design team, not from a generic AI export.

You: "Take this report and turn it into an Executive_Platinum PDF."

Claude: ✅ Done. Here's your secure download link.
        14-page PDF, 2.3 MB, expires in 60 minutes.

Install

You need an MDMagic account (free tier available) and your API key from your account page.

Claude Desktop

Add this to your claude_desktop_config.json:

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

Config file location:

macOS — ~/Library/Application Support/Claude/claude_desktop_config.json
Windows — %APPDATA%\Claude\claude_desktop_config.json
Linux — ~/.config/Claude/claude_desktop_config.json

Restart Claude Desktop. The MDMagic tools will appear in the tool list.

Cursor

Add to ~/.cursor/mcp.json (or via Settings → MCP):

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

VS Code (with an MCP extension)

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

Hosted (no install)

Don't want Node on the user's machine? Use the hosted endpoint:

{
  "mcpServers": {
    "mdmagic": {
      "url": "https://api.mdmagic.ai/mcp",
      "headers": {
        "x-api-key": "mdmagic-xxxxxxxxxxxxxxxx"
      }
    }
  }
}

Same tools, same templates, served over Streamable HTTP. Useful for clients that don't run local processes.

What you can do

Once connected, ask your AI assistant things like:

"Convert this markdown to a PDF using the Executive_Platinum template."
"What templates do I have available?"
"How many credits will it cost to render this 800-word report as DOCX + PDF?"
"Render this in landscape, US Letter, with the Legal_Burgundy template."
"Check my credit balance."

The AI picks the right tool and returns a secure, time-limited download link.

Tools

Tool	What it does
`convert_document`	Convert Markdown → DOCX / PDF / HTML / all three. Returns a secure expiring URL.
`validate_markdown`	Pre-flight check before conversion. Catches malformed tables, unclosed code fences, and other syntax issues that would produce broken output.
`estimate_conversion_cost`	Pre-flight cost estimate based on word count, page count, format, and template type.
`check_credit_balance`	Current credit balance (subscription + purchased pools), plan status.
`list_all_templates`	Full template catalog: 15 built-in templates (grouped by category) + your custom uploads.
`list_builtin_templates`	Only the built-in templates: Business (5), Creative (6), Professional (2), Technical (2).
`list_custom_templates`	Only your custom uploaded templates.
`get_template_details`	Show available variants (page sizes × orientations) for a specific template.
`recommend_template`	Suggest the best built-in template for a described purpose ("Q4 board pack" → Executive_Platinum).
`show_default_settings`	Your default page size, orientation, and template preferences.

`convert_document` — input options

Three ways to provide the source:

content — raw markdown string (most common)
filePath — absolute path to a .md file (great for IDE workflows)
fileContent — base64-encoded markdown (for binary-safe transports)

Plus:

templateName — e.g. Executive_Platinum, Legal_Burgundy, or a custom template UUID
outputFormat — docx, pdf, html, all, or all-formats
pageSize — A4, A3, US_Letter, US_Legal, Executive
orientation — Portrait or Landscape

Config

Variable	Default	Notes
`MDMAGIC_API_KEY`	(required)	Your personal API key from mdmagic.ai/account
`MDMAGIC_BASE_URL`	`https://api.mdmagic.ai`	Override only for local dev or staging
`REQUEST_TIMEOUT`	`30000`	Request timeout in ms
`MCP_TRANSPORT`	`stdio`	`stdio` (default) or `http` for self-hosted Streamable HTTP
`MCP_HTTP_PORT`	`3001`	Port for HTTP transport mode
`MCP_HTTP_HOST`	`127.0.0.1`	Bind address for HTTP transport mode

Most users will only ever set MDMAGIC_API_KEY.

Pricing

Conversions cost credits, calculated from page count and output format:

DOCX: 1 credit per page (base)
PDF: +1 credit per page
HTML: +1 credit per page
Custom templates: +1 credit per page

A 5-page report converted to DOCX + PDF + HTML using a custom template = 5 × (1 + 1 + 1 + 1) = 20 credits.

The estimate_conversion_cost tool returns exact numbers before you spend anything. The MCP also refuses to run if your balance is too low — no surprise bills.

Free-tier credits renew monthly. Paid plans and credit top-ups available at mdmagic.ai.

Privacy

No permanent storage. Documents pass through Microsoft Graph API for PDF rendering and are deleted within 5–10 seconds. Output files are deleted from MDMagic servers after download or after 60 minutes, whichever comes first.
Random filenames. Source files use UUIDs, never user-identifiable names.
Secure download URLs. Each conversion returns a one-time URL with session ID and download token. No public file directories.
API key isolation. Each user authenticates with their own key. No shared credentials.

Troubleshooting

MDMAGIC_API_KEY environment variable is required Set the env var in your client config (the env block in the JSON). Don't put it in a shell — npx won't see it.

Invalid API key format Keys must match mdmagic- followed by exactly 16 digits. Copy it cleanly from your account page.

Failed to connect to MDMagic API Check https://api.mdmagic.ai/health in a browser. If it's up, the issue is local network or firewall. Confirm MDMAGIC_BASE_URL (default https://api.mdmagic.ai) is reachable from the machine running the MCP.

Tools don't appear in Claude Desktop Fully quit and relaunch Claude Desktop after editing claude_desktop_config.json — a window close isn't enough.

Insufficient credits Use check_credit_balance to confirm balance, estimate_conversion_cost to preview costs, or top up at mdmagic.ai/account.

Local development

git clone https://github.com/MDMagic-MCP/mdmagic-mcp-server.git
cd mdmagic-mcp-server
npm install

# Set your API key (use http://localhost:3000 if running the API locally)
cp .env.example .env
# edit .env

# Build and inspect
npm run build
npm run inspector

The MCP Inspector (npm run inspector) launches a web UI for poking the server tool-by-tool — useful when adding new tools or debugging argument validation.

Run tests with npm test.

License

MIT — see LICENSE.

Mdmagic

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Mdmagic?

Does Mdmagic need an API key?

What transport does Mdmagic use?

When was Mdmagic last checked?

Documentation

MDMagic MCP Server

Install

Claude Desktop

Cursor

VS Code (with an MCP extension)

Hosted (no install)

What you can do

Tools

`convert_document` — input options

Config

Pricing

Privacy

Troubleshooting

Local development

Links

License

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Mdmagic?

Does Mdmagic need an API key?

What transport does Mdmagic use?

When was Mdmagic last checked?

Documentation

MDMagic MCP Server

Install

Claude Desktop

Cursor

VS Code (with an MCP extension)

Hosted (no install)

What you can do

Tools

convert_document — input options

Config

Pricing

Privacy

Troubleshooting

Local development

Links

License

`convert_document` — input options