Back to the catalog

io.github.zcag/readdown-mcp

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

Open source Open in the app JSON README (API)

About

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

Details

Kind
MCP servers
Topic
AI, RAG & memory
Publisher
zcag
Origin
official
Category
ferramentas
Transport
local
Version
1.0.0
Last push
2026-03-12T21:58:16Z
Repository state
ativo
Language
JavaScript
License
MIT
Added
2026-08-29 04:01:43
Updated
2026-08-29 04:01:43
Origin id
io.github.zcag/readdown-mcp

README

# readdown-mcp

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

Lightweight — uses HTTP fetch, no browser needed. Powered by [readdown](https://github.com/zcag/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`:

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

### Cursor

Add to `.cursor/mcp.json`:

```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

More