Back to Directory/Documentation

Web2MD MCP Server

Convert any public URL to clean, readable Markdown for AI agents. Strips ads, navigation, and boi...

DocumentationPythonv0.1.0

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

From source (GitHub)

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

Using pip (once published)

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

pip install web2md-mcp

Using uvx (once published)

Add to your Claude Desktop config (claude_desktop_config.json):

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

Usage

The server provides one tool: web2md_convert

ParameterTypeDescription
urlstringThe 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.

Setup from the maintainer

This listing does not have a supported local package template. Use the maintainer’s documentation for its hosted endpoint, authentication, and client-specific setup. No install command has been inferred.

Package

https://github.com/astra-intelligence/web2md-mcp/releases/download/v0.1.0/web2md-mcp.tar.gzother

Compatible MCP Clients

Web2MD MCP Server works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More