# well-004-html-to-markdown

> well-004-html-to-markdown is a paid MCP server for files and documents. Convert an HTML string or public URL to tidy markdown for $0.005 per call. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API
- **Website:** https://well-004-html-to-markdown.rainmaker-wells.workers.dev/openapi.json
- **MCP Registry name:** dev.workers.rainmaker-wells.well-004-html-to-markdown/html-to-markdown
- **Categories:** files and documents, web search and scraping
- **Listing updated:** 2026-11-16

## About

This is one of the Rainmaker pay-per-call services, built for agents that need page content as markdown. You send an HTML string, a public https URL, or both; if both are given it uses the HTML and adds a warning. The response is JSON with the source, the final URL and content type when a URL was fetched, the markdown and any warnings.

URL fetching is deliberately restrictive. Only https is accepted, and http, file, data, localhost and private IP addresses are rejected. Bodies are capped at 1 MB, requests time out after about ten seconds and at most five redirects are followed.

Each call costs $0.005 in USDC on Base through the x402 protocol: unpaid requests get an HTTP 402, and payment settles only when the tool succeeds. The operator states it is provided as is with no warranty, and that nothing is stored.

## Features

- **HTML to markdown:** Converts supplied HTML into tidy markdown.
- **URL fetching:** Fetches a public https page and converts it.
- **Safe fetch limits:** Rejects non-https and private addresses; 1 MB cap.
- **Pay per call:** $0.005 USDC via x402 on Base.
- **Warnings:** Returns notes such as when both inputs are given.

## Good for

- Convert a web page to markdown for an LLM
- Clean HTML snippets into notes
- Feed documentation into an agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http html-to-markdown https://well-004-html-to-markdown.rainmaker-wells.workers.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://well-004-html-to-markdown.rainmaker-wells.workers.dev/mcp
```

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

```json
{
  "mcpServers": {
    "html-to-markdown": {
      "url": "https://well-004-html-to-markdown.rainmaker-wells.workers.dev/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "html-to-markdown": {
      "type": "http",
      "url": "https://well-004-html-to-markdown.rainmaker-wells.workers.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "html-to-markdown": {
      "serverUrl": "https://well-004-html-to-markdown.rainmaker-wells.workers.dev/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "html-to-markdown": {
      "type": "http",
      "url": "https://well-004-html-to-markdown.rainmaker-wells.workers.dev/mcp"
    }
  }
}
```

## Tools

- `html-to-markdown`: Converts HTML or a public URL to markdown

## FAQ

### What does it cost?

$0.005 USDC per successful call, paid through x402 on Base.

### Which URLs can it fetch?

Public https URLs only.

### What are the size limits?

1 MB body, about 10 seconds and 5 redirects.

### Is data stored?

The operator says nothing is stored.

### Is well-004-html-to-markdown free?

No. well-004-html-to-markdown is a paid product.

### How do I add well-004-html-to-markdown to Claude Code?

Run this command in your terminal: claude mcp add --transport http html-to-markdown https://well-004-html-to-markdown.rainmaker-wells.workers.dev/mcp

### What are the best alternatives to well-004-html-to-markdown?

The closest alternatives to well-004-html-to-markdown are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, NeuralVerge and ASTra.

## 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.
- [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.
- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/well-004-html-to-markdown-2
