Web2md MCP Server

Web2MD MCP server

An MCP server that turns any web page into clean Markdown, plain text or token-bounded RAG chunks, using the Web2MD API on RapidAPI.

What it does

• read_url: fetch a web page and return its main content as Markdown or plain text, without nav, ads or boilerplate.
• chunk_url: fetch a web page and split it into heading-aware chunks sized in tokens, for RAG and embeddings.
• convert_html: convert raw HTML you already have into Markdown or plain text.
• page_metadata: get a page's title, author, published date, description and similar fields without the full content.

Setup in 3 steps

1. Subscribe to Web2MD on RapidAPI. The BASIC plan is free and includes 500 requests per month.
2. Copy your X-RapidAPI-Key from the Endpoints tab of the listing.
3. Add the server to your client.

Requires Node.js 22 or newer.

Claude Code:

claude mcp add web2md -e RAPIDAPI_KEY=your-key -- npx -y web2md-rag-mcp

Claude Desktop (claude_desktop_config.json) and Cursor (~/.cursor/mcp.json) use the same JSON:

{
  "mcpServers": {
    "web2md": {
      "command": "npx",
      "args": ["-y", "web2md-rag-mcp"],
      "env": { "RAPIDAPI_KEY": "your-key" }
    }
  }
}

Windsurf: put the same block in ~/.codeium/windsurf/mcp_config.json.

Tools

Limits and plans

• RapidAPI rate limit: 1,000 requests per hour.
• Pages up to 5 MB.
• robots.txt is respected.
• JavaScript-heavy pages may return no_content. Rendering support is planned.

Errors

Tool errors look like Web2MD error [code]: message. Input-validation failures (a bad URL, out-of-range numbers) come from the MCP SDK as MCP error -32602: Input validation error ... instead.

Privacy

Your key is sent only to the RapidAPI gateway (web2md-webpage-to-markdown-rag-chunks.p.rapidapi.com) and is never logged.

Development

npm ci
npm test
npm run lint
npm run build
RAPIDAPI_KEY=your-key npm run smoke

Licence

MIT