web2md

Web2MD MCP Server

Convert any URL to clean Markdown — directly from your AI agent.

An MCP (Model Context Protocol) server that converts public webpages to clean, readable Markdown. Strips ads, navigation, and boilerplate — returns LLM-ready text perfect for RAG, research, and content extraction.

Works with Claude Desktop, Cursor, Continue.dev, Windsurf, and any MCP-compatible client.

Quick Start — Remote (no install, 30 seconds)

The fastest way to try it: add the hosted remote server to any MCP client. No code, no install.

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "web2md": {
      "type": "http",
      "url": "https://domains-directed-lesson-bear.trycloudflare.com/mcp"
    }
  }
}

Cursor — Settings → MCP → Add new MCP server → type http, URL above.

Claude Code — claude mcp add web2md --transport http https://domains-directed-lesson-bear.trycloudflare.com/mcp

The remote URL is also published on the official MCP registry as io.github.astra-intelligence/web2md, so it stays discoverable even if this tunnel rotates.

Quick Start — Local (from source)

git clone https://github.com/astra-intelligence/web2md-mcp.git
cd web2md-mcp
pip install .
# or: uv sync

Then add to your client config:

{
  "mcpServers": {
    "web2md": {
      "command": "uvx",
      "args": ["web2md-mcp"]
    }
  }
}

⏳ PyPI publication pending. Until then, use the source install above.

Usage

The server provides one tool: web2md_convert

Parameter	Type	Description
url	string	The public URL to convert to Markdown

Example

{
  "url": "https://example.com/article"
}

Returns clean Markdown content ready for LLM consumption.

Requirements

• Python 3.10+
• Internet access to reach the Web2MD API at 167.233.135.161:9999

About Web2MD

Web2MD is a URL-to-Markdown conversion API running at 167.233.135.161:9999. This MCP server wraps the API so AI agents can use it directly.

Free tier: 10 conversions/day per IP — no signup, no API key.

👉 Get unlimited access on Gumroad: https://grantshatz.gumroad.com/l/mpkqyq ($1+)

Direct API Usage

You can also use the API directly without the MCP server:

curl "http://167.233.135.161:9999/api/convert?url=https://example.com/"

Free tier: 10/day/IP. Add ?license_key=YOUR_KEY for unlimited access.

License

MIT

---

Support

If you find this project useful, consider buying me a coffee or sponsoring on GitHub.

Check out more tools at grantshatz.gumroad.com.

---

Generate a free GitHub profile stats card (stars, languages, followers) for your README: GitHub Stats Card