# Oxylabs MCP

> Oxylabs MCP is an MCP server for web search and scraping. Oxylabs MCP server for scraping, Google and Amazon search and AI-driven crawling. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Starting price:** $15 a month
- **Platforms:** API, CLI
- **Website:** https://oxylabs.io
- **Repository:** https://github.com/oxylabs/oxylabs-mcp
- **MCP Registry name:** io.oxylabs/oxylabs-mcp
- **Categories:** web search and scraping
- **Listing updated:** 2026-11-14

## About

Two sets of tools sit behind one server. The Web Scraper API set covers `universal_scraper` for any URL with optional JavaScript rendering, geo-targeting and Markdown, HTML or link output, plus scrapers for Google Search results and for Amazon search and product pages, with optional parsing to JSON. The AI Studio set adds AI extraction to JSON, CSV, Markdown or TOON, a prompt-driven crawler, a browser agent that clicks and fills forms, web search, site URL mapping and a schema generator.

You can use Oxylabs' hosted endpoint at `mcp.oxylabs.io/mcp`, passing credentials as headers, or run the PyPI package locally with `uv`. You need either a Web Scraper API account, which has a 1-week free trial, or an AI Studio key with 1,000 free credits. The README says the server handles CAPTCHA and reaches geo-restricted data from 195+ countries, and points Web API users to a separate Web API MCP repository, while saying this one is still fully supported.

## Features

- **Universal scraping:** Fetch any URL with optional JavaScript rendering and geo-targeting.
- **Search engine scrapers:** Structured results from Google Search and Amazon.
- **AI extraction:** Pull page content as JSON, CSV, Markdown or TOON.
- **Prompt-driven crawler:** Collect data across pages from a starting URL.
- **Browser agent:** Navigates, clicks and fills forms from a prompt.
- **Hosted or local:** Use the hosted endpoint or run the PyPI package.

## Good for

- Pull product data from Amazon pages into a report
- Scrape a JavaScript-heavy page as Markdown for an agent
- Map a website's URLs before crawling
- Check Google results from a specific country

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http oxylabs-mcp https://mcp.oxylabs.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.oxylabs.io/mcp
```

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

```json
{
  "mcpServers": {
    "oxylabs-mcp": {
      "url": "https://mcp.oxylabs.io/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "oxylabs-mcp": {
      "type": "http",
      "url": "https://mcp.oxylabs.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "oxylabs-mcp": {
      "serverUrl": "https://mcp.oxylabs.io/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "oxylabs-mcp": {
      "type": "http",
      "url": "https://mcp.oxylabs.io/mcp"
    }
  }
}
```

## Tools

- `universal_scraper`: Scrape any URL with optional JavaScript rendering and geo-targeting.
- `google_search_scraper`: Extract Google Search results, optionally parsed to JSON.
- `amazon_search_scraper`: Scrape Amazon search result pages.
- `amazon_product_scraper`: Extract data from Amazon product pages.
- `ai_scraper`: AI-powered extraction in JSON, CSV, Markdown or TOON.
- `ai_crawler`: Crawl a site from a starting URL based on a prompt.
- `ai_browser_agent`: Control a real browser from a prompt.
- `ai_search`: Search the web, optionally returning Markdown of each result.
- `ai_map`: Map a website's URLs filtered by keywords or a prompt.
- `generate_schema`: Generate a JSON schema for structured extraction.

## FAQ

### What accounts do I need?

An Oxylabs Web Scraper API account, which has a 1-week free trial, or an AI Studio API key with 1,000 free credits.

### Can I run it without installing anything?

Yes, through the hosted server at https://mcp.oxylabs.io/mcp with credentials in headers.

### How do I run it locally?

Install the oxylabs-mcp package with uv and set your credentials in environment variables.

### Which countries can it target?

The README says 195+ countries.

### Is Oxylabs MCP free?

Oxylabs MCP is a paid product with a free trial. Paid plans start at $15 a month.

### How do I add Oxylabs MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http oxylabs-mcp https://mcp.oxylabs.io/mcp

### What are the best alternatives to Oxylabs MCP?

The closest alternatives to Oxylabs MCP 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/oxylabs-mcp
