# Wet

> Wet is an open-source MCP server for web search and scraping. Self-hosted MCP server for web search, page extraction and library docs. It runs as a hosted remote server, so there is nothing to install locally.

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

## About

Wet runs as a local HTTP service rather than a subprocess your client spawns. You start it with `wet server start`, then point Claude Code, Codex, Gemini CLI, Cursor or Windsurf at http://127.0.0.1:8000/mcp; a Docker compose stack with token auth is offered for always-on setups.

Search goes through a fallback chain of backends (Tavily and DuckDuckGo by default, with Brave, Exa, Kagi, OpenRouter, Firecrawl and Startpage selectable) and results are cached for an hour, or five minutes for time-sensitive queries. A separate academic mode covers Google Scholar, Semantic Scholar, arXiv, PubMed, CrossRef and BASE.

Page extraction escalates from plain HTTP through TLS spoofing to browser rendering and an optional captcha step, and returns chunked text, markdown, JSON-LD and code blocks. It can batch up to 50 URLs, crawl sites and convert local PDF, DOCX, XLSX, CSV, HTML, EPUB and PPTX files to markdown. Embedding and reranking run locally by default, and an OpenRouter key switches them to cloud models.

## Features

- **Multi-backend web search:** Falls back across several search providers with query expansion and a short-lived cache.
- **Academic paper search:** Queries Google Scholar, Semantic Scholar, arXiv, PubMed, CrossRef and BASE.
- **Library docs index:** Discovers and indexes documentation with hybrid full-text search and version-specific lookups.
- **Escalating page extraction:** Moves from plain HTTP to browser rendering until a page can be read, with batch and crawl modes.
- **Local file conversion:** Turns PDF, DOCX, XLSX, CSV, HTML, EPUB and PPTX files into markdown.
- **Local models by default:** Embeds and reranks without API keys; OpenRouter is optional.

## Good for

- Give a coding agent version-aware library documentation
- Collect and cite sources for a research question across web and academic indexes
- Extract clean text and structured data from a batch of URLs
- Convert a folder of office documents to markdown before analysis

## Install

### Claude Code (Terminal)

```sh
claude mcp add wet --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- uvx n24q02m-wet
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "wet": {
      "command": "uvx",
      "args": [
        "n24q02m-wet"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "wet": {
      "command": "uvx",
      "args": [
        "n24q02m-wet"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "wet": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "n24q02m-wet"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "wet": {
      "command": "uvx",
      "args": [
        "n24q02m-wet"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "wet": {
      "command": "uvx",
      "args": [
        "n24q02m-wet"
      ],
      "env": {
        "OPENROUTER_API_KEY": "<OPENROUTER_API_KEY>",
        "GITHUB_TOKEN": "<GITHUB_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Does Wet run over stdio?

No. The README says it is HTTP-only: you start a local instance first and register its streamable-HTTP URL with your client.

### Which package do I install?

The PyPI distribution is n24q02m-wet; `uvx --python 3.13 --from n24q02m-wet wet server start` starts it.

### Do I need API keys?

Not for the defaults. Tavily, GitHub and OpenRouter keys are optional and raise quality or rate limits.

### What happened to image analysis?

The media analyze action was removed in v2.0.0; the README points to the separate imagine-mcp project for vision and audio.

### Is Wet free?

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

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

Run this command in your terminal: claude mcp add wet --env OPENROUTER_API_KEY='<OPENROUTER_API_KEY>' --env GITHUB_TOKEN='<GITHUB_TOKEN>' -- uvx n24q02m-wet

### What are the best alternatives to Wet?

The closest alternatives to Wet 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/wet
