# Svipall MCP server

> Lets an AI client fetch, crawl and search web pages locally, converting them to Markdown and reporting anti-bot walls.

- Repository: https://github.com/ilien-dev/svipall
- Page: https://hostedmcp.org/servers/ilien-dev/svipall
- Transport: stdio
- Stars: 21
- License: AGPL-3.0
- Latest version: 2.1.0

## Install

### Claude Code

```sh
claude mcp add svipall -- npx -y svipall
```

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

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

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

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

### VS Code CLI

```sh
code --add-mcp '{"name":"svipall","type":"stdio","command":"npx","args":["-y","svipall"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

```sh
codex mcp add svipall -- npx -y svipall
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.svipall]
command = "npx"
args = ["-y", "svipall"]
```

### Gemini CLI

```sh
gemini mcp add -s user svipall npx -- -y svipall
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Tools (21)

- `web_fetch`
- `web_fetch_many`
- `web_search`
- `web_site_search`
- `web_crawl`
- `web_map`
- `web_snapshot`
- `web_act`
- `web_capture`
- `web_video`
- `web_screenshot`
- `web_diff`
- `web_watch`
- `web_notes`
- `web_log`
- `web_login`
- `web_route`
- `web_profile`
- `web_status`
- `browser_setup`
- `solve_and_continue`

## FAQ

### Does Svipall need an API key or account?

No. It runs locally with no third-party API keys, paid captcha services or telemetry, and there is no account to create.

### Can Svipall crawl a docs site and output llms.txt?

Yes, web_crawl supports llms.txt output along with near-duplicate labels, a resumable frontier and saturation stopping.

### How does Svipall handle captchas?

It attempts supported challenges locally across fifteen widget families and eleven answer modalities, with a human dashboard for unresolved ones.

### Can it search the web without an API key?

Yes, it searches without an API key and can query all engines at once from the CLI.

### Does Svipall tell me when a page was blocked by an anti-bot wall?

Yes, detected blocks return fields like wall_kind, wall_vendor and wall_evidence with a note telling the agent what to do next.
