MarkItDown (Microsoft)
Last tested 2026-10-22
Score 100/100 · Last tested 2026-10-22 · Version tested 0.0.1a8 · Package markitdown-mcp · Repo microsoft/markitdown
Summary: MarkItDown (Microsoft) completed an MCP handshake without credentials and exposed 1 tools.
Test results
| Test | Result | Points | Evidence |
|---|---|---|---|
| install | pass | 20 | uv pip install markitdown-mcp (Python venv, Linux) succeeded in 0s. |
| handshake | pass | 30 | MCP initialize + tools/list over stdio succeeded with no credentials; 1 tools listed in 11.6s. |
| maintenance | pass | 25 | Repo pushed 0 days before test; 191,528 GitHub stars. |
| docs | pass | 15 | README over 3,000 chars; install instructions present; mcpServers config example present. Automated check of the package's own README (PyPI long_description (package README)). |
| license | pass | 10 | MIT (OSI-approved). |
Local-model readiness
Schema context cost: ~63 tokens for 1 tools (272 bytes) · about 1% of an 8k context. Method: tiktoken cl100k_base over compact JSON of name+description+inputSchema (approximate).
Small-model friendly (schema heuristic, not a model result): high.
| Model | Quantization | Runs | Task completed | Correct tool | Avg rounds |
|---|---|---|---|---|---|
| qwen2.5-3b-instruct-q4km | Q4_K_M GGUF (bartowski/Qwen2.5-3B-Instruct-GGUF), CPU-only | 3 | 0% | 0% | 1 |
| qwen2.5-1.5b-instruct-q4km | Q4_K_M GGUF (bartowski/Qwen2.5-1.5B-Instruct-GGUF), CPU-only | 3 | 100% | 100% | 2 |
Functional tasks (1/1 passed, tested 2026-10-22)
| Task | Tool | Result | Evidence |
|---|---|---|---|
| fetch public URL (https://example.com/) | convert_to_markdown | pass | [{"text":"This domain is for use in documentation examples without needing permission. This is not a service; avoid relying on it for testing and monitoring pur |
Not tested
We did not test behavior with real credentials, security, or performance under load. These are planned; see methodology.
Tools listed
convert_to_markdown
Config used in our test
{
"mcpServers": {
"markitdown-microsoft": {
"command": "uvx",
"args": [
"markitdown-mcp"
]
}
}
}FAQ
Is MarkItDown (Microsoft) deprecated?
No. markitdown-mcp was not deprecated or archived when we last tested it on 2026-10-22.
What replaces MarkItDown (Microsoft)?
Nothing; MarkItDown (Microsoft) is not deprecated as of 2026-10-22.
Does MarkItDown (Microsoft) need an API key?
No. It completed an MCP handshake with no credentials and listed 1 tools.
Embed the badge
The badge always shows the current score; payment never changes it.