English Français العربية

io.github.zcag/readdown-mcp

Official registry Search and web

Convert web pages to clean, LLM-optimized Markdown. No browser needed.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

OCI package ghcr.io/zcag/readdown-mcp:1.0.0
Claude Code 
claude mcp add readdown-mcp -- docker run -i --rm ghcr.io/zcag/readdown-mcp:1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "readdown-mcp": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/zcag/readdown-mcp:1.0.0"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. readdown-mcp
  2. Tools
  3. Install
  4. Why readdown?
  5. License

readdown-mcp

MCP server for converting web pages to clean, LLM-optimized Markdown.

Lightweight — uses HTTP fetch, no browser needed. Powered by readdown.

Tools

fetch_markdown

Fetch a URL and convert it to clean Markdown with metadata and token count.

convert_html

Convert an HTML string to Markdown. Use when you already have the HTML.

Install

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "readdown": {
      "command": "npx",
      "args": ["-y", "github:zcag/readdown-mcp"]
    }
  }
}
Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "readdown": {
      "command": "npx",
      "args": ["-y", "github:zcag/readdown-mcp"]
    }
  }
}

Why readdown?

Most web-fetching MCP servers use @mozilla/readability + turndown (two packages, 65KB). readdown replaces both in a single 5KB package with better LLM optimization:

  • Token-efficient output (fewer tokens = cheaper API calls)
  • Built-in token estimation
  • Metadata extraction (title, author, date)
  • Works server-side with linkedom (no browser DOM needed)

License

MIT

Frequently asked questions

What is io.github.zcag/readdown-mcp?

Convert web pages to clean, LLM-optimized Markdown. No browser needed.

How do I install io.github.zcag/readdown-mcp?

It runs on your machine. In Claude Code: claude mcp add readdown-mcp -- docker run -i --rm ghcr.io/zcag/readdown-mcp:1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.zcag/readdown-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.zcag/readdown-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.zcag/readdown-mcp?

It is published by zcag. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.