streamable-httpupdated 9d ago
Convert documents and web pages to clean, LLM-ready Markdown ā from inside Claude, Cursor, or any MCP client.
What can you do with file2markdown?
file2markdown 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) |
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 robin@file2markdown.ai.
Install
Add file2markdown to your client. Pick the one you use.
claude mcp add --transport http file2markdown https://mcp.file2markdown.ai/mcpcodex mcp add file2markdown --url https://mcp.file2markdown.ai/mcp{
"mcpServers": {
"file2markdown": {
"url": "https://mcp.file2markdown.ai/mcp"
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
{
"servers": {
"file2markdown": {
"type": "http",
"url": "https://mcp.file2markdown.ai/mcp"
}
}
}Add to `.vscode/mcp.json` in your workspace.
{
"mcpServers": {
"file2markdown": {
"url": "https://mcp.file2markdown.ai/mcp"
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"file2markdown": {
"serverUrl": "https://mcp.file2markdown.ai/mcp"
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
4 tools
file2markdown exposes 4 tools to a connected agent.
- convert_url
- Fetch a public URL (web page, PDF, Office doc, ā¦) and return Markdown
- convert_base64
- Convert file contents directly (programmatic clients)
- list_supported_formats
- Formats, per-tier limits, and what needs Pro
- usage_status
- Your tier and remaining conversions today
Score
65 / 100
Good
- Documentation22/25
- Maintenance19/25
- Trust6/20
- Capability6/15
- Install experience12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 2 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 4 tool(s) documented
- Provides prompt templates
- Provides resources
- 6 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint ā no local install
Version history
| Versions | Published |
|---|---|
| 1.0.0Latest | Aug 30, 2026 |