# Distill MCP

> Distill MCP is a freemium MCP server for web search and scraping. Fetch web pages as clean Markdown for agents, honouring robots.txt and noai. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://distill.bytestay.pt/integration.html
- **Repository:** https://github.com/bytestay/distill-mcp
- **MCP Registry name:** io.github.Bytestay/distill-mcp
- **Categories:** web search and scraping, files and documents
- **Listing updated:** 2026-11-14

## About

Distill runs on your own machine over stdio via uvx and calls the Distill API with your RapidAPI or api.market key. Output is the page's main content as Markdown with title, author, date and language. Refusals from robots.txt or a noai directive are passed on, and the agent is asked to respect them.

Every tool call counts as one request on your plan, and errors plus the requests remaining are reported back with what to do next. Snippets are given for Claude Code, Claude Desktop, Cursor and VS Code. It is from the same vendor as sibling Shipshape, Specwise and Unfold servers.

## Features

- **URL to Markdown:** Returns main content with metadata.
- **HTML conversion:** Converts HTML you already hold.
- **Opt-out respect:** Passes on robots.txt and noai refusals.
- **Quota reporting:** Reports requests left on the plan.
- **Two marketplaces:** Works with RapidAPI or api.market keys.

## Good for

- Feed pages into a RAG pipeline
- Let an agent read a web article
- Convert saved HTML to Markdown
- Chunk documentation for search

## Install

### Claude Code (Terminal)

```sh
claude mcp add distill-mcp --env RAPIDAPI_KEY='<RAPIDAPI_KEY>' --env API_MARKET_KEY='<API_MARKET_KEY>' -- uvx bytestay-distill-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "distill-mcp": {
      "command": "uvx",
      "args": [
        "bytestay-distill-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
        "API_MARKET_KEY": "<API_MARKET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "distill-mcp": {
      "command": "uvx",
      "args": [
        "bytestay-distill-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
        "API_MARKET_KEY": "<API_MARKET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "distill-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "bytestay-distill-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
        "API_MARKET_KEY": "<API_MARKET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "distill-mcp": {
      "command": "uvx",
      "args": [
        "bytestay-distill-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
        "API_MARKET_KEY": "<API_MARKET_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "distill-mcp": {
      "command": "uvx",
      "args": [
        "bytestay-distill-mcp"
      ],
      "env": {
        "RAPIDAPI_KEY": "<RAPIDAPI_KEY>",
        "API_MARKET_KEY": "<API_MARKET_KEY>"
      }
    }
  }
}
```

## Tools

- `fetch_markdown`: Fetches a page and returns its main content as Markdown with title, author, date and language.
- `html_to_markdown`: Converts HTML you already have to Markdown without fetching.

## FAQ

### Which keys work?

A RapidAPI key or an api.market key.

### Does it respect opt-outs?

It passes on robots.txt and noai refusals.

### How does it run?

Locally with uvx over stdio.

### What counts against my plan?

Each tool call is one request.

### Is Distill MCP free?

Distill MCP has a free plan, with paid plans for more usage or features.

### How do I add Distill MCP to Claude Code?

Run this command in your terminal: claude mcp add distill-mcp --env RAPIDAPI_KEY='<RAPIDAPI_KEY>' --env API_MARKET_KEY='<API_MARKET_KEY>' -- uvx bytestay-distill-mcp

### What are the best alternatives to Distill MCP?

The closest alternatives to Distill MCP 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/distill-mcp
