file2markdown
VerifiedFeaturedRemoteAbout file2markdown
file2markdown is a hosted MCP server that converts documents and public web pages into Markdown for AI assistants and MCP clients. Its engine-extracted output supports formats that clients may not parse natively, including Office files and scanned PDFs.
Key features
- 01Convert public URLs to Markdown
- 02Convert file contents from Base64
- 03Batch-convert 2–10 documents
- 04Support Office, ebook, image and audio formats
- 05OCR for scanned PDFs and images with Pro
- 06Report supported formats and usage
Use cases
- 01Prepare a PDF for an AI workflow
- 02Extract tables from an Office document
- 03Convert a web page into Markdown
- 04Process several documents in one request
MCP support
Provides document-conversion tools to MCP clients over Streamable HTTP, including URL, Base64 and batch conversion. The hosted endpoint is https://mcp.file2markdown.ai/mcp.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.file2markdown.ai/mcpclaude mcp add --transport http file2markdown https://mcp.file2markdown.ai/mcp{"mcpServers":{"file2markdown":{"type":"http","url":"https://mcp.file2markdown.ai/mcp"}}}Open in Cursor{"servers":{"file2markdown":{"type":"http","url":"https://mcp.file2markdown.ai/mcp"}}}Open in VS Code{"mcpServers":{"file2markdown":{"type":"http","url":"https://mcp.file2markdown.ai/mcp"}}}{"mcpServers":{"file2markdown":{"serverUrl":"https://mcp.file2markdown.ai/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://mcp.file2markdown.ai/mcpAuth requiredTools
5| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | Yes | |
| filename_hint | any | No | |
| quality_check | string | No |
Details
From the project READMEfile2markdown MCP server
Convert documents and web pages to clean, LLM-ready Markdown — from inside Claude, Cursor, or any MCP client.
Endpoint: https://mcp.file2markdown.ai/mcp (Streamable HTTP)
This is the official MCP server for file2markdown.ai. It gives agents deterministic document conversion as a tool: engine-extracted Markdown (no hallucinated table cells, no silent truncation), for anything reachable by URL — including formats assistants can't parse natively, like DOCX, XLSX, PPTX, EPUB, and scanned PDFs.
Tools
| Tool | What it does |
|---|---|
convert_url | Fetch a public URL (web page, PDF, Office doc, …) and return Markdown |
convert_base64 | Convert file contents directly (programmatic clients) |
convert_batch | 2-10 documents in one call, URLs and files mixed, per-item results (Pro API key) |
list_supported_formats | Formats, per-tier limits, and what needs Pro |
usage_status | Your tier and remaining conversions today |
Supported input formats: PDF, DOCX, PPTX, XLSX/XLS, CSV, JSON, XML, HTML, EPUB, JPG/PNG (OCR), WAV/MP3, ZIP.
Quick start
claude.ai — Settings → Connectors → Add custom connector → paste the endpoint URL. When asked about authentication choose None (this server uses API keys, not OAuth). Optional: add a request header Authorization: Bearer f2m_… with a Pro key.
Claude Code
claude mcp add --transport http file2markdown https://mcp.file2markdown.ai/mcp
Cursor / generic clients
{
"mcpServers": {
"file2markdown": { "url": "https://mcp.file2markdown.ai/mcp" }
}
}
Tiers
| Free (no key) | Pro API key | |
|---|---|---|
| Conversions | 5/day per network IP | Unlimited |
| Max download | 25MB | 100MB |
| Scanned-PDF OCR | — | Yes |
| Image OCR | — | Yes |
Pro keys are created on your account page and sent as Authorization: Bearer f2m_…. Plans: pricing.
Honest limits
- Web pages convert from served HTML — no JavaScript rendering, so SPA-style pages may convert incompletely. Near-empty results carry an explicit note (likely consent wall / paywall / JS shell).
- One URL at a time. This is a converter, not a crawler — no bulk scraping, public pages only.
- Output is capped at 200,000 characters (marked
truncated: truewhen hit). - Nothing is stored: files are converted and discarded; usage logging keeps no URLs or content.
Docs & source
- Setup guide: file2markdown.ai/mcp
- Facts page for AI assistants: file2markdown.ai/ai-info
- This repository contains the public documentation and the registry
server.json. The hosted service's application code is not open source.
Support
Email [email protected].
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.