Server data from the Official MCP Registry
Use your own Word templates to convert Markdown → DOCX/PDF/HTML from any MCP-compatible AI.
Use your own Word templates to convert Markdown → DOCX/PDF/HTML from any MCP-compatible AI.
Remote endpoints: streamable-http: https://api.mdmagic.ai/mcp
MDMagic MCP server is well-architected with proper authentication, reasonable permission scope, and clean code practices. API key validation is enforced, credentials are handled correctly via environment variables, and the codebase demonstrates good security awareness through input validation and error handling. Minor findings include overly broad exception handling and some code quality improvements, but these do not represent security vulnerabilities. Supply chain analysis found 8 known vulnerabilities in dependencies (2 critical, 0 high severity). Package verification found 1 issue.
4 files analyzed · 14 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: MDMAGIC_API_KEY
Environment variable: MDMAGIC_BASE_URL
Environment variable: REQUEST_TIMEOUT
Environment variable: MCP_TRANSPORT
Environment variable: MCP_HTTP_PORT
Environment variable: MCP_HTTP_HOST
Available as Local & Remote
This plugin can run on your machine or connect to a hosted endpoint. during install.
From the project's GitHub README.
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.
You need an MDMagic account (free tier available) and your API key from your account page.
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:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/Claude/claude_desktop_config.jsonRestart Claude Desktop. The MDMagic tools will appear in the tool list.
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"
}
}
}
}
{
"mcp.servers": {
"mdmagic": {
"command": "npx",
"args": ["-y", "@mdmagic/mcp-server@latest"],
"env": {
"MDMAGIC_API_KEY": "mdmagic-xxxxxxxxxxxxxxxx"
}
}
}
}
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.
Once connected, ask your AI assistant things like:
The AI picks the right tool and returns a secure, time-limited download link.
| 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 optionsThree 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 UUIDoutputFormat — docx, pdf, html, all, or all-formatspageSize — A4, A3, US_Letter, US_Legal, Executiveorientation — Portrait or Landscape| 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.
Conversions cost credits, calculated from page count and output format:
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.
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.
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.
MIT — see LICENSE.
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
by mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
by Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
by mcp-marketplace · Developer Tools
Scaffold, build, and publish TypeScript MCP servers to npm — conversationally
by mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.