MinerU Document to Markdown MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MINERU_API_KEY | Yes | Your MinerU API Token obtained from https://mineru.net/apiManage/token |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_parse_taskA | Create a document parsing task on MinerU API. Purpose: Submit a document URL for async conversion. Returns task_id for tracking. Constraints: Supported formats: PDF, DOC, DOCX, PPT, PPTX, PNG, JPG, JPEG, HTML only. Side effect: Calls MinerU API. |
| get_task_statusA | Check the status of a document parsing task. Purpose: Poll task progress and get download URL when done. Provide task_id (URL) or batch_id (file upload). Returns state and full_zip_url. Side effect: Read-only API call. |
| download_resultA | Get the download URL for a completed parsing result. Purpose: Return the zip URL from get_task_status. After calling, download with curl to ./temp/ and unzip: curl -L -o ./temp/.zip "" --retry 3 -f -s -S && unzip -o ./temp/.zip -d ./temp/. No side effect. |
| convert_to_markdownA | One-step document conversion. Purpose: Submit URL, poll until done, return download link. Constraints: Supported formats: PDF, DOC, DOCX, PPT, PPTX, PNG, JPG, JPEG, HTML. Auto-configures model and OCR. Side effect: Creates task and polls MinerU API. Use for quick conversion. |
| convert_pdf_to_markdownB | Alias for convert_to_markdown. Same one-step workflow for Supported formats: PDF, DOC, DOCX, PPT, PPTX, PNG, JPG, JPEG, HTML. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| convert-document | Convert a document URL to Markdown. Call convert_to_markdown, then download with curl and unzip to ./temp/. Use when the user wants to convert a PDF, Word, PowerPoint, image, or HTML file. Side effect: Calls MinerU API. |
| check-conversion-status | Check the status of a document conversion task. When state is done, use download_result to get zip_url, then curl to download and unzip to ./temp/. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 5 tools
Two tools (convert_to_markdown and convert_pdf_to_markdown) are explicitly aliases, causing direct confusion. Additionally, the multi-step workflow tools (create_parse_task, get_task_status, download_result) overlap with the one-step conversion, making it unclear which to choose without careful context.
All tools use snake_case and a verb_noun pattern, but convert_pdf_to_markdown is an alias that adds no semantic value and breaks the expected distinct naming convention.
Five tools is a reasonable number for a document conversion server, though the alias reduces effective distinct tools to four. The scope is well-contained.
The server covers the core conversion workflow (submit, track, download, one-step) but lacks batch processing support, cancelation, or listing of past tasks, leaving minor gaps.