MCP server that converts documents (PDF, DOCX, PPTX, XLSX, images, etc.) to Markdown using the markitdown library
Single tool 'convert_to_markdown' has a reasonable description (89 chars) but lacks critical schema documentation. Input schema shows only 'uri' parameter with basic type and description, but no constraints (format, pattern, length limits), no output schema documentation, and no error handling guidance. Tool name is clear (verb_noun pattern), but parameter description is minimal. No parameter validation rules, no enum constraints for supported formats, no pagination/limits, and no structured output schema visible. Follows basic naming convention but falls short on schema completeness and LLM-optimized documentation.
Convert a document file to Markdown format. Supports PDF, DOCX, PPTX, XLSX, images (PNG, JPG, GIF, WebP, SVG), and other formats.
No output schema documented. LLMs cannot plan downstream operations or extract structured data from conversion results.
Input parameter 'uri' lacks format constraints. No regex pattern, length limits, or validation rules. Description does not specify accepted URI schemes (file://, http://, etc.) or path format requirements.
Supported file formats listed in tool description (PDF, DOCX, PPTX, XLSX, PNG, JPG, GIF, WebP, SVG) but not as enum constraint. LLMs may attempt unsupported formats without validation.
No error handling guidance. Tool description does not explain what happens on unsupported formats, missing files, or conversion failures. LLMs have no recovery path.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 52 | 2026-07-28+ | v2 |
Parameter description is 47 characters, below the 72-char baseline for A+ tools. Lacks context on when to use file:// vs local paths, or how to handle relative vs absolute paths.