# Proxlane

> Proxlane is an open-source MCP server for web search and scraping. Web-fetch tool that returns block pages as failures, via your own Proxlane gateway. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://proxlane.dev/docs/agents
- **Repository:** https://github.com/proxlane/proxlane/tree/HEAD/packages/sdk
- **MCP Registry name:** io.github.proxlane/proxlane
- **Categories:** web search and scraping
- **Listing updated:** 2026-11-14

## About

The problem it targets is a scraper returning a 200 with a captcha in the body, which an agent then summarises as if it were the page. This server exposes a single fetch_page tool that goes through a Proxlane gateway you run yourself. The gateway fails over between scraping providers and checks each response for block pages, so the agent gets readable text or an error that says what happened.

Failures carry an outcome, one of six classes that the docs say will never grow, and a retryable flag. A page the site itself refused or lacks is not worth retrying, while a block or provider problem may be later. Options include JavaScript rendering, waiting for a CSS selector, a country code, text or HTML output and a character cap of 20,000 by default.

You need a running gateway with at least one scraping-provider key, and the README warns that every call spends provider credits, several times more with rendering. The tool is deliberately not marked read-only so clients still ask before running it. The README advises pinning the package version.

## Features

- **Honest failures:** Block pages come back as errors with an outcome, never as content.
- **Retry guidance:** Each failure says whether retrying is worthwhile.
- **Provider failover:** The gateway tries several scraping providers before giving up.
- **Rendering options:** Optional JavaScript rendering and wait-for-selector.
- **Country targeting:** A two-letter country code can be set per request.
- **Output control:** Text or HTML, truncated at a configurable length and marked as such.

## Good for

- Give a coding agent web access that does not summarise captcha pages
- Tell blocked pages apart from missing ones in an agent loop
- Fetch JavaScript-rendered pages through a scraping provider
- Fetch a page as seen from a given country

## Install

### Claude Code (Terminal)

```sh
claude mcp add proxlane --env PROXLANE_API_KEY='<PROXLANE_API_KEY>' -- npx -y @proxlane/sdk
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "proxlane": {
      "command": "npx",
      "args": [
        "-y",
        "@proxlane/sdk"
      ],
      "env": {
        "PROXLANE_API_KEY": "<PROXLANE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "proxlane": {
      "command": "npx",
      "args": [
        "-y",
        "@proxlane/sdk"
      ],
      "env": {
        "PROXLANE_API_KEY": "<PROXLANE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "proxlane": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@proxlane/sdk"
      ],
      "env": {
        "PROXLANE_API_KEY": "<PROXLANE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "proxlane": {
      "command": "npx",
      "args": [
        "-y",
        "@proxlane/sdk"
      ],
      "env": {
        "PROXLANE_API_KEY": "<PROXLANE_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "proxlane": {
      "command": "npx",
      "args": [
        "-y",
        "@proxlane/sdk"
      ],
      "env": {
        "PROXLANE_API_KEY": "<PROXLANE_API_KEY>"
      }
    }
  }
}
```

## Tools

- `fetch_page`: Fetch a URL through the gateway as text or HTML, or return a classified failure

## FAQ

### What do I need to run it?

A Proxlane gateway with at least one provider key, plus the gateway's own PROXLANE_API_KEY and PROXLANE_URL.

### Does it cost anything per call?

Yes. Every call spends provider credits, several times more with render or wait_for.

### What licence is the SDK?

Apache-2.0.

### Why pin the version?

npx -y otherwise runs whatever was published last, with the key in its environment.

### Is Proxlane free?

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

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

Run this command in your terminal: claude mcp add proxlane --env PROXLANE_API_KEY='<PROXLANE_API_KEY>' -- npx -y @proxlane/sdk

### What are the best alternatives to Proxlane?

The closest alternatives to Proxlane 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/proxlane
