web2md-mcp
This server provides MCP tools for converting webpages to Markdown and retrieving/searching saved conversions.
Convert a webpage URL to clean Markdown with metadata such as title, word count, and reading time.
Optionally include hyperlinks and image references during conversion.
Convert pages through your Chrome extension, useful for Reddit, JavaScript-rendered sites, or login-protected pages.
Convert pages via native messaging through Chrome and the Web2MD extension.
Batch convert up to 50 URLs sequentially through the Chrome extension.
Search saved conversions using natural-language queries.
Retrieve the full Markdown content of a saved conversion by its ID.
Provides access to the Chrome Web Store for installing the Web2MD Chrome extension, which enables browser-based webpage conversion through real browser sessions via Agent Bridge.
Supports conversion of Reddit pages to Markdown through the agent_convert tool using real browser sessions via Agent Bridge, handling JS-rendered and login-protected content.
web2md-mcp
Convert any webpage to clean Markdown from Claude Desktop, Cursor, or any MCP-compatible AI agent.
web2md-mcp is the official Model Context Protocol server for Web2MD. Give your AI agent a convert_url tool and it can turn any webpage — articles, docs, Reddit threads, GitHub READMEs — into clean, token-efficient Markdown without copy-pasting.
Unlike server-side readers, the optional Agent Bridge mode routes conversion through your real browser session — so it works on Reddit, X, paywalled Substack, and other pages that block datacenter scrapers.
Why use this?
The honest version: most webpage-to-Markdown tools convert HTML well. The thing they differ on is whether they can reach the page at all.
web2md-mcp | Jina Reader / Firecrawl | MarkDownload / SingleFile | Turndown | |
Clean Markdown built for LLM context | ✅ | ✅ | ✅ | ✅ (library only) |
Callable by an AI agent (MCP) | ✅ | via HTTP API | ❌ manual click | ❌ |
Works on Reddit / X / paywalled pages | ✅ (Agent Bridge) | ❌ blocked by anti-bot | ✅ (you click it) | n/a |
Uses your authenticated session | ✅ (Agent Bridge) | ❌ datacenter fetch | ✅ | n/a |
Batch convert many URLs unattended | ✅ up to 50 | ✅ | ❌ one at a time | ❌ |
Token counting + metadata | ✅ | ⚠️ varies | ❌ | ❌ |
Where each one is the right answer:
Jina Reader / Firecrawl — public pages at scale, no browser needed. If your URLs are public docs or blogs, these are simpler than running an extension.
MarkDownload / SingleFile / Obsidian Web Clipper — you're reading a page and want to save it yourself. Great at that; they need a human to click.
Turndown — an HTML→Markdown library, not a fetcher. Use it inside your own code.
web2md-mcp — an agent needs the page, and the page is behind a login, a bot wall, or heavy JS. That's the gap this fills: conversion happens in your real browser session, so the page sees you, not a datacenter IP.
If you've hit "I can't access that URL" in Claude or Cursor when pasting a Reddit/X/Substack link, this is the fix.
Related MCP server: octen-mcp
Install
npx -p web2md-mcp-server web2md-mcp-setupThat detects your MCP clients, writes their config, and — only if you ask for a tool that needs an account — opens the browser for OAuth. No password is typed anywhere.
Manual config
~/.claude/claude_desktop_config.json or ~/.cursor/mcp.json:
{
"mcpServers": {
"web2md": { "command": "npx", "args": ["-y", "-p", "web2md-mcp-server", "web2md-mcp"] }
}
}Restart the client afterwards.
No account needed to start. convert_url and convert_file work as soon as
the server is installed. A free API key is only required for the library and
skill tools — add "env": { "WEB2MD_API_KEY": "w2m_..." } to the block above,
or let the setup command handle it.
Tools
Twelve tools, grouped by what they need.
Works without an account
convert_url — convert a webpage to Markdown.
{ "url": "https://example.com/article" }convert_file — convert a local document (Word, PowerPoint, Excel, PDF).
Needs the optional @firecrawl/anydoc dependency; the tool says so if it is missing.
Reads your signed-in browser
These go through the Web2MD Chrome extension, so they see what you see — pages behind a login, or ones that only render after JavaScript runs. A server-side fetch gets a login wall for those.
bridge_convert_url — one URL through the extension. Auto-discovers your
extension via your API key.
agent_convert / agent_batch_convert — same idea over native
messaging (Agent Bridge setup).
Batch takes up to 50 URLs per call and reports token counts for each.
Your saved library
search_library, get_library_items (max 20 per call),
sync_library (mirror the library to a local folder as Markdown),
list_skills, get_skill.
semantic_search and get_conversion still work but are deprecated —
prefer search_library / get_library_items.
Library and skill tools need a free API key. Run the setup command above and it
walks you through OAuth, or set WEB2MD_API_KEY yourself.
Example prompts
Once configured, just ask your agent:
"Convert this Reddit thread to markdown and summarize the top arguments."
"Fetch these 10 blog URLs as markdown and build a comparison table."
"Read this GitHub README as clean markdown and explain the setup steps."
Agent Bridge (browser-based conversion)
Server-side fetching fails on Reddit, X, paywalled Substack/Medium, and JS-heavy SPAs — datacenter IPs get blocked and client-side-rendered content never loads. Agent Bridge solves this by routing the conversion through the Web2MD Chrome extension running in your logged-in browser. Setup guide: web2md.org/docs/advanced/agent-bridge.
Links
🌐 Website: web2md.org
🧩 Chrome Web Store: Web2MD — Web to Markdown
📖 Docs: web2md.org/docs
🔌 MCP spec: modelcontextprotocol.io
✉️ Support: support@web2md.org
License
MIT © Web2MD
Available Tools
12 toolsagent_batch_convertA
The multi-URL form of agent_convert: up to 50 URLs in one call, each read through the user's signed-in Chrome. USE THIS instead of calling agent_convert in a loop — one call, one round trip, and each result carries its own token count. URLs are processed one after another, so a long list takes a while. Same requirements as agent_convert (Chrome + extension + native host).
Inputs: urls (required).
agent_convertA
Convert one URL through the user's own signed-in Chrome, reading the page exactly as they see it. USE THIS when convert_url hits a login wall or returns an empty shell — Reddit, X, paywalled articles, internal wikis, dashboards. Runs silently in the background over a local connection; it does not open or steal focus from any tab. Requires Chrome running with the Web2MD extension and the native host installed (npx -p web2md-mcp-server web2md-mcp-setup). For several URLs at once use agent_batch_convert; if the native host is not installed use bridge_convert_url.
Inputs: url (required), skill.
bridge_convert_urlA
FALLBACK for agent_convert when the native host is not installed. Same capability — reads the page through the user's signed-in Chrome — but it works by opening a browser tab, so it is visible and takes focus. Prefer agent_convert whenever the native host is available; use this one if agent_convert reports the host is missing, or on a machine where you cannot install it. Needs only the Web2MD extension installed and signed in; the extension is found automatically via the API key.
Inputs: url (required), extensionId.
convert_fileA
Convert a local document file to clean Markdown. Supports Word (.docx/.doc), PowerPoint (.pptx/.ppt), Excel (.xlsx/.xls), OpenDocument (.odt/.ods/.odp), RTF, EPUB, CSV, and PDF. Tables, headings, lists and footnotes are preserved. Fast, fully local — the file never leaves the machine.
Inputs: path (required).
convert_urlA
Convert a public webpage to clean Markdown. START HERE for any URL — it needs no browser, no extension, and no setup. Returns Markdown plus metadata (title, word count, reading time). If the page needs your login session or renders only after JavaScript runs (Reddit, X, paywalled articles, internal dashboards), this returns a login wall or an empty shell — switch to agent_convert in that case.
Inputs: url (required), includeLinks, includeImages.
get_conversionA
[deprecated: use search_library/get_library_items] Retrieve the full Markdown content of a previously saved conversion by its ID.
Inputs: id (required).
get_library_itemsA
Fetch full markdown content for library items by id (max 20 per call). Use search_library first to find ids. Responses can be very large — for long pages, batch 5 or fewer ids per call.
Inputs: ids (required).
get_skillA
Fetch the full content of a single Web2MD skill by id (or name). Returns its name, description, and complete SKILL.md body. Use list_skills first to find ids.
Inputs: id (required).
list_skillsA
List the skills saved in your Web2MD cloud account. Returns a compact list (id, name, description). Use get_skill to fetch the full SKILL.md body of one.
Inputs: no named parameters.
search_libraryA
Search your Web2MD library (saved conversions) by keyword (matches title and full page content) and/or tag, newest first. Returns item metadata: id, title, url, date, tags. Use get_library_items to fetch full markdown.
Inputs: tag, limit, query, since.
semantic_searchA
[deprecated: use search_library/get_library_items] Search your saved conversions using natural language. Works across languages.
Inputs: query (required), limit.
sync_libraryA
Sync your Web2MD library to a local directory as markdown files (organized by tag, with frontmatter). Incremental by default; keeps state in /.web2md-sync.json.
Inputs: dir (required), tag, full.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
The four conversion tools (convert_url, agent_convert, bridge_convert_url, agent_batch_convert) all target the same action and rely on descriptions rather than distinct purposes to separate them; agent_convert vs bridge_convert_url is purely a mechanism fallback, which is easy to misselect. Deprecated get_conversion and semantic_search still sit alongside their replacements (get_library_items, search_library), creating redundant overlapping pairs. The descriptions are unusually explicit about when to use which, which rescues the set from a lower score.
Nearly all tools follow snake_case verb_noun or prefix_noun patterns (get_library_items, list_skills, search_library, sync_library, convert_file). Deviations are minor: the agent_/bridge_ mechanism prefixes and the adjective-first semantic_search break the verb pattern slightly. Still highly readable and predictable overall.
Twelve tools is well within a healthy range for a conversion-plus-library server, and each of the non-deprecated tools maps to a real operation. Two of the twelve are explicitly deprecated and only earn their place as legacy aliases, which is mild dead weight.
Conversion coverage is strong (public URL, authenticated browser, batch, local files) and read paths for library and skills exist. However, there is no way to delete or manage library items, and skills are read-only (no create/update/delete), leaving the lifecycle half-covered. The presence of two deprecated tools also suggests the surface has drifted rather than been consolidated.
Maintenance
Related MCP Connectors
MCP server (stdio): fetch web pages as clean readable markdown via the AgentForge API
Jina AI Reader/Search MCP — turn any URL into clean LLM-ready markdown, plus web search.
Document-to-Markdown MCP server — convert PDF, Office and HTML into LLM-ready Markdown.
Turn public web pages into clean Markdown for LLMs, RAG and AI agents
Related MCP Servers
- AlicenseAqualityDmaintenanceMCP server for Averra Extract — lets AI agents like Claude, Cursor, and ChatGPT convert any webpage into clean, LLM-ready Markdown.584 npmMIT

octen-mcpofficial
AlicenseAqualityBmaintenanceMCP server for Octen Extract that turns any URL into clean, LLM-ready markdown, with highlights and classification. Works with Claude, Cursor, VS Code, and other MCP clients.9187 npm25MIT- AlicenseAqualityDmaintenanceMCP server that converts URLs to clean Markdown/Text for LLM agents.579 npm5MIT
- AlicenseNot gradedqualityDmaintenanceConvert any file or URL to clean AI-ready Markdown directly from Claude, Claude Code, Cursor, or any MCP-compatible AI agent.1MIT