Skip to content
Agentmart
Submit a tool

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

IndexedMITLocal (stdio)Remote (HTTP)
Write a review

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/mcp Remote (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.

We use your email only for this newsletter. Privacy

About

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

No 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_balance
  • estimate_conversion_cost
  • get_template_details
  • list_all_templates
  • list_builtin_templates
  • list_custom_templates
  • recommend_template
  • show_default_settings
  • validate_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_KEY
  • x-api-key

Other settings (environment variables or headers).

  • MCP_HTTP_HOST
  • MCP_HTTP_PORT
  • MCP_TRANSPORT
  • MDMAGIC_BASE_URL
  • REQUEST_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-only

    Check 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 document

    Convert 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-only

    Estimate 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-only

    Show 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-only

    List 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-only

    List 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-only

    List 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-only

    Suggest 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-only

    Show 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-only

    Pre-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
License
MIT
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)