mdmagic-mcp-server
io.github.MDMagic-MCP/mdmagic-mcp-serverMDMagic-MCPstreamable-httpv1.7.14Scanned
Use your own Word templates to convert Markdown → DOCX/PDF/HTML from any MCP-compatible AI.
10 tools: 4 change things and 6 only read.
- Reads private data · 0
- Reads text others write · 7
- Can send data out · 0
- No findings
Tools listed without sign-in. Remote posture
Anlyon alternative
4 of these tools change something. Run those as governed actions.
Declare what an action changes, and Anlyon puts it under a shared limit, binds every approval to the exact request, and grades the outcome. It works on any HTTPS API you can describe as an action.
Anlyon Radar does not run, proxy or govern this MCP server. A tool your own code calls directly is not routed through Anlyon and is not governed by it.
Import an OpenAPI spec →What the mdmagic-mcp-server can do
The mdmagic-mcp-server is published by the GitHub account MDMagic-MCP. It has 10 tools. It can create or change data (4 tools: convert_document, check_credit_balance, estimate_conversion_cost and recommend_template), but cannot delete data. 6 tools only read.
7 tools bring in text other people can write (convert_document, list_all_templates, list_builtin_templates and 4 more).
None of the fixed checks matched anything in its tool definitions. That is not a safety guarantee.
Its remote endpoint lists its tools without sign-in.
Last scanned Nov 2, 2026, version 1.7.14.
Tools
Grouped by what each tool does, most consequential first. Open one for its reasons and full description; descriptions are the publisher's own words.
10 tools
Changes things 4Claude Code: ask
check_credit_balanceCheck the user's current MDMagic credit balance: subscription credits (renewable monthly), purchased credits (permanent), plan name, and plan status.Reads text others writeNo findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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
Annotations the server declares
- title: Check MDMagic credit balance
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
convert_documentConvert markdown to a professionally formatted document using an MDMagic template.Reads text others writeNo findings
Why it is in this group
- The name "convert_document" says "convert": a word for a change.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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.
Annotations the server declares
- title: Convert markdown to a professional document
- readOnlyHint: false
- destructiveHint: false
- idempotentHint: false
- openWorldHint: true
estimate_conversion_costEstimate credit cost for a conversion BEFORE running it.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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.
Annotations the server declares
- title: Estimate credit cost for a conversion
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
recommend_templateSuggest the best built-in template(s) for a described purpose.No findings
Why it is in this group
- Nothing in its name or description says what it does, so it is counted as a write.
- The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
Description, as the server wrote it 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'.
Annotations the server declares
- title: Recommend a template for a stated purpose
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
Only reads 6Show 6 read-only tools
get_template_detailsShow available variants (page sizes and orientations) for a specific template.Reads text others writeNo findings
Why it is in this group
- The name "get_template_details" says "get": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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.
Annotations the server declares
- title: Show template variant matrix
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
list_all_templatesList all 15 built-in MDMagic templates plus any custom templates the user has uploaded.Reads text others writeNo findings
Why it is in this group
- The name "list_all_templates" says "list": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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').
Annotations the server declares
- title: List all MDMagic templates
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
list_builtin_templatesList the 15 built-in MDMagic templates, grouped by category.Reads text others writeNo findings
Why it is in this group
- The name "list_builtin_templates" says "list": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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).
Annotations the server declares
- title: List built-in MDMagic templates
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
list_custom_templatesList only the user's custom-uploaded Word templates.Reads text others writeNo findings
Why it is in this group
- The name "list_custom_templates" says "list": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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.
Annotations the server declares
- title: List user's custom templates
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
show_default_settingsShow the user's default paper size and orientation preferences (set on their account page).Reads text others writeNo findings
Why it is in this group
- The name "show_default_settings" says "show": a word for reading.
What it can reach
- untrusted-inputThe server marks it openWorldHint: true: it reaches things outside the server's own data.
Description, as the server wrote it 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.
Annotations the server declares
- title: Show user's default page size and orientation
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: true
validate_markdownPre-flight markdown validation BEFORE conversion.No findings
Why it is in this group
- The name "validate_markdown" says "validate": a word for reading.
Description, as the server wrote it 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.
Annotations the server declares
- title: Validate markdown before conversion
- readOnlyHint: true
- destructiveHint: false
- idempotentHint: true
- openWorldHint: false
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Exfil surface
Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.
No private-data, untrusted-input, outbound path in this server alone: no tool is tagged private-data or outbound.
- Reads private data0
- Reads files, mail, messages, databases, secrets, calendars or repositories.
- Reads text others write7
- Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
- Can send data out0
- Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.
Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.
Remote posture
What anyone on the internet sees at the remote endpoint: an anonymous initialize and tools/list, and the public OAuth metadata.
Looked at Nov 20, 2026, 18:59 UTC, unchanged since Nov 20, 2026. No credentials were sent and no tool was called. What is looked at.
- Reachable
- yes
- HTTP status of an anonymous initialize
- 200
- tools/list served without credentials
- yes
- Tools that change things, listed without credentials
- 4
- Protocol version
- 2025-06-18
- WWW-Authenticate on 401
- not observed
- resource_metadata in WWW-Authenticate
- not observed
- RFC 9728 protected resource metadata
- not observed
- Authorization servers
- not observed
- Legacy HTTP+SSE transport
- no
- Dynamic client registration
- not observed
- Client ID metadata documents
- not observed
- WarnThe whole server
The endpoint served tools/list without credentials, and the list has 4 tools that change things (4 write). Whether a call also works without credentials was not tested: tools are never called.
What this check looks forMatched text
https://api.mdmagic.ai/mcp: tools/list returned 10 tools to an anonymous client, including convert_document (write), check_credit_balance (write), estimate_conversion_cost (write), recommend_template (write)
Posture changes
- Nov 20, 2026
- HTTP status of an anonymous initialize: 530 to 200
- tools/list served without credentials: no to yes
- Tools that change things, listed without credentials: 0 to 4
- Protocol version: none to 2025-06-18
- Nov 13, 2026
- HTTP status of an anonymous initialize: 200 to 530
- tools/list served without credentials: yes to no
- Tools that change things, listed without credentials: 4 to 0
- Protocol version: 2025-06-18 to none
Findings
Matches of fixed checks, with the text they matched.
No check matched anything in these tool definitions. That is not a safety guarantee.
History
Changes to its tool definitions and to its remote endpoint, newest first.
PostureRemote posture changed. HTTP status of an anonymous initialize: 530 -> 200; tools/list served without credentials: no -> yes; Tools that change things, listed without credentials: 0 -> 4 (and 1 more).View diff
- HTTP status of an anonymous initialize: 530 to 200
- tools/list served without credentials: no to yes
- Tools that change things, listed without credentials: 0 to 4
- Protocol version: none to 2025-06-18
PostureRemote posture changed. HTTP status of an anonymous initialize: 200 -> 530; tools/list served without credentials: yes -> no; Tools that change things, listed without credentials: 4 -> 0 (and 1 more).View diff
- HTTP status of an anonymous initialize: 200 to 530
- tools/list served without credentials: yes to no
- Tools that change things, listed without credentials: 4 to 0
- Protocol version: 2025-06-18 to none
Install
Pinned to version 1.7.14. Values in angle brackets are yours to fill in.
claude mcp add --transport http mdmagic https://api.mdmagic.ai/mcp --header 'x-api-key: <your-x-api-key>'claude mcp add --transport http mdmagic https://api.mdmagic.ai/mcp --header 'x-api-key: <your-x-api-key>'Run in a terminal.
Claude Code permissions
Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__mdmagic__list_all_templates",
"mcp__mdmagic__list_builtin_templates",
"mcp__mdmagic__list_custom_templates",
"mcp__mdmagic__show_default_settings",
"mcp__mdmagic__validate_markdown",
"mcp__mdmagic__get_template_details"
],
"ask": [
"mcp__mdmagic__convert_document",
"mcp__mdmagic__check_credit_balance",
"mcp__mdmagic__estimate_conversion_cost",
"mcp__mdmagic__recommend_template"
],
"deny": []
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as mdmagic. Review it before you use it.
Capability tags behind 7 rules
- mcp__mdmagic__convert_document untrusted-input
- mcp__mdmagic__list_all_templates untrusted-input
- mcp__mdmagic__list_builtin_templates untrusted-input
- mcp__mdmagic__list_custom_templates untrusted-input
- mcp__mdmagic__show_default_settings untrusted-input
- mcp__mdmagic__check_credit_balance untrusted-input
- mcp__mdmagic__get_template_details untrusted-input
Pin
Keep the decision: fail CI when the tools change, follow every change, or show a badge.
Pin in CI
Fail a build when the tools you reviewed are not the tools the server serves today.
curl -s "https://radar.anlyon.com/api/v1/servers/io.github.MDMagic-MCP/mdmagic-mcp-server/verify?hash=3d0e3b1195aecb2c71c31f5f1b60c3b0cbebe75a883611b338dbd5454a964401" | jq -e '.changed == false'Pinned hash 3d0e3b1195ae, from Nov 2, 2026, 17:18 UTC.
Watch
Get told when its tools change: a new tool, a new description, a new class.
https://radar.anlyon.com/servers/io.github.MDMagic-MCP/mdmagic-mcp-server/changes.xmlAn Atom feed. Works in any feed reader or Slack's RSS app.
Badge
[](https://radar.anlyon.com/servers/io.github.MDMagic-MCP/mdmagic-mcp-server)Source: MCP Registry · repository. Synced Oct 21, 2026, 18:17 UTC.
mdmagic-mcp-server: questions and answers
Answered from the scan above, not from the publisher's description.
Is the mdmagic-mcp-server safe?
- No scan can promise that. What its definitions show: 10 tools, 4 of which can change, send or delete something, and 0 findings from fixed checks. Allow the reads, ask before each change, and deny the deletes; the permissions block on this page does that.
Can the mdmagic-mcp-server delete data?
- No tool is classed as destructive: going by their definitions, none of them deletes, cancels or revokes anything.
Can the mdmagic-mcp-server do things that cannot be undone?
- No tool is classed as irreversible: none of them sends, pays, publishes or merges, going by their definitions.
What tools does the mdmagic-mcp-server have?
- 10 tools: 4 write, 6 read. convert_document, check_credit_balance, estimate_conversion_cost, recommend_template, list_all_templates, list_builtin_templates, list_custom_templates, show_default_settings and 2 more.
Does the mdmagic-mcp-server need sign-in or OAuth?
- Its remote endpoint listed its tools to an anonymous client, without sign-in.
Does the mdmagic-mcp-server send data to outside services?
- None of its tools sends, posts or publishes, or takes a recipient, channel or URL.
Has the mdmagic-mcp-server changed its tools?
- Not since Anlyon Radar started tracking it. Last scanned Nov 2, 2026.