# FATSEARCH

> FATSEARCH is an open-source MCP server for web search and scraping. Turns web pages and PDFs into cached Markdown outlines read one section at a time. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux
- **Website:** https://fatsearch.com
- **Repository:** https://github.com/fatsearch/fatsearch
- **MCP Registry name:** io.github.fatsearch/fats
- **Categories:** web search and scraping
- **Listing updated:** 2026-11-15

## About

FATSEARCH goes after the pages a built-in fetch tool reads badly: JavaScript shells, PDFs and pages behind captchas. It tries plain HTTP first and only climbs to your own paid providers, cheapest first, when that fails, tracking cost on every call. A dry run prints the planned route and an upper cost estimate before anything is spent.

Instead of dumping a whole page, it returns a short outline with section ids. In the README's Wikipedia example the page was 40.9k tokens and the agent used 1,384 tokens in total against 112,517 for a Firecrawl copy. Menus, banners and footers are removed while prices, dates and numbers are kept. Results are stored on disk as Markdown, and filters such as an exact phrase search return matching lines.

There is no hosted account: you bring a provider key, set through a one-time local form on 127.0.0.1 so the key never enters the chat or logs. The README reports 35 of 38 hard pages answered within 60 seconds, against 24 for Firecrawl and 19 for Tavily in its own benchmark, and notes the others are faster on pages they can read.

## Features

- **Section-by-section reading:** Returns an outline with ids so the agent opens only what it needs.
- **Escalating fetch:** Starts with free plain HTTP and moves to your providers when blocked.
- **Keys stay out of chat:** A local one-time form saves the key with file mode 0600.
- **Cost tracking:** `fats stats` shows tokens, time and spend per page.
- **Local Markdown cache:** Pages are kept on disk and searchable by phrase.
- **Single binary:** Ships through cargo, npm and release downloads.

## Good for

- Read a JavaScript-heavy page an agent's fetch cannot
- Extract one section of a long PDF or Wikipedia article
- Cut the token cost of web research
- Check what a fetch will cost before running it

## Install

### Claude Code (Terminal)

```sh
claude mcp add fats -- npx -y fatsearch
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "fats": {
      "command": "npx",
      "args": [
        "-y",
        "fatsearch"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "fats": {
      "command": "npx",
      "args": [
        "-y",
        "fatsearch"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "fats": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "fatsearch"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "fats": {
      "command": "npx",
      "args": [
        "-y",
        "fatsearch"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "fats": {
      "command": "npx",
      "args": [
        "-y",
        "fatsearch"
      ]
    }
  }
}
```

## FAQ

### Does it need an account?

No account with FATSEARCH itself; you provide your own provider key, for example Bright Data or Decodo.

### Does it track me?

The site says there is no personal telemetry.

### How is the key entered safely?

Through a one-time form on 127.0.0.1 behind a random token that expires after 30 minutes.

### Which licence?

The README links an MIT licence file.

### Is FATSEARCH free?

Yes. FATSEARCH is open source, so you can use and self-host it for free.

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

Run this command in your terminal: claude mcp add fats -- npx -y fatsearch

### What are the best alternatives to FATSEARCH?

The closest alternatives to FATSEARCH are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, NeuralVerge and AI-Powered directory.

## 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.
- [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.
- [Chanroll: YouTube Channel Video Scraper (Official API)](https://ai-powered.com/mcp/chanroll-youtube-channel-video-scraper-official-api): Chanroll: YouTube Channel Video Scraper (Official API) is a paid MCP server for design and media.
- [Vidvett: YouTube Video Details Scraper (Official API)](https://ai-powered.com/mcp/vidvett-youtube-video-details-scraper-official-api): Vidvett: YouTube Video Details Scraper (Official API) is a paid MCP server for design and media.

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