# Ratatoskr

> Ratatoskr is an open-source MCP server for web search and scraping. Keyless meta-search and page fetching for agents, in a single Rust binary. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows, self-hosted, API
- **Repository:** https://github.com/haszerobyte/ratatoskr
- **MCP Registry name:** io.github.haszerobyte/ratatoskr
- **Categories:** [web search and scraping](https://ai-powered.com/categories/web-search-and-scraping)
- **Listing updated:** 2026-11-18

## About

Ratatoskr, named for the squirrel in Norse myth who runs messages along the world tree, avoids the usual search API key. It merges Yahoo, DuckDuckGo, Bing and Yandex plus the best Wikipedia and Grokipedia page, ranking by how many engines agree and how well results match. Each engine has its own pace, health record and circuit breaker, so one refusing does not stop a search. Brave and Google APIs or your own search server are optional fallbacks.

web_search handles five result types (web, news, images, videos, books) with country, time window, safe search and paging; web_fetch turns a page or PDF into text with headings, tables and links kept as Markdown links. Fetching refuses private, loopback and link-local addresses at connect time and on every redirect.

The same engine also comes as a command line tool, a local HTTP API on 127.0.0.1:8765 and a Rust library (crate ratatoskr-web). The README gives a roughly 10 MB binary using about 6 MB at idle as an MCP server, installable via cargo binstall, prebuilt releases or a container image.

## Features

- **No API key:** Search works out of the box by merging several engines.
- **Five search types:** Web, news, images, videos and books with typed results.
- **Engine resilience:** Per-engine circuit breakers keep one failure from blocking results.
- **Readable fetch:** HTML and PDF become text with headings, tables and links.
- **Safe fetching:** Private and local network addresses are refused, including on redirects.
- **Multiple interfaces:** MCP server, CLI, local HTTP API and Rust library.

## Good for

- Give a coding agent web search without managing a key
- Search recent news with a one-week limit
- Read a documentation page as clean Markdown
- Run searches from a script through the local HTTP API
- Embed meta-search in a Rust program

## Install

### Claude Code (Terminal)

```sh
claude mcp add ratatoskr -- docker run -i --rm ghcr.io/haszerobyte/ratatoskr:0.4.0
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "ratatoskr": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/haszerobyte/ratatoskr:0.4.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ratatoskr": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/haszerobyte/ratatoskr:0.4.0"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "ratatoskr": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/haszerobyte/ratatoskr:0.4.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ratatoskr": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/haszerobyte/ratatoskr:0.4.0"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "ratatoskr": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/haszerobyte/ratatoskr:0.4.0"
      ]
    }
  }
}
```

## Tools

- `web_search`: Search web, news, images, videos or books across merged engines.
- `web_fetch`: Read a page or PDF as text with links kept.

## FAQ

### Do I need an API key?

No; Brave and Google keys are optional fallbacks.

### Which engines are used?

Yahoo, DuckDuckGo, Bing and Yandex, plus Wikipedia and Grokipedia pages.

### Can it reach my local network?

No; web_fetch refuses private, loopback and link-local addresses.

### How is it installed?

With cargo binstall ratatoskr-web, a prebuilt release, cargo install, or the ghcr.io container.

### Is Ratatoskr free?

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

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

Run this command in your terminal: claude mcp add ratatoskr -- docker run -i --rm ghcr.io/haszerobyte/ratatoskr:0.4.0

### What are the best alternatives to Ratatoskr?

The closest alternatives to Ratatoskr are Scrapling MCP Server, Firecrawl MCP Server, Douyin_TikTok_Download_API, SearXNG Search and machine_internet.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## 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.
- [Douyin_TikTok_Download_API](https://ai-powered.com/mcp/douyin-tiktok-download-api): Douyin_TikTok_Download_API is an open-source 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.
- [machine_internet](https://ai-powered.com/mcp/machine-internet): machine_internet is an open-source MCP server for web search and scraping.
- [acrawl](https://ai-powered.com/mcp/acrawl): acrawl is an open-source MCP server for browser automation.
- [Countries](https://ai-powered.com/mcp/countries): Countries is a freemium MCP server for web search and scraping.
- [Listen Notes](https://ai-powered.com/mcp/listen-notes): Listen Notes is a freemium MCP server for knowledge and memory.

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