# Web2MD

> Web2MD is a freemium MCP server for web search and scraping. Turn web pages into clean Markdown or token-sized RAG chunks via the Web2MD API. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** CLI, API
- **Website:** https://rapidapi.com/kanavsingla28/api/web2md-webpage-to-markdown-rag-chunks
- **Repository:** https://github.com/kanavsingla28/web2md-mcp
- **MCP Registry name:** io.github.kanavsingla28/web2md-mcp
- **Categories:** web search and scraping, AI models and LLM tooling
- **Listing updated:** 2026-11-15

## About

Web2MD's server wraps a RapidAPI service, so you need a RapidAPI key before it works. It runs locally over stdio from the npm package web2md-rag-mcp and requires Node.js 22 or newer.

The main difference from a plain fetcher is the chunk tool, which splits a page at headings, records each chunk's heading path and keeps it within a token budget you set (64 to 8192, default 512) with optional overlap. Other tools return a page as Markdown, plain text or JSON, convert HTML you already hold, and fetch only metadata.

The backing API respects robots.txt and per-site limits and refuses private network addresses. It handles HTML up to 5 MB and cannot render JavaScript-only pages, which return a no_content error.

## Features

- **Clean page reading:** Main content as Markdown or text without menus and ads.
- **Heading-aware chunks:** RAG chunks with heading path and token count.
- **HTML conversion:** Convert HTML you supply without fetching.
- **Metadata lookup:** Title, author, date, language and reading time.
- **Safe fetching:** Respects robots.txt and blocks private network targets.
- **Typed errors:** Codes such as robots_disallowed and no_content explain failures.

## Good for

- Prepare web pages for embedding in a RAG index
- Give an assistant a clean copy of an article
- Extract metadata for many URLs
- Convert saved HTML to Markdown

## Install

### Claude Code (Terminal)

```sh
claude mcp add web2md-mcp --env RAPIDAPI_KEY='<RAPIDAPI_KEY>' -- npx -y web2md-rag-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "web2md-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "web2md-rag-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "web2md-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "web2md-rag-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "web2md-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "web2md-rag-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "web2md-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "web2md-rag-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "web2md-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "web2md-rag-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>"
      }
    }
  }
}
```

## Tools

- `read_url`: Fetch a page as clean Markdown or text.
- `chunk_url`: Split a page into heading-aware RAG chunks.
- `convert_html`: Convert raw HTML to Markdown or text.
- `page_metadata`: Get a page's metadata.

## FAQ

### What do I need to run it?

Node.js 22 or newer and a RapidAPI key subscribed to Web2MD.

### Is there a free plan?

Yes. BASIC is $0 for 500 requests a month; PRO is $9, ULTRA $29 and MEGA $79.

### Does it work on JavaScript-only pages?

Not yet. Those return no_content; rendering support is planned.

### What is the size limit?

Pages up to 5 MB.

### Is Web2MD free?

Web2MD has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

### How do I add Web2MD to Claude Code?

Run this command in your terminal: claude mcp add web2md-mcp --env RAPIDAPI_KEY='<RAPIDAPI_KEY>' -- npx -y web2md-rag-mcp

### What are the best alternatives to Web2MD?

The closest alternatives to Web2MD are Scrapling MCP Server, Firecrawl MCP Server, Claude Code Ultimate Guide, SearXNG Search and NeuralVerge.

## Alternatives

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [signafAIde](https://ai-powered.com/mcp/signafaide): signafAIde is a freemium MCP server for security.

---
Source: https://ai-powered.com/mcp/web2md
