io.github.MDMagic-MCP/mdmagic-mcp-server is an MCP server published by io.github.MDMagic-MCP, hosted at api.mdmagic.ai. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 10 tools, including convert_document, list_all_templates, list_builtin_templates, list_custom_templates, show_default_settings.
Use your own Word templates to convert Markdown → DOCX/PDF/HTML from any MCP-compatible AI.
Nothing else in the archive shares these values.
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 with timestamped names like 'content-1778298071915.docx' which is bad UX. 4. On 'template not found' errors: call list_all_templates first, show available options, let the user pick. Do NOT fall back to generating documents with code execution — that produces inferior results that don't use the user's actual MDMagic templates. 5. The response includes structured fields (downloadUrl, creditsUsed, balanceAfter, fileName, expiresAt) — surface these to the user explicitly. Don't paraphrase. The user wants to know exactly what they spent and what's left. 6. Page sizes: A3, A4, Executive, US_Legal, US_Letter. Default A4. Orientation: Portrait or Landscape, default Portrait. 7. CRITICAL — newlines in `content`: markdown is line-sensitive. Headings (#, ##), tables (| ... |), lists (-, 1.), and code fences (```) ONLY work when each starts on its own line. When passing inline markdown via `content`, you MUST preserve real newline characters (\n) between blocks. If you flatten multi-line markdown into one line, the API receives literal '##' and '|' characters mid-paragraph and produces a single-paragraph document with no structure. Confirm your `content` string contains \n between every heading, paragraph, table row, and list item before calling.
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
| Parameter | Type | Description |
|---|---|---|
| content | string | Raw markdown text content (alternative to filePath or fileContent). MUST preserve real newlines (\n) between every block: heading, paragraph, table row, list item, code fence. Markdown is line-sensitive — a single-line blob with embedded '##' or '|' renders as literal text, not as a heading or table… |
| fileName | string | Optional desired base name for the output file (without extension). If the user attached a file like 'mydoc.md', pass 'mydoc' here. The API will use this for the download filename. If omitted, the API derives one from the markdown's first H1 heading. |
| filePath | string | Path to markdown file (VS Code integration, alternative to content or fileContent) |
| pageSize | string | Page size for the document (default: A4) |
| fileContent | string | Base64 encoded file content (alternative to content or filePath) |
| orientation | string | Page orientation (default: Portrait) |
| outputFormat * | string | Output format. 'docx', 'pdf', or 'html' return that single file; 'all' returns a ZIP with DOCX+PDF+HTML. |
| templateName * | string | Template to use for conversion. Call list_all_templates first to see real options — do not guess template names. Some templates are built-in (e.g. 'Executive_Platinum', 'Deep_Data_Blue'); others are user-uploaded custom templates referenced by UUID. |
{
"name": "convert_document",
"description": "Convert markdown to a professionally formatted document using an MDMagic template.\n\nIMPORTANT GUIDANCE:\n\n1. Output format → what user gets:\n - 'docx' → a single Word .docx file\n - 'pdf' → a single .pdf file\n - 'html' → a single .html file\n - 'all' → a ZIP containing all three (DOCX + PDF + HTML)\n\n2. If the user is ambiguous (e.g. 'convert this'), ASK which format they want before calling. Don't assume.\n\n3. 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 with timestamped names like 'content-1778298071915.docx' which is bad UX.\n\n4. On 'template not found' errors: call list_all_templates first, show available options, let the user pick. Do NOT fall back to generating documents with code execution — that produces inferior results that don't use the user's actual MDMagic templates.\n\n5. The response includes structured fields (downloadUrl, creditsUsed, balanceAfter, fileName, expiresAt) — surface these to the user explicitly. Don't paraphrase. The user wants to know exactly what they spent and what's left.\n\n6. Page sizes: A3, A4, Executive, US_Legal, US_Letter. Default A4. Orientation: Portrait or Landscape, default Portrait.\n\n7. CRITICAL — newlines in `content`: markdown is line-sensitive. Headings (#, ##), tables (| ... |), lists (-, 1.), and code fences (```) ONLY work when each starts on its own line. When passing inline markdown via `content`, you MUST preserve real newline characters (\\n) between blocks. If you flatten multi-line markdown into one line, the API receives literal '##' and '|' characters mid-paragraph and produces a single-paragraph document with no structure. Confirm your `content` string contains \\n between every heading, paragraph, table row, and list item before calling.",
"inputSchema": {
"type": "object",
"required": [
"templateName",
"outputFormat"
],
"properties": {
"content": {
"type": "string",
"description": "Raw markdown text content (alternative to filePath or fileContent). MUST preserve real newlines (\\n) between every block: heading, paragraph, table row, list item, code fence. Markdown is line-sensitive — a single-line blob with embedded '##' or '|' renders as literal text, not as a heading or table. If your source markdown has 30 lines, the string you pass here also has 30 lines separated by \\n."
},
"fileName": {
"type": "string",
"description": "Optional desired base name for the output file (without extension). If the user attached a file like 'mydoc.md', pass 'mydoc' here. The API will use this for the download filename. If omitted, the API derives one from the markdown's first H1 heading."
},
"filePath": {
"type": "string",
"description": "Path to markdown file (VS Code integration, alternative to content or fileContent)"
},
"pageSize": {
"enum": [
"A3",
"A4",
"Executive",
"US_Legal",
"US_Letter"
],
"type": "string",
"description": "Page size for the document (default: A4)"
},
"fileContent": {
"type": "string",
"description": "Base64 encoded file content (alternative to content or filePath)"
},
"orientation": {
"enum": [
"Portrait",
"Landscape"
],
"type": "string",
"description": "Page orientation (default: Portrait)"
},
"outputFormat": {
"enum": [
"docx",
"pdf",
"html",
"all"
],
"type": "string",
"description": "Output format. 'docx', 'pdf', or 'html' return that single file; 'all' returns a ZIP with DOCX+PDF+HTML."
},
"templateName": {
"type": "string",
"description": "Template to use for conversion. Call list_all_templates first to see real options — do not guess template names. Some templates are built-in (e.g. 'Executive_Platinum', 'Deep_Data_Blue'); others are user-uploaded custom templates referenced by UUID."
}
}
},
"annotations": {
"title": "Convert markdown to a professional document",
"readOnlyHint": false,
"openWorldHint": true,
"idempotentHint": false,
"destructiveHint": false
}
}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 category filter to narrow recommendations (e.g. 'for legal documents' → category: 'Professional').
| Parameter | Type | Description |
|---|---|---|
| category | string | Optional filter — return only built-in templates in this category. Custom templates are always included regardless. Categories: Business (executive/financial), Creative (designer/artistic/novelty), Professional (legal), Technical (code/data documentation). |
| includeDetails | boolean | Include template details like available page sizes and orientations (default: false) |
{
"name": "list_all_templates",
"description": "List all 15 built-in MDMagic templates plus any custom templates the user has uploaded.\n\nCALL THIS PROACTIVELY when:\n- The user mentions a template by name (verify it exists before convert_document)\n- The user asks 'what templates are available' or similar\n- A previous convert_document call returned 'template not found'\n- The user describes the look they want without naming a template (so you can suggest a real one)\n\nReturns: name, description, type (built-in vs custom), and category. Categories are: Business (5 templates), Creative (6), Professional (2), Technical (2). Use the optional category filter to narrow recommendations (e.g. 'for legal documents' → category: 'Professional').",
"inputSchema": {
"type": "object",
"properties": {
"category": {
"enum": [
"Business",
"Creative",
"Professional",
"Technical"
],
"type": "string",
"description": "Optional filter — return only built-in templates in this category. Custom templates are always included regardless. Categories: Business (executive/financial), Creative (designer/artistic/novelty), Professional (legal), Technical (code/data documentation)."
},
"includeDetails": {
"type": "boolean",
"description": "Include template details like available page sizes and orientations (default: false)"
}
}
},
"annotations": {
"title": "List all MDMagic templates",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| category | string | Optional filter — return only templates in this category. |
| includeDetails | boolean | Include template details like available page sizes and orientations (default: false) |
{
"name": "list_builtin_templates",
"description": "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.\n\nCategories available: Business (5), Creative (6), Professional (2), Technical (2).",
"inputSchema": {
"type": "object",
"properties": {
"category": {
"enum": [
"Business",
"Creative",
"Professional",
"Technical"
],
"type": "string",
"description": "Optional filter — return only templates in this category."
},
"includeDetails": {
"type": "boolean",
"description": "Include template details like available page sizes and orientations (default: false)"
}
}
},
"annotations": {
"title": "List built-in MDMagic templates",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| includeDetails | boolean | Include template details like available page sizes and orientations (default: false) |
{
"name": "list_custom_templates",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"includeDetails": {
"type": "boolean",
"description": "Include template details like available page sizes and orientations (default: false)"
}
}
},
"annotations": {
"title": "List user's custom templates",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "show_default_settings",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Show user's default page size and orientation",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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
No parameters.
{
"name": "check_credit_balance",
"description": "Check the user's current MDMagic credit balance: subscription credits (renewable monthly), purchased credits (permanent), plan name, and plan status.\n\nCALL THIS PROACTIVELY when:\n- The user asks 'how many credits do I have' or similar\n- After a conversion, if the user wants to know what's left (also returned by convert_document directly)\n- Before a conversion of an unusually large document, to warn the user if balance is borderline",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Check MDMagic credit balance",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| content * | string | Markdown content to estimate credit cost for |
| pageSize | string | Page size for the document |
| orientation | string | Page orientation |
| outputFormat * | string | Output format(s): docx (DOCX only), pdf (DOCX+PDF), html (DOCX+HTML), all/all-formats (DOCX+PDF+HTML) |
| templateName * | string | Template ID or name (UUID for custom templates, name for system templates) |
{
"name": "estimate_conversion_cost",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"content",
"templateName",
"outputFormat"
],
"properties": {
"content": {
"type": "string",
"description": "Markdown content to estimate credit cost for"
},
"pageSize": {
"enum": [
"A3",
"A4",
"Executive",
"US_Legal",
"US_Letter"
],
"type": "string",
"description": "Page size for the document"
},
"orientation": {
"enum": [
"Portrait",
"Landscape"
],
"type": "string",
"description": "Page orientation"
},
"outputFormat": {
"enum": [
"docx",
"pdf",
"html",
"all",
"all-formats"
],
"type": "string",
"description": "Output format(s): docx (DOCX only), pdf (DOCX+PDF), html (DOCX+HTML), all/all-formats (DOCX+PDF+HTML)"
},
"templateName": {
"type": "string",
"description": "Template ID or name (UUID for custom templates, name for system templates)"
}
}
},
"annotations": {
"title": "Estimate credit cost for a conversion",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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=will likely break), detected features (tables, code blocks, task lists, math), and a human-readable message.
| Parameter | Type | Description |
|---|---|---|
| content * | string | Markdown content to validate |
| filename | string | Optional filename label for the response (defaults to 'content.md') |
{
"name": "validate_markdown",
"description": "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.\n\nCALL THIS PROACTIVELY when:\n- The user is about to convert a long document (>5 pages) — validating first is cheap; running a doomed conversion costs credits\n- The user reports a previous conversion produced broken output\n- You generated the markdown yourself and want to verify it's clean before spending credits\n\nReturns: status (green=safe, amber=minor issues, red=will likely break), detected features (tables, code blocks, task lists, math), and a human-readable message.",
"inputSchema": {
"type": "object",
"required": [
"content"
],
"properties": {
"content": {
"type": "string",
"description": "Markdown content to validate"
},
"filename": {
"type": "string",
"description": "Optional filename label for the response (defaults to 'content.md')"
}
}
},
"annotations": {
"title": "Validate markdown before conversion",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| templateName * | string | Template ID or name (e.g. Executive_Platinum, or a UUID for custom templates) |
{
"name": "get_template_details",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"templateName"
],
"properties": {
"templateName": {
"type": "string",
"description": "Template ID or name (e.g. Executive_Platinum, or a UUID for custom templates)"
}
}
},
"annotations": {
"title": "Show template variant matrix",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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'.
| Parameter | Type | Description |
|---|---|---|
| topN | integer | How many recommendations to return (1-5, default 3) |
| purpose * | string | Free-text description of the document's purpose. Examples: 'Q4 board pack for investors', 'restaurant menu', 'developer API documentation', 'wedding invitation'. |
{
"name": "recommend_template",
"description": "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.\n\nWhy 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'.",
"inputSchema": {
"type": "object",
"required": [
"purpose"
],
"properties": {
"topN": {
"type": "integer",
"maximum": 5,
"minimum": 1,
"description": "How many recommendations to return (1-5, default 3)"
},
"purpose": {
"type": "string",
"description": "Free-text description of the document's purpose. Examples: 'Q4 board pack for investors', 'restaurant menu', 'developer API documentation', 'wedding invitation'."
}
}
},
"annotations": {
"title": "Recommend a template for a stated purpose",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Names, descriptions and schemas were written by the server and are shown as data.