# well-002-url-to-markdown

> well-002-url-to-markdown is a paid MCP server for files and documents. Pay-per-call converter from a public https page to markdown, $0.005 in USDC. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Hand this service an https URL and it fetches the page and returns markdown, along with the final URL after redirects, the page title when found, the content type and a list of warnings. It is meant as a cheap fetch-and-clean step for agents that need readable text rather than raw HTML.

The fetcher is deliberately restrictive: only https is accepted, and http, file, data, localhost and private IP addresses are rejected. Responses are capped at 1 MB, about 10 seconds and 5 redirects.

Billing uses the x402 protocol. An unpaid request gets an HTTP 402 with payment requirements for $0.005 in USDC on Base; retry with a payment signature and the charge settles only if the conversion succeeds. It runs on Cloudflare Workers, stores nothing, and is offered as is with no warranty.

## Features

- **Page to markdown:** Returns the fetched page as markdown plus title, content type and warnings.
- **Redirect tracking:** Reports both the requested URL and the final URL after redirects.
- **Safe fetching:** Rejects http, file, data, localhost and private-IP addresses.
- **Size and time caps:** Limits responses to 1 MB, roughly 10 seconds and 5 redirects.
- **x402 billing:** Charges $0.005 USDC on Base only when the call succeeds.

## Good for

- Give an agent clean markdown of a web page for summarising
- Feed documentation pages into an LLM context without HTML noise
- Pay per fetch from an agent wallet without an account

## Install

### Claude Code (Terminal)

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

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

```sh
https://well-002-url-to-markdown.rainmaker-wells.workers.dev/mcp
```

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

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

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

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

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

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

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

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

## Tools

- `url-to-markdown`: Convert a public https page to markdown

## FAQ

### What does a conversion cost?

$0.005 in USDC on Base via x402.

### Which URLs are allowed?

Public https URLs only; local and private addresses are refused.

### Is a failed call charged?

No, payment settles only when the tool succeeds.

### Does it keep the pages?

The service says nothing is stored.

### Is well-002-url-to-markdown free?

No. well-002-url-to-markdown is a paid product.

### How do I add well-002-url-to-markdown to Claude Code?

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

### What are the best alternatives to well-002-url-to-markdown?

The closest alternatives to well-002-url-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-002-url-to-markdown-2
