Mdmagic MCP Server
Use your own Word templates to convert Markdown → DOCX/PDF/HTML from any MCP-compatible AI.
Connector by MDMagic-MCP · GitHub account verified by the MCP Registry
Install
Works with Claude Code, VS Code, Codex, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.
npx agentmarket install connector/mdmagic-mcp-mdmagic-mcp-server
Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.
Remote endpoint
https://api.mdmagic.ai/mcpRemote (HTTP)
Get the weekly diff
The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.
About
Reviews
Write a reviewNo reviews yet. Installed it? Reviews come from verified installers only. How reviews work
Permissions
What this server can do and what it asks for, from its tool list and install config. Checked Oct 25, 2026.
- Tools
- 9 read · 1 write · 0 delete
- Secrets
- 2 (API keys, tokens or passwords)
- Install scripts
- Not scanned yet
- Runs as
- Node.js package
Tools by what they do 10
From the running server's own tool list (tools/list) on Oct 25, 2026.
Read 9 · Look things up without changing anything.
check_credit_balanceestimate_conversion_costget_template_detailslist_all_templateslist_builtin_templateslist_custom_templatesrecommend_templateshow_default_settingsvalidate_markdown
Write 1 · Create, change, send or run things.
convert_document
Secrets and settings it asks for
Secrets: values you paste in that let it act as you.
MDMAGIC_API_KEYx-api-key
Other settings (environment variables or headers).
MCP_HTTP_HOSTMCP_HTTP_PORTMCP_TRANSPORTMDMAGIC_BASE_URLREQUEST_TIMEOUT
Network hosts it talks to 1
api.mdmagic.ai· found in remote endpoint, install command
Files it touches
- Any path the agent passes to its tools
Tools (10)
As the server listed them on Oct 25, 2026. Descriptions are the server’s own words; hidden characters are shown as [U+…].
check_credit_balanceCheck MDMagic credit balanceread-onlyCheck the user's current MDMagic credit balance: subscription credits (renewable monthly), purchased credits (permanent), plan name, and plan status. CALL THIS PROACTIVELY when: - The user asks 'how many credits do I have' or similar - After a conversion, if the user wants to know what's left (also returned by convert_document directly) - Before a conversion of an unusually large document, to warn the user if balance is borderline
convert_documentConvert markdown to a professional documentConvert markdown to a professionally formatted document using an MDMagic template. IMPORTANT GUIDANCE: 1. Output format → what user gets: - 'docx' → a single Word .docx file - 'pdf' → a single .pdf file - 'html' → a single .html file - 'all' → a ZIP containing all three (DOCX + PDF + HTML) 2. If the user is ambiguous (e.g. 'convert this'), ASK which format they want before calling. Don't assume. 3. Filename: if the user attached a file (e.g. 'mydoc.md'), pass its base name as fileName. Otherwise the API derives one from the markdown's first H1. Without either, downloads end up …
estimate_conversion_costEstimate credit cost for a conversionread-onlyEstimate credit cost for a conversion BEFORE running it. Returns word count, page calculation (300 words/page), and a credit breakdown by format and template type. Use this when the user asks 'how much will this cost?' or when you suspect a conversion might exceed their balance — convert_document refuses to run if credits are insufficient, so estimating first is friendlier.
get_template_detailsShow template variant matrixread-onlyShow available variants (page sizes and orientations) for a specific template. All MDMagic templates support the full 5×2 matrix: A3, A4, Executive, US_Legal, US_Letter × Portrait/Landscape. Use this when the user asks 'does this template come in Legal Landscape?' or 'what sizes are available?' — confirms the variant before convert_document runs.
list_all_templatesList all MDMagic templatesread-onlyList all 15 built-in MDMagic templates plus any custom templates the user has uploaded. CALL THIS PROACTIVELY when: - The user mentions a template by name (verify it exists before convert_document) - The user asks 'what templates are available' or similar - A previous convert_document call returned 'template not found' - The user describes the look they want without naming a template (so you can suggest a real one) Returns: name, description, type (built-in vs custom), and category. Categories are: Business (5 templates), Creative (6), Professional (2), Technical (2). Use the optional catego…
list_builtin_templatesList built-in MDMagic templatesread-onlyList the 15 built-in MDMagic templates, grouped by category. Same as list_all_templates but excludes the user's custom uploads. Use this when the user asks specifically about MDMagic's bundled templates rather than their personal ones. Categories available: Business (5), Creative (6), Professional (2), Technical (2).
list_custom_templatesList user's custom templatesread-onlyList only the user's custom-uploaded Word templates. Use this when the user asks about their own templates ('show me my templates', 'do I have a letterhead?'). Custom templates are referenced by UUID, not name, when calling convert_document.
recommend_templateRecommend a template for a stated purposeread-onlySuggest the best built-in template(s) for a described purpose. Use this when the user describes WHAT the document is (e.g. 'Q4 board pack', 'API reference', 'wedding invitation', 'legal contract') without naming a template. Returns ranked recommendations with rationale. Why this exists: AI assistants often guess template names that don't exist. This tool maps purpose → real template names from MDMagic's catalog, so convert_document doesn't fail with 'template not found'.
show_default_settingsShow user's default page size and orientationread-onlyShow the user's default paper size and orientation preferences (set on their account page). Useful when the user hasn't specified pageSize/orientation explicitly — call this to honor their defaults instead of using A4/Portrait blindly.
validate_markdownValidate markdown before conversionread-onlyPre-flight markdown validation BEFORE conversion. Catches malformed tables (mismatched pipes), unclosed code fences, broken task lists, and unsupported syntax. Returns a green/amber/red status plus the detected markdown features. CALL THIS PROACTIVELY when: - The user is about to convert a long document (>5 pages) — validating first is cheap; running a doomed conversion costs credits - The user reports a previous conversion produced broken output - You generated the markdown yourself and want to verify it's clean before spending credits Returns: status (green=safe, amber=minor issues, red=wi…
Signals
- Stars
- 0
- Forks
- 0
- Open issues
- 0
- Weekly downloads
- 40
- Last commit
- May 19, 2026 (5 months ago)
- Last release
- May 14, 2026 (5 months ago)
- Last package publish
- May 19, 2026 (5 months ago)
From GitHub (fetched Oct 24, 2026) and the package registry.
Details
- Registry name
io.github.MDMagic-MCP/mdmagic-mcp-server- Version
- 1.7.14
- Auth
- API key
- Packages
- npm @mdmagic/mcp-server
- License
- MIT
- Website
- mdmagic.ai/mcp
- First seen
- Oct 24, 2026
- Last checked
- Oct 24, 2026
Cite this page
Mdmagic MCP Server. Agent Mart. https://agentmart.dev/connectors/mdmagic-mcp-mdmagic-mcp-server (last updated 2026-10-24)